Documento de Aprovação

PetLove V1 — Primeira Entrega

GOLIVE 30/03

05/03/2026 EPIC Digital Versão 1.0

Sobre as versões do projeto

Desde o início do projeto, organizamos as entregas em pacotes numerados (versoes). Essa estrutura foi definida na fase de discovery e garante que cada fase tenha um objetivo claro, um escopo fechado e um prazo realista.

Primeira Entrega

Operação no HubSpot + saida do RD Station

Expansão

Migração do Blog, melhorias B2B, novas automações

Otimização

Analytics avançado, inteligência de dados, escala

Temos um contrato anual de evolução que prevê 3 ou mais versões (pacotes). Este documento detalha a V1 — a primeira entrega do projeto.

O que define a V1

O projeto PetLove tem 9 iniciativas e 66 user stories classificadas (28 Must, 15 Should, 19 Could). A V1 concentra todos os itens Must — tudo que é necessário para a PetLove operar no HubSpot sem perder nenhum lead, nenhuma venda e nenhum dado. Os itens Should e Could estao mapeados para as próximas versões.

Princípio

A V1 responde a uma pergunta: "O que precisa funcionar no HubSpot para a PetLove operar sem o RD Station?"

Itens que não sao necessários para essa transição estão planejados para a V2.

Itens na V1

Iniciativas

Dependências PetLove

Fonte: Planilha de User Stories (atualizada 05/03)

V1 — O que entra (MUST)

Integrações — Substituir o que o RD faz hoje

5 itens

B2C-01/02

Zenvia → HubSpot (inteiro)

Quando cliente manda WhatsApp, contato e negócio são criados no HubSpot com vendedor correto atribuido. Histórico da conversa aparece na timeline do contato.
Modelo de integração: Zenvia envia dados via Forms API do HubSpot (sem middleware, sem servidor). Contato criado/atualizado automaticamente. Detalhes na Seção 5.
Regras de ownership: janela 24h, carteira 15 dias, 1 negocio por vez. Mapeamento userId Zenvia → email → ownerId HubSpot.

MUST
B2C-07

Formulário do site → HubSpot (primeiro formulário)

Wizard de contratação B2C: lead escolhe espécie, raça, plano e preenche dados pessoais. Site envia POST para o HubSpot via Forms API. Sistema cria contato + Pet (Custom Object) + Deal com produto e preço.
Já na V1: a primeira conversão do formulário já vira Deal (assim como funciona no RD hoje). Dados complementares do pet (para retenção) ficam para V2 — time de vendas não usa.

MUST
B2C-03

Evento de Purchase (compra confirmada)

Quando pagamento e aprovado, Deal move para "Ganho" automaticamente com valor final atualizado.
Mecanismo: PetLove envia evento via webhook direto para o HubSpot. Workflow atualiza o Deal automaticamente.

MUST
B2C-04

Link de pagamento + preço dinamico (Interface do Vendedor)

CRM Card dentro do HubSpot onde o vendedor seleciona região, plano e cupom. Sistema consulta a Health API em tempo real e retorna preço exato. Vendedor cria o Pet, gera a transação e o MRR — tudo sem sair do HubSpot.
Status: Interface já construida pelo Isaac. Call de aprovação com PetLove segunda 10h30.
V1 inclui: região, plano, desconto, MRR, criação de Pet + Deal + associações. Add-ons e penduricalhos de produto ficam para V2.

MUST
B2C-08

HubSpot Tracking Code no site

Script de rastreamento ativo em todas as páginas do site e blog. Identifica visitantes, captura UTMs e atribui origem correta ao lead.
Status: Já instalado e testado em sandbox.

MUST

Migração de Dados — Trazer o que esta no RD

6 itens

B2C-09

Migração base Marketing (RD Marketing)

Importar todos os leads com lifecycle stage, score e conversoes. Isaac já tem acesso ao RD, criou API app e scripts de extração.
Escopo V1: trazer quem e cliente, quem não e, quem esta em negociação. Dados financeiros não existem no RD — não precisa se preocupar com isso.
Nota: RD Marketing (pago) expira em abril. Dados ficam ~1 ano, mas as automações param. Importar antes.

MUST
B2C-10

Migração base CRM B2C (RD CRM)

Negocios em andamento com status, etapas e proprietarios. Vendedores precisam retomar negociações de onde pararam.
Escopo V1: status de vendas e negociações ativas. Se houve transação que foi para o backend deles e não voltou para o RD, problema deles — não cabe a nos.
RD CRM (gratuito): continua existindo após o cancelamento do Marketing. Não ha urgencia de perda, mas migramos na V1 para unificar.

