Connecter HubSpot à Elido

L'intégration HubSpot écrit les clics sur les liens dans HubSpot sous forme d'événements de chronologie personnalisés. Quand quelqu'un clique sur un lien suivi et qu'Elido peut rattacher le clic à une adresse e-mail, l'événement apparaît sur la fiche de ce contact dans HubSpot.

Se connecter via OAuth

1. Dans Elido, ouvrez Dashboard → Integrations → HubSpot et lancez la connexion.
2. L'écran OAuth de HubSpot s'ouvre. Connectez-vous avec un compte autorisé à installer des applications dans votre portail.
3. HubSpot affiche les portées demandées : lecture et écriture des contacts, événements de chronologie et automatisation. Elido recherche les contacts par e-mail et leur écrit des événements de chronologie.
4. Approuvez l'application. HubSpot vous redirige vers Elido.

Les jetons d'actualisation sont renouvelés automatiquement. Si vous révoquez l'accès côté HubSpot (Settings → Connected Apps), Elido ne peut plus écrire d'événements tant que vous ne vous reconnectez pas.

Comment un clic est associé à un contact

Elido cherche une adresse e-mail dans cet ordre et utilise la première valide :

1. Une valeur email transmise avec l'événement de clic.
2. metadata.email sur l'événement de clic.
3. utm_content, s'il contient une adresse e-mail.
4. Un paramètre de requête email= sur l'URL de destination (un schéma courant dans les e-mails transactionnels).

Il recherche ensuite cet e-mail parmi vos contacts HubSpot. Si aucun contact ne correspond, rien n'est écrit.

Ce qu'Elido écrit dans HubSpot

Pour chaque clic associé, un événement de chronologie est créé sur le contact avec ces jetons :

• short_url et destination_url
• campaign (issu de utm_campaign) et source (issu de utm_source)
• occurred_at

HubSpot l'affiche comme un événement de chronologie personnalisé sur la fiche du contact. Elido ne modifie ni les propriétés des contacts ni les transactions.

Ce qui n'est pas synchronisé

• Clics sans e-mail - si Elido ne peut pas identifier d'e-mail, le clic est ignoré.
• Conversions - les événements de conversion ne sont pas encore envoyés à HubSpot (voir la note « Prévu » ci-dessus).
• Données historiques - l'intégration ne fonctionne que vers l'avant, à partir de la connexion.
• HubSpot → Elido - sortant uniquement. Les modifications dans HubSpot ne remontent pas vers Elido.

Dépannage

Les clics n'apparaissent pas sur le contact - Vérifiez que l'e-mail parvient à Elido par l'une des quatre voies ci-dessus et qu'un contact HubSpot avec cet e-mail exact existe (la correspondance ne tient pas compte de la casse).

Les événements se sont arrêtés après la révocation de l'application - Reconnectez-vous depuis Dashboard → Integrations → HubSpot.

Campagne ou source vide dans l'événement - Elido les prend dans les paramètres UTM du clic. Si le lien n'a pas d'UTM, ces jetons sont vides.