Visão Executiva

Integração Health API × HubSpot

Jornada do Site — Wizard, Checkout e Ativação
EPIC Digital • PetLove • 06 Mar 2026 • Baseado na Análise Técnica V2

1. Resumo da Solução

A integração captura a jornada completa do site PetLove (selecao de plano ate ativação do pet) e registra todos os dados no HubSpot CRM, usando Custom Code Actions dentro de Workflows — sem necessidade de servidor externo.

3
Fases
3
Custom Codes
10
APIs Públicas
6
Events Server-Side

2. Jornada do Site em 3 Fases

🧭
Wizard
Especie, CEP, Plano
→
💳
Checkout
Pagamento, Proposta
→
🐾
Ativação
Dados Pet, Microchip
→
✅
HubSpot
Contact + Deal + Pet

Fase 1 — Wizard (Custom Code #1)

Lead completa selecao de especie, CEP e plano no site.

  • Cria ou atualiza Contact (upsert por email)
  • Cria Deal no pipeline de saúde
  • Cria Custom Object Pet (nome, especie, raca)
  • Cria Line Items com plano selecionado
  • Dispara evento lead_wizard_gerado

Fase 2 — Checkout (Custom Code #2)

Cliente finaliza pagamento e PetLove confirma a venda.

  • Chama Enrollment API para simular e submeter proposta
  • Atualiza Deal stage para Venda Concluída
  • Calcula e grava MRR no Deal
  • Dispara eventos tentativa_pagamento e venda_concluída

Fase 3 — Ativação (Custom Code #3)

Cliente preenche dados do pet e define microchip.

  • Atualiza Custom Object Pet (microchip, data nascimento)
  • Move Deal para stage Ativo
  • Dispara eventos ativação_iniciada, microchip_escolhido, ativação_concluída

3. Por que HubSpot Direto (sem Middleware)

CriterioHubSpot Direto (V1)Middleware (V2 futura)
Servidor externoNão precisaSim
Custo adicionalZeroHosting
ManutencaoDentro do HubSpotCódigo externo
Tempo de entregaMenor+25-43 dias
Retry/DLQLimitadoCompleto
Timeout20 segSem limite
Recomendação Comecar com HubSpot Direto (V1). Middleware e evolução natural para V2, se necessário após operação estavel.

4. Estrutura no HubSpot CRM

ObjetoTipoFuncaoCriado na fase
ContactNativoDados do cliente (email, nome, telefone, endereço)Fase 1
DealNativoProposta/assinatura (stage, valor, MRR)Fase 1
PetCustom ObjectDados do pet (nome, especie, raca, microchip)Fase 1
Line ItemsNativoPlano selecionado (nome, preço, cobertura)Fase 1

Associations

👤
Contact
↔
💼
Deal
↔
🐾
Pet

Pet associado a Contact e Deal. Line Items associados ao Deal.

5. Mapeamento de Status

Status PetLoveDeal Stage HubSpotTrigger
PENDING_PAYMENTProposta EnviadaProposta criada
PENDING_CONTRACTVenda ConcluídaCheckout aprovado
PENDING_CHIPAtivação PendenteDados pet preenchidos
ACTIVEAtivoMicrochip definido
CANCELED / BLOCKED / SUSPENDEDCancelado / Bloqueado / Suspenso—

6. Bloqueios Críticos

Existem dependências que precisam ser resolvidas pela PetLove antes do desenvolvimento avancar:

D1 — Enrollment API (URL desconhecida) A API de enrollment (proposta, simulação, pagamento) retorna 404 em todos os endpoints testados. O host correto (enrollmentBaseUrl) precisa ser fornecido pela PetLove. Sem ela, o Custom Code #2 (checkout) não pode ser desenvolvido. Discovery iniciada em Dez/2025 — 3 meses sem resolução.
D2 — Hook Token (autenticação) Endpoints /api/hook/* retornam 401/403. Token de autenticação necessário para acessar dados de cliente via hook. Dependência da PetLove.
G4 — Evento de Compra (Purchase Event) Como o HubSpot e notificado quando um pagamento e confirmado? O evento de compra e server-side (Health Track / Vindi). PetLove precisa definir o mecanismo de callback.
DNS — Cloudflare Proxy O dominio health-api.petlove.com.br esta atras do Cloudflare com proxy ativo. Chamadas do Custom Code HubSpot podem ser bloqueadas. TI PetLove precisa liberar ou desativar proxy.
Z1 — Zenvia Token (401) Token de integração Zenvia retorna 401. Necessário para integração WhatsApp (frente separada, mas relacionada).

7. APIs PetLove — Panorama

10
Públicas (OK)
3
Hook (401/403)
6
Enrollment (404)
GrupoExemplosStatusUso
Health API Pública /api/species, /api/plans, /api/regions, /api/campaign Acessível Referência para wizard (especies, planos, regiões)
Hook Endpoints /api/hook/customer, /api/hook/plans, /api/hook/is-active-customer Bloqueado Dados do cliente via hook (requer token D2)
Enrollment API /api/enrollment/v1/customer, /plans, /proposal, /simulate 404 Core do checkout — host desconhecido (D1)

8. Compliance & Seguranca

CPF nunca e mantido no HubSpot — mas ainda e enviado Regra de compliance PetLove: CPF não pode ser armazenado no CRM. Hoje, o Custom Code recebe o payload completo (incluindo CPF), sanitiza, e grava sem o campo. Porem, o CPF transita pelo HubSpot durante a execução. Sanitização 100% só e possível tratando na fonte (site/app não envia CPF) ou via Middleware (intercepta antes de chegar ao HubSpot).
ItemResponsávelStatus
Sanitização CPF (Custom Code)EPICPaliativo
Sanitização CPF (fonte ou Middleware)PetLove + EPICV2 futura
Dados sensiveis (LGPD)PetLove + EPICDefinir escopo
Rastreabilidade vendedorEPICVia seller.sourceSellerId

9. Fora do Escopo da Integração

ItemResponsávelNota
Evento de compra confirmada (server-side)Health Track / VindiBackend PetLove, não via HubSpot
Enrollment API (hosting)Backend PetLoveCustom Code consome; PetLove mantem
Health API (hosting)Backend PetLovehealth-api.petlove.com.br
GTM / Google AnalyticsEquipe dados PetLoveSistema paralelo
Migração RD StationEquipe dados PetLoveCarga legada, deadline 31/03

10. Próximos Passos

#AçãoResponsávelPrioridade
1 Fornecer URL da Enrollment API (enrollmentBaseUrl) PetLove Crítico
2 Fornecer token Hook (/api/hook/*) PetLove Crítico
3 Definir callback de compra (como HubSpot e notificado) PetLove + EPIC Alto
4 Liberar Cloudflare para chamadas HubSpot TI PetLove Alto
5 Desenvolver Custom Code #1 (Wizard) EPIC Após D1/D2
6 Desenvolver Custom Code #2 (Checkout) EPIC Após D1
7 Desenvolver Custom Code #3 (Ativação) EPIC Após #1 e #2
Mensagem-chave O projeto de integração Health API esta bloqueado por dependências da PetLove (Enrollment API URL e Hook Token). A EPIC esta pronta para executar assim que os acessos forem liberados. Cada dia de atraso nessas entregas impacta diretamente o cronograma de go-live.
Revenue Architecture