MUST
B2C-12

Higienização de dados

Remover emails inválidos (hard bounce), telefones fora do padrão e duplicidades antes de importar. Tratamento pré-importação via scripts.
Impacto: sem higienização, base suja prejudica entregabilidade de e-mail e gera custos de licença por contatos inúteis.

MUST
B2C-14

Custom Object: Pets

Objeto personalizado associado ao contato com espécie e raça. Estrutura base para toda a operação — a interface do vendedor cria Pets diretamente.
V1: campos essenciais (espécie, raça, nome, plano). Campos complementares (idade, vacina, microchip) ficam para V2 — time de vendas confirmou que não usa para vender.

MUST
B2C-18

Continuidade da lógica de negocio (automações RD)

Automações criticas do RD Station já foram replicadas no HubSpot, mas não estao ativas. Avaliar internamente com o marketing quais podem ser ativadas e quais precisam de ajuste.
Status: automações replicadas, avaliação interna pendente.

MUST
B2C-19

Landing Pages de alta performance + DNS

LPs já concluídas no HubSpot precisam de configuração de DNS para ficarem live. Formulário WhatsApp on hold. LPs de backlog mapeadas.
Status: LPs prontas, DNS pendente para públicação.

MUST

Vendas B2C — Operar sem RD desde o dia 1

5 itens

B2C-05

Gestão de duplicidade

Impedir que 2 vendedores abordem o mesmo lead. Se contato já tem proprietario ou negocio aberto, notificação vai para o dono atual.
Status: lógica já criada no HubSpot (workflow de triagem).

MUST
B2C-29

Fila de ligações

Task Queues priorizadas por conversão no site e Zenvia. SDR abre a fila e liga um atras do outro sem navegar entre telas.
Depende de: integração do formulário funcionando para popular a fila.

MUST
B2C-35

Automação de tarefas por etapa do funil

Ao mover negocio de etapa, sistema cria tarefa automatica com SLA (ex: "Cobrar feedback" em T+2 dias).
Status: automações configuradas, pendente apresentar ao time e coletar feedback sobre as instruções das notificações.

MUST
B2C-33

Agendamento online

Vendedor envia link de agendamento para o cliente marcar uma consulta ou callback. Integra com calendário do HubSpot.

MUST
B2C-39

Validação de dados obrigatórios

Impedir que o vendedor crie um negocio sem informações essenciais preenchidas (nome, telefone, pet, plano).
Status: aguardando aprovação do documento de objetos e valores.

MUST

Setup — Conta pronta para operar

6 itens

B2C-17

Usuários, equipes, permissões e licenças

Todos os colaboradores com login, equipes e níveis de permissão corretos.
Status: equipes e permissões já criadas via script (Isaac). Falta subir os usuários e atribuir licenças (seats). Usuários sobem sem licenca primeiro, ajuste de seats no final.
Depende de: lista de usuários e funcoes para atribuir licenças corretas.

MUST
B2C-16

Configuração da conta (DNS email, brand kit, fuso)

SPF/DKIM autenticados para entregabilidade de e-mail. Brand kit (logo/cores), fuso horario (BRT) e moeda (BRL) configurados.

MUST
B2C-25

LGPD — Gestão de consentimento

Mapear opt-out e bases legais do RD para os campos de privacidade do HubSpot. Ativar GDPR settings. Leads marcados como opt-out não recebem email.

MUST
B2C-22

Non-Marketing Contacts (proteger custo)

Identificar leads inativos e marcar como Non-Marketing para não pagar licenca por eles. Workflow de reengajamento: se não abre email em 30 dias, vira non-marketing automaticamente.

MUST
ASSETS

Validação de assets migrados do RD

44 assets já migrados (19 LPs + 25 workflows). Validar que os workflows críticos estao funcionando antes de desligar o motor de marketing do RD.

MUST
EMAILS

Templates de email (108 modelos)

Concluir a migração dos 108 modelos de email para o HubSpot. Templates editaveis e responsivos no drag-and-drop editor.
Status: migração em andamento, modelos sendo convertidos para o formato HubSpot.

MUST

Marketing — Segmentação e gatilhos essenciais

2 itens

B2C-21

Segmentação por especie/raca

Enviar campanhas específicas para donos de Gato vs Cachorro, e por raca. Base para toda a comunicação segmentada da PetLove no HubSpot.

MUST
B2C-27

