Configurer l'intégration HubSpot
L'intégration HubSpot envoie les coordonnées collectées par ton agent IA directement dans ton CRM HubSpot. Lorsqu'un visiteur partage son nom, son adresse e-mail ou son numéro de téléphone, un nouveau contact est automatiquement créé ou un contact existant est mis à jour. Pas de saisie manuelle, pas de fichiers CSV.
En bref
Heyloha se connecte à HubSpot via une Private App. Les données de contact sont mappées directement sur les propriétés de contact HubSpot standard. Les contacts existants sont automatiquement mis à jour en fonction de l'adresse e-mail.
Qu'est-ce qui est synchronisé ?
Tous les champs de contact que tu sélectionnes dans Heyloha sont automatiquement envoyés vers les propriétés de contact HubSpot standard. Aucune configuration de champs personnalisés n'est nécessaire.
- Prénom et nom
- Adresse e-mail
- Numéro de téléphone
- Adresse, code postal, ville et pays
Heyloha utilise le point de terminaison upsert de HubSpot : si un contact avec la même adresse e-mail existe déjà, les informations sont mises à jour au lieu de créer un doublon.
De quoi as-tu besoin ?
- Un compte HubSpot avec accès API (disponible sur tous les plans CRM payants et gratuits).
- Une Private App dans HubSpot avec les bonnes autorisations.
- Un compte Heyloha actif avec au moins un agent IA.
Créer une Private App dans HubSpot
Va dans Private Apps
Connecte-toi à HubSpot et va dans Paramètres > Intégrations > Private Apps.
Crée une nouvelle Private App
Clique sur 'Create a Private App' et donne-lui un nom reconnaissable, par exemple 'Heyloha'.
Définis les autorisations
Va dans l'onglet 'Scopes' et active ces deux autorisations : crm.objects.contacts.write et crm.objects.contacts.read.
Copie le Access Token
Après la création de l'app, un Access Token apparaît. Copie-le, tu en auras besoin dans Heyloha.
Conserve le Access Token en sécurité. Ne le partage pas avec des tiers. Dans Heyloha, le token est stocké de manière chiffrée et n'apparaît jamais dans les logs.
Configurer l'intégration dans Heyloha
Va dans Agent, puis Intégrations
Dans le menu de gauche, clique sur Agent et ouvre l'onglet Intégrations. La section Webhooks se trouve tout en haut.
Clique sur Ajouter un webhook
Dans la section Webhooks, clique sur Ajouter un webhook. Un formulaire s'ouvre pour configurer la connexion.
Choisis 'HubSpot' comme plateforme
Sélectionne HubSpot dans le formulaire. Le formulaire s'adapte automatiquement et n'affiche que les champs dont tu as besoin.
Choisis les canaux (facultatif)
Par défaut, le webhook s'applique à tous les canaux de ton agent. Pour le limiter par exemple au chat web ou à WhatsApp uniquement, sélectionne les canaux souhaités. Si tu laisses vide, la connexion s'applique à tous les canaux.
Colle l'Access Token
Colle le Private App Access Token que tu as copié dans HubSpot. Aucune URL n'est nécessaire, Heyloha se connecte directement à l'API HubSpot.
Nomme l'intégration
Choisis un nom facilement identifiable, par exemple 'HubSpot Lead Sync'. Ce nom est aussi utilisé comme nom de fonction interne.
Sélectionne les champs de contact
Choisis quelles informations ton agent IA doit collecter. Sélectionne au minimum une adresse e-mail. L'IA ne demande que les champs que tu sélectionnes ici.
Choisis les déclencheurs d'événements
Sélectionne quand l'intégration doit se déclencher : lors de la capture de coordonnées, de la réservation d'un rendez-vous ou de l'atteinte d'un objectif.
Décris quand la connexion doit être utilisée
Donne une instruction courte indiquant quand l'IA doit déclencher cette intégration, par exemple : 'Utilise ceci lorsqu'un visiteur veut planifier une démo et laisse ses coordonnées.'
Enregistre et active
Mets l'intégration sur 'Actif' et clique sur Enregistrer dans le formulaire. La connexion est active immédiatement.
Tester la connexion
Après l'enregistrement, tu peux tester la connexion directement via le bouton 'Tester la connexion' sur la carte d'intégration. Un contact test est envoyé à HubSpot.
- Vert 'Connecté' : tes identifiants sont valides et HubSpot a accepté le contact test.
- Erreur rouge : quelque chose ne va pas. Le message d'erreur indique le problème.
Notes HubSpot avec résumé de conversation
Lorsque tu actives "Inclure le résumé", Heyloha crée automatiquement une Note sur le contact HubSpot avec un résumé de la conversation. Cela donne à ton équipe commerciale le contexte immédiat.
Journal de livraison
Chaque tentative d'envoi est enregistrée dans le journal de livraison. Le journal affiche l'horodatage, l'événement, le statut et le nombre de tentatives. Heyloha réessaie chaque envoi jusqu'à 7 fois sur environ 30 secondes.
Une brève panne de HubSpot n'entraîne pas de perte de leads grâce au système de retry automatique.
Questions fréquentes
De quel plan HubSpot ai-je besoin ?
Tu as besoin d'un plan HubSpot avec accès API et le scope crm.objects.contacts.write. Disponible sur tous les plans CRM payants et gratuits. Attention : les comptes de test développeur n'ont pas toujours ce scope. Utilise un compte CRM gratuit ou un plan payant.
Les doublons sont-ils évités ?
Oui. Heyloha utilise le point de terminaison upsert de HubSpot. Si un contact avec le même e-mail existe déjà, les données sont mises à jour.
Puis-je combiner HubSpot avec d'autres intégrations ?
Oui. Chaque agent IA peut avoir plusieurs intégrations. Tu peux par exemple envoyer simultanément vers HubSpot et ActiveCampaign.
Configurer l'intégration webhook génériqueConfigurer l'intégration ActiveCampaign