Conectar o HubSpot ao Elido

A integração com o HubSpot grava os cliques em links no HubSpot como eventos personalizados de linha do tempo. Quando alguém clica em um link rastreado e o Elido consegue associar o clique a um endereço de e-mail, o evento aparece no registro desse contato no HubSpot.

Conectar via OAuth

1. No Elido, abra Dashboard → Integrations → HubSpot e inicie a conexão.
2. A tela de OAuth do HubSpot é aberta. Entre com uma conta que tenha permissão para instalar apps no seu portal.
3. O HubSpot mostra os escopos solicitados: leitura e escrita de contatos, eventos de linha do tempo e automação. O Elido busca contatos por e-mail e grava eventos de linha do tempo neles.
4. Aprove o app. O HubSpot redireciona você de volta ao Elido.

Os refresh tokens são renovados automaticamente. Se você revogar o acesso pelo HubSpot (Settings → Connected Apps), o Elido não poderá mais gravar eventos até você reconectar.

Como um clique é associado a um contato

O Elido procura um endereço de e-mail nesta ordem e usa o primeiro válido:

1. Um valor email enviado com o evento de clique.
2. metadata.email no evento de clique.
3. utm_content, se contiver um endereço de e-mail.
4. Um parâmetro de consulta email= na URL de destino (um padrão comum em e-mails transacionais).

Em seguida, busca esse e-mail entre os seus contatos do HubSpot. Se nenhum contato corresponder, nada é gravado.

O que o Elido grava no HubSpot

Para cada clique associado, um evento de linha do tempo é criado no contato com estes tokens:

• short_url e destination_url
• campaign (de utm_campaign) e source (de utm_source)
• occurred_at

O HubSpot o exibe como um evento personalizado de linha do tempo no registro do contato. O Elido não altera propriedades de contatos nem negócios.

O que não é sincronizado

• Cliques sem e-mail: se o Elido não consegue identificar um e-mail, o clique é ignorado.
• Conversões: os eventos de conversão ainda não são enviados ao HubSpot (veja a nota de Planejado acima).
• Dados históricos: a integração só vale daqui para frente, a partir do momento em que você conecta.
• HubSpot → Elido: somente saída. As alterações feitas no HubSpot não voltam para o Elido.

Solução de problemas

Os cliques não aparecem no contato: Verifique se o e-mail chega ao Elido por uma das quatro vias acima e se existe um contato no HubSpot com exatamente esse e-mail (a comparação não diferencia maiúsculas de minúsculas).

Os eventos pararam depois de revogar o app: Reconecte em Dashboard → Integrations → HubSpot.

Campaign ou source vazios no evento: O Elido os obtém dos parâmetros UTM do clique. Se o link não tem UTMs, esses tokens ficam vazios.