Gatilhos comportamentais no site

Disparar ações baseadas nas páginas que o lead visita (ex: pagina de preços, pagina de planos). Automatizar follow-up por interesse demonstrado.

MUST

V2 — Após a operação estar rodando

V2 — Não entra agora

Estes itens estão classificados como Should ou Could na planilha de user stories. Serão entregues após a V1 estar em operação. Nenhum deles impede a PetLove de vender ou atender clientes.

Marketing & Automação (Should)

Nutrição pós-abandono de carrinho

Formulários inteligentes (campos progressivos)

Campanhas de cross-sell (assinante → plano saúde)

Reaquecimento de base fria do RD Station

Newsletter automatizada (RSS blog)

Jornada personalizada por persona (B2B vs B2C)

Lead scoring (classificação A/B/C/D)

Dados & Estrutura (Should)

B2C-06 — Integração bidirecional HubSpot ↔ Backoffice

B2C-11 — Migração base CRM B2B (novo CRM identificado)

B2C-13 — Propriedades personalizadas adicionais

B2C-15 — Segmentação visual por unidade de negocio

Migração do blog (preservação SEO e autores)

Vendas B2C (Should / Could)

Script de vendas (Playbook) — Could

Gravação e transcrição de chamadas — Could

Automação de "No-Show" / Sem Contato — Should

Snippets e templates de resposta rapida — Should

Oportunidade multi-pet, resgate pagamento falho, upsell, cobrança — Could

Analytics & CS (V3)

Dashboards avançados — receita, funil, eficiência, forecast, ROI

CS — NPS, SAC, alertas de churn, omnichannel

Chatbot de triagem no site

Dependências da PetLove (blockers)

Atraso crítico — API Health

O cronograma final de desenvolvimento e 27/03/2026. Ate o momento, a API Health não está funcional — com diversos atrasos e documentações incompletas entregues desde dezembro/2025. Isso nos obriga a comprimir o desenvolvimento para ~3 semanas uteis (09/03 a 27/03).

O time EPIC trabalhará em regime de overload para cumprir o prazo. As horas adicionais serão descontadas do saldo de horas do contrato total.

Dependência	Responsável	Status	Impacto
API Health com autenticação + endpoints Discovery iniciada em dez/2025 — 3 meses sem uma entrega de API funcional. Documentações entregues incompletas.	PetLove	Atraso crítico	Bloqueia integração do formulário do site, CRM Card e checkout. Comprime desenvolvimento para 2 semanas.
Aprovação deste documento (V1)	PetLove	Gate	Sem aprovação, cronograma não inicia
Token Zenvia API v2 Token fornecido retorna HTTP 401 (Unauthorized). Pode estar expirado, revogado ou sem escopos necessários.	PetLove / Zenvia	Bloqueado	Sem token válido, não é possível configurar webhooks, validar subscriptions nem testar fluxo end-to-end com dados reais.
DNS (lp + conteudo) Proxy Cloudflare ativo — Error 1034. CNAME deve estar DNS only.	PetLove TI / HubSpot	Bloqueado	Bloqueia públicação de LPs e paginas de conteudo no HubSpot
Aprovação do fluxo de regras de negocio Fluxo minimo: lead → wizard → checkout → ativação	PetLove	Gate	Sem aprovação, desenvolvemos algo errado

Consequência do atraso: O desenvolvimento que seria distribuído em 4-5 semanas sera comprimido em ~3 semanas uteis (09/03 a 27/03). O time EPIC operará em overload para cumprir o prazo final. Horas adicionais decorrentes dessa compressao serão descontadas do saldo do contrato.

Cronograma restante para entrega da V1

Entrega	Semana 1 02-06/03		Semana 2 09-13/03		Semana 3 16-20/03		Semana 4 23-27/03		Semana 5 30/03-03/04		Semana 6 06-10/04
	02-04	05-06	09-11	12-13	16-18	19-20	23-25	26-27	30-01	02-03	06-08	09-10
Gates — Blockers PetLove / Zenvia
1. Aprovação regras de negócio GATE
2. Token Zenvia API v2 (HTTP 401) BLOCKER
3. Subscription URL Zenvia BLOCKER
4. DNS (lp + conteudo) BLOCKER
Gates — Health API (30 requests mapeados, 3 bloqueios pendentes)
5. D1: enrollmentBaseUrl (host 404) BLOCKER
6. D2: hookToken (não fornecido) BLOCKER
7. G4: Purchase Event webhook (não definido) BLOCKER
Semana 1 (02-06/03) — Migração + Setup
8. Migração base MKT (RD) EPIC
9. Migração base CRM B2C (RD) EPIC
10. Higienização + Custom Object Pets EPIC
11. Setup conta (DNS, brand, fuso) EPIC
12. HubSpot Tracking Code no site EPIC
13. Continuidade automações RD + LPs EPIC
14. Usuários, equipes, permissoes EPIC
Semana 2 (09-13/03) — Integrações
15. Zenvia → HubSpot (Forms API) EPIC
16. Formulário site → HubSpot EPIC
17. CRM Card (interface vendedor) EPIC
18. Evento Purchase e demais eventos personalizados EPIC
19. Segmentação + Gatilhos MKT EPIC
Semana 3 (16-20/03) — Vendas + Setup final
20. Gestão duplicidade + Fila ligações EPIC
21. Automações + Agendamento + Validação EPIC
22. LGPD + Non-Marketing EPIC
23. Templates email (108 modelos) EPIC
24. Validação assets migrados EPIC
Semana 4 (23-27/03) — QA + Go-Live
25. Testes E2E + QA EPIC
26. Treinamentos e Suporte AMBOS
Semana 5 (30/03-03/04) — Go-Live
27. Go-Live AMBOS
Semanas 5-6 (30/03-10/04) — Hyper-Care
28. Hyper-Care (2 semanas) EPIC

Entrega EPIC

Entrega PetLove

Gate (aprovação necessaria)

Blocker

Conjunto

Leitura: Os gates estao divididos em dois grupos: Zenvia (token + subscription URL) e Health API (3 bloqueios identificados na collection V1.2 — 30 requests mapeados, sprints 09/03, 11/03 e 12/03). Todos devem ser resolvidos ate o final da Semana 1 para que as integrações da Semana 2 não sejam bloqueadas. Cada dia de atraso nos gates = 1 dia a mais no prazo final.

Modelo de integração — V1

A V1 utiliza integração direta com o HubSpot para ambos os domínios (Health API do site e Zenvia do WhatsApp). Essa abordagem permite a entrega mais rapida, sem dependência de infraestrutura adicional, e cobre 100% dos cenários funcionais necessários para a operação.

Zenvia (WhatsApp) — via Forms API

Bot Zenvia coleta dados do lead no WhatsApp e envia direto para o HubSpot. Contato criado automaticamente, workflow dispara e atribui vendedor. Sem middleware, sem servidor.

Validado em producao. PoC executada com sucesso — 34 propriedades criadas, formulário configurado, 6 contatos criados. 100% dos leads capturados, zero perda.

Documentação técnica completa da integração Zenvia × HubSpot →

Health API (Jornada do Site) — HubSpot Direto

Formulário de contratação B2C → Wizard → Checkout → Ativação do plano

Caracteristica	Como funciona na V1
Como funciona	Site envia POST direto para HubSpot (Forms API ou Custom Code via Workflow). Toda a lógica roda dentro do HubSpot.
Contatos novos	Criados automaticamente via Forms API.
Fases cobertas	3 fases: Wizard (lead → contato + pet + deal), Checkout (simular + proposta + MRR), Ativação (dados pet + microchip).
Tratamento de CPF	Tratado via Custom Code no workflow — sanitizado após recebimento. Avaliar com Zenvia a possibilidade de não enviar o dado na origem.
Manutenção	Tudo dentro do HubSpot. PetLove pode ajustar workflows sem depender da EPIC para mudanças simples.

Melhoria futura (V2) — Middleware

A arquitetura com middleware (servidor intermediário Node.js/Express) foi avaliada como alternativa. Embora ofereça benefícios adicionais, ela não e necessária para a operação da V1 e adicionaria +25 a 43 dias ao cronograma.

O que o middleware traria como melhoria futura:

Fila de retry / DLQ — se HubSpot ou Health API falharem, o middleware reenfileira. Nenhum dado e perdido.
Tratamento de dados sensiveis (LGPD) — CPF e outros dados podem ser sanitizados, mascarados ou redirecionados antes de chegar ao HubSpot.
Histórico de conversa — injeta mensagens do WhatsApp na Timeline API do contato diretamente.
Sem limite de timeout — servidor proprio não tem o limite de 20 segundos do Custom Code.
Enriquecimento de dados — consultar APIs externas e complementar informações antes de registrar no CRM.

O middleware e uma evolução natural da arquitetura, não um requisito. Sera tratado como melhoria na V2, se aprovado pela PetLove após a V1 estar em operação.