Integração Health API × HubSpot

2.1 O que o HubSpot oferece que viabiliza este fluxo

Tres capacidades do HubSpot permitem eliminar o middleware:

1. HubSpot Forms / Submit API

O site pode enviar dados do wizard diretamente para o HubSpot usando HubSpot Forms (embedded ou popup) ou a Forms Submit API (POST server-side). Quando o form e submetido, o HubSpot cria ou atualiza o Contact automaticamente e pode disparar um Workflow.

• Cria Contact automaticamente no submit (upsert por email)
• Dispara Workflow automaticamente após submit
• Captura qualquer campo custom (especie, raca, plano, CEP)
• Funciona com HubSpot Forms gratuito (form embed) ou Marketing Hub (submit API)

2. Custom Code Actions (código serverless dentro do Workflow)

Dentro de um Workflow, e possível rodar código Node.js ou Python como serverless function. O Custom Code pode chamar APIs externas (Enrollment API, Health API) e a API do HubSpot internamente.

• Chamar Enrollment API: simulate, proposal, proposal/{id}
• Chamar Health API: plans, regions, species (dados de referência)
• Usar @hubspot/api-client para criar Deal, Pet (CO), Line Items, Associations
• Guardar secrets (tokens) em variáveis de ambiente seguras

3. Workflow Actions nativas

Alem do Custom Code, o Workflow oferece ações nativas que substituem parte do que o middleware faria:

• Create Deal (ação nativa do Workflow)
• Set Property em Contact, Deal, Custom Object
• Create Association entre objetos
• Send internal notification / Create task

2.2 Passo a passo — as 3 fases

PASSO 1    Lead entra no site PetLove e completa o WIZARD
           (escolhe especie, raca, plano, preenche dados pessoais)
           ↓
PASSO 2    SITE submete um HubSpot Form (embed ou API submit)
           → HUBSPOT cria/atualiza o Contact automaticamente
           ↓
PASSO 3    WORKFLOW dispara (trigger: form submitted)
           ↓
PASSO 4    CUSTOM CODE #1 (Node.js) roda:
           a) Le dados do Contact (especie, raca, plano, CEP)
           b) Cria Pet (Custom Object) via @hubspot/api-client
           c) Cria Deal + Line Items
           d) Cria Associations v4
           ↓
PASSO 5    Lead confirma checkout (outro form submit ou webhook)
           ↓
PASSO 6    CUSTOM CODE #2 (Node.js) roda:
           a) Chama Enrollment API: simulate → preços reais
           b) Chama Enrollment API: proposal → cria proposta
           c) Atualiza Deal (stage, amount, MRR)
           ↓
PASSO 7    Após pagamento, lead preenche ativação (outro form/webhook)
           ↓
PASSO 8    CUSTOM CODE #3 (Node.js) roda:
           a) Atualiza Pet (dados complementares + microchip)
           b) Atualiza Deal → stage: Ativo
           ↓
PASSO 9    HUBSPOT tem tudo: contato, pet, negocio, vendedor.

Fase 1 — Wizard (Lead)

O site da PetLove usa um HubSpot Form (embedded ou via Submit API) em vez de chamar um middleware. O form coleta: nome, email, telefone, CEP, especie, raca, plano desejado. Ao submeter, o HubSpot cria/atualiza o Contact automaticamente. Um Workflow e triggered pelo form submit.

Fase 2 — Checkout (Venda)

Quando o lead vai para checkout (outro submit ou webhook), um segundo Custom Code chama a Enrollment API via axios: POST /proposal/simulate (preços reais), depois POST /proposal (submete proposta). Atualiza o Deal com amount, MRR e stage. ATENCAO: simulate + proposal + update Deal precisam caber em 20 segundos.

Fase 3 — Ativação

Após pagamento confirmado, o lead preenche ativação. Um terceiro Custom Code atualiza Pet (dados complementares + microchip) e muda Deal para 'Ativo'.

2.3 Diagrama da arquitetura

              HubSpot Form / Submit API
 _______________                         _________________________________
|               |                       | HUBSPOT (Operations Hub)        |
| SITE PETLOVE  | =====================>|                                 |
| (frontend)    |                       | 1. Form submit → Create Contact |
|_______________|                       | 2. Workflow triggered            |
                                        |    3. Custom Code #1:           |
                                        |       - @hubspot/api-client     |
 _______________                        |       - Pet, Deal, LI, Assoc v4 |
| ENROLLMENT   |                        |    4. Custom Code #2 (checkout):|
| API PetLove  | <==== axios =========|       - Enrollment: simulate    |
| (host ?)     |                        |       + proposal                |
|______________|                        |       - Update Deal (MRR,stage) |
                                        |    5. Custom Code #3 (ativação):|
 _______________                        |       - Update Pet (microchip)  |
| HEALTH API   |                        |       - Update Deal → Ativo    |
| (público)    | <==== axios =========|                                 |
|______________|                        | Resultado: Contact+Deal+Pet+LI  |
                                        |_________________________________|

2.4 Quem faz o que

2.5 Limitações conhecidas e mitigações

3.1 Bloqueios críticos (impedem desenvolvimento)

3.2 Gates (aprovações pendentes)

3.3 GAPs (definicoes pendentes)

4.1 Health API — endpoints públicos (sem autenticação)

Host: https://health-api.petlove.com.br — Cloudflare + Laravel + Envoy. Requer User-Agent (ex: PostmanRuntime/7.36.0).

4.2 Health API — endpoints hook (requerem token)

4.3 Enrollment API — 6 endpoints (host desconhecido)

5.1 Customer → Contact HubSpot

5.2 Pet → Custom Object Pet HubSpot

5.3 Proposal Status → Deal Stage HubSpot

5.4 Proposal (body para simulate/submit)

6.1 Custom Object: Pet (schema)

6.2 Associations v4

6.3 Server-Side Events (Events API v3)