Connecter HubSpot à Elido

L'intégration HubSpot transfère les événements de conversion Elido dans HubSpot sous forme de propriétés de contact et de mises à jour de deals. Lorsque quelqu'un clique sur un lien suivi et atteint un objectif de conversion, Elido pousse les données d'attribution (source UTM, campagne, ID de clic) vers HubSpot — sans que vous écriviez du code.

Connecter via OAuth#

1. Allez dans Dashboard → Conversions → HubSpot → Connecter HubSpot.
2. L'écran OAuth HubSpot s'ouvre. Connectez-vous avec un compte ayant l'accès "CRM → Objets".
3. HubSpot affiche les portées demandées : crm.objects.contacts.write et crm.objects.deals.write. Celles-ci permettent à Elido d'écrire des propriétés de contact et de faire avancer les deals dans les étapes.
4. Cliquez sur Connecter l'application. HubSpot vous redirige vers Elido.

Les jetons de rafraîchissement tournent automatiquement. Si vous révoquez l'accès depuis le côté HubSpot (Paramètres → Applications connectées), Elido arrête immédiatement d'envoyer des événements et affiche une erreur "jeton révoqué" dans le journal de livraison.

Mapper les champs#

Après la connexion, allez dans Dashboard → Conversions → HubSpot → Configurer :

1. Propriétés de contact — choisissez les propriétés de contact HubSpot qu'Elido écrit. Champs Elido disponibles : utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Étape du deal — sélectionnez le pipeline et l'étape vers lesquels une conversion fait avancer un deal. Laissez vide si vous n'utilisez pas les deals HubSpot.
3. Correspondre le contact par — email (si vous capturez l'email via votre page de destination) ou ID de contact HubSpot (pour l'attribution côté serveur où vous passez hs_contact_id dans l'URL).

Ce qu'Elido écrit dans HubSpot#

Chaque conversion crée un événement de timeline HubSpot et (si mappé) met à jour les propriétés du contact. La charge utile brute qu'Elido envoie :

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

HubSpot affiche ceci comme un événement de timeline personnalisé sur l'enregistrement du contact. La mise à jour de l'étape du deal (si configurée) se déclenche dans la même requête.

Ce qui ne se synchronise pas#

• Événements de clic sans conversion — les clics bruts ne créent pas d'enregistrements HubSpot. Seules les conversions le font.
• Données historiques — l'intégration est uniquement prospective à partir du moment de la connexion.
• HubSpot → Elido — l'intégration est uniquement sortante. Les changements de phase de deal dans HubSpot ne reviennent pas vers Elido.

Résolution des problèmes#

Erreur "Permissions insuffisantes" — L'utilisateur HubSpot qui a autorisé n'avait pas l'accès en écriture CRM. Demandez à un super administrateur HubSpot de réautoriser depuis Dashboard → Conversions → HubSpot → Reconnecter.

Contact non trouvé — événements abandonnés — Si Elido ne peut pas trouver de contact correspondant par email ou ID, l'événement est journalisé mais non transféré. Vérifiez Dashboard → Conversions → Journal de livraison pour les entrées "aucun contact correspondant".

Les conversions arrivent avec une attribution de campagne incorrecte — Vérifiez que les paramètres UTM sont présents sur l'URL de destination. Elido les capture depuis le clic ; si le lien n'a pas de UTMs, les champs HubSpot seront vides.

OAuth expire continuellement — HubSpot révoque les jetons pour les applications qui n'appellent pas l'endpoint de rafraîchissement pendant 6+ mois. L'intégration Elido se rafraîchit à chaque événement. Si vous n'avez reçu aucune conversion pendant des mois, reconnectez manuellement.