Conectar HubSpot ao Elido

A integração do HubSpot encaminha eventos de conversão do Elido para o HubSpot como propriedades de contato e atualizações de negócios. Quando alguém clica em um link rastreado e completa uma meta de conversão, o Elido envia os dados de atribuição (UTM source, campaign, click ID) para o HubSpot — sem que você precise escrever nenhum código.

Conectar via OAuth#

1. Vá para Dashboard → Conversions → HubSpot → Connect HubSpot.
2. A tela de OAuth do HubSpot é aberta. Faça login com uma conta que tenha acesso a "CRM → Objects".
3. O HubSpot mostra os escopos solicitados: crm.objects.contacts.write e crm.objects.deals.write. Estes permitem que o Elido grave em propriedades de contato e mova negócios através de estágios.
4. Clique em Connect app. O HubSpot redireciona você de volta para o Elido.

Os tokens de atualização giram automaticamente. Se você revogar o acesso pelo lado do HubSpot (Settings → Connected Apps), o Elido para imediatamente de enviar eventos e mostra um erro de "token revoked" no delivery log.

Mapear campos#

Após conectar, vá para Dashboard → Conversions → HubSpot → Configure:

1. Contact properties — escolha quais propriedades de contato do HubSpot o Elido irá gravar. Campos disponíveis do Elido: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Deal stage — selecione o pipeline e o estágio para o qual uma conversão move um negócio. Deixe em branco se você não usa negócios no HubSpot.
3. Match contact by — e-mail (se você captura e-mail pela sua landing page) ou HubSpot contact ID (para atribuição server-side onde você passa hs_contact_id na URL).

O que o Elido grava no HubSpot#

Cada conversão cria um evento de linha do tempo no HubSpot e (se mapeado) atualiza as propriedades do contato. O payload bruto que o Elido envia:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

O HubSpot mostra isso como um evento de linha do tempo personalizado no registro de contato. A atualização do estágio do negócio (se configurada) é disparada na mesma requisição.

O que não sincroniza#

• Click events without a conversion — cliques brutos não criam registros no HubSpot. Apenas conversões o fazem.
• Historical data — a integração é apenas forward-only a partir do momento em que você conecta.
• HubSpot → Elido — a integração é apenas de saída. Mudanças de negócio no HubSpot não fluem de volta para o Elido.

Solução de problemas#

Erro "Insufficient permissions" — O usuário do HubSpot que autorizou não tinha acesso de gravação no CRM. Peça a um super admin do HubSpot para reautorizar em Dashboard → Conversions → HubSpot → Reconnect.

Contact not found — events dropped — Se o Elido não conseguir encontrar um contato correspondente por e-mail ou ID, o evento é registrado, mas não encaminhado. Verifique Dashboard → Conversions → Delivery log para entradas "no matching contact".

Conversions arriving with wrong campaign attribution — Verifique se os parâmetros UTM estão presentes na URL de destino. O Elido os captura do clique; se o link não tiver UTMs, os campos do HubSpot estarão vazios.

OAuth keeps expiring — O HubSpot revoga tokens para aplicativos que não chamam o refresh endpoint em mais de 6 meses. A integração do Elido atualiza a cada evento. Se você não recebeu nenhuma conversão em meses, reconecte manualmente.