HubSpot a retiré ses clés d’API classiques en 2022. La façon moderne d’accorder à une application tierce l’accès à vos données HubSpot est une application privée — vous (en tant qu’administrateur de votre compte HubSpot) créez l’application, choisissez exactement les autorisations dont elle a besoin, et HubSpot vous délivre un jeton permanent à coller dans Anexus.
Avant de commencer
- Vous devez être un administrateur HubSpot (ou disposer d’un utilisateur avec les autorisations « App Marketplace Access » et « Service Hub »).
- Fonctionne avec tous les forfaits HubSpot, y compris le niveau CRM gratuit.
Étape 1 — Créer l’application privée dans HubSpot
Dans HubSpot, allez à Paramètres (icône d’engrenage, en haut à droite) → Intégrations → Applications privées.
Cliquez sur Créer une application privée.
Dans l’onglet Informations de base :
- Nom : Anexus Connect
- Logo : facultatif
- Description : « Synchronise automatiquement vers HubSpot les contacts saisis par Anexus »
Passez à l’onglet Portées. Recherchez et cochez :
crm.objects.contacts.readcrm.objects.contacts.write
Ceci nous permet de rechercher les contacts existants (afin de les mettre à jour au lieu de les dupliquer) et d’en créer de nouveaux.
Cliquez sur Créer l’application en haut à droite. HubSpot affiche un avertissement indiquant que vous ne pouvez pas modifier les portées après la création — confirmez.
HubSpot affiche le jeton d’accès. Il commence par pat- et compte environ 80 caractères. Copiez-le maintenant — vous pourrez revenir le consulter plus tard, mais il est plus facile de le copier depuis cet écran.
Étape 2 — Le coller dans Anexus
Dans Anexus, allez à Paramètres → Intégrations CRM.
Trouvez la carte HubSpot et cliquez sur Connecter.
Collez le jeton d’accès. Cliquez sur Enregistrer et connecter.
Anexus lance un appel test rapide vers HubSpot pour confirmer que le jeton fonctionne et récupérer le nom de votre compte (pour pouvoir l’afficher sur la carte). En cas de succès, la carte devient verte.
Ce qui se synchronise vers HubSpot
Chaque nouveau contact saisi via votre formulaire d’échange devient (ou met à jour) une fiche de contact HubSpot avec :
- Courriel (clé unique de HubSpot — nous effectuons un « upsert » par courriel afin qu’une même personne ne soit jamais dupliquée)
- Prénom, nom de famille
- Téléphone, entreprise, fonction
hs_lead_status = NEW(afin qu’ils apparaissent par défaut dans votre vue « Nouveaux prospects »)
Pour récupérer les contacts saisis avant la connexion, cliquez sur Synchroniser les contacts antérieurs sur la carte HubSpot. Nous les envoyons par lots de 50 avec une barre de progression en direct.
En cas de problème
« HubSpot a rejeté le jeton »
Le jeton est incorrect, expiré, ou des portées sont manquantes. Ouvrez l’application privée dans HubSpot → recopiez le jeton d’accès → reconnectez-vous dans Anexus. Si les portées sont incorrectes, vous devrez supprimer l’application et en créer une nouvelle (HubSpot n’autorise pas les modifications de portée).
Les contacts n’apparaissent pas dans HubSpot
Cliquez sur Tester sur la carte HubSpot pour confirmer que le jeton est toujours actif (un administrateur a peut-être pu le révoquer). Si le test réussit mais que les nouveaux contacts n’apparaissent pas, vérifiez votre filtre HubSpot « Nouveaux » — ils peuvent se trouver dans la vue « Tous les contacts » triés selon une ancienne date.
Contacts en double dans HubSpot
Cela ne devrait pas se produire — nous effectuons une recherche par courriel avant la création. Si vous voyez des doublons, cela signifie généralement que la même personne a soumis votre formulaire avec deux adresses de courriel différentes (chacune correspond à une fiche HubSpot distincte).
Comment se déconnecter
Cliquez sur Déconnecter sur la carte HubSpot. Nous arrêtons immédiatement d’envoyer de nouveaux contacts. Pour révoquer également le jeton du côté de HubSpot : retournez à Paramètres → Intégrations → Applications privées dans HubSpot, ouvrez l’application Anexus Connect et cliquez sur Supprimer.