Configurer l'intégration HubSpot
L'intégration HubSpot envoie les coordonnées collectees par votre agent IA directement dans votre 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 synchronise ?
Tous les champs de contact que vous sélectionnez dans Heyloha sont automatiquement envoyes vers les propriétés de contact HubSpot standard. Aucune configuration de champs personnalisés n'est nécessaire.
- Prenom 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 meme adresse e-mail existe déjà, les informations sont mises à jour au lieu de créer un doublon.
De quoi avez-vous besoin ?
- Un compte HubSpot avec acces 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
Allez dans Private Apps
Connectez-vous à HubSpot et allez dans Paramètres > Intégrations > Private Apps.
Créez une nouvelle Private App
Cliquez sur 'Create à Private App' et donnez-lui un nom reconnaissable, par exemple 'Heyloha'.
Définissez les autorisations
Allez dans l'onglet 'Scopes' et activez ces deux autorisations : crm.objects.contacts.write et crm.objects.contacts.read.
Copiez le Access Token
Apres la creation de l'app, un Access Token apparait. Copiez-le, vous en aurez besoin dans Heyloha.
Conservez le Access Token en sécurité. Ne le partagez pas avec des tiers. Dans Heyloha, le token est stocke de maniere chiffrée et n'apparait jamais dans les logs.
Configurer l'intégration dans Heyloha
Ouvrez votre agent IA
Allez dans le tableau de bord Heyloha et cliquez sur l'agent IA que vous souhaitez connecter.
Paramètres > Avance > Integrations
Cliquez sur 'Ajouter une intégration' pour créer une nouvelle connexion.
Choisissez 'HubSpot' comme plateforme
Sélectionnez HubSpot dans la liste. Le formulaire s'adapte automatiquement.
Collez le Access Token
Collez le Private App Access Token copie depuis HubSpot. Aucune URL n'est nécessaire.
Nommez l'integration
Choisissez un nom reconnaissable, par exemple 'HubSpot Lead Sync'.
Sélectionnez les champs de contact
Choisissez les données que votre agent IA doit collecter. Sélectionnez au minimum une adresse e-mail.
Choisissez les déclencheurs d'événements
Sélectionnez quand l'intégration doit se déclencher : lors de la capture de coordonnées, de la reservation d'un rendez-vous ou de l'atteinte d'un objectif.
Décrivez quand utiliser l'integration
Fournissez une instruction courte indiquant quand l'IA doit déclencher cette intégration.
Enregistrez et activez
Activez l'intégration et cliquez sur Enregistrer. N'oubliez pas de sauvegarder aussi l'agent IA.
Tester la connexion
Apres l'enregistrement, vous pouvez tester la connexion directement via le bouton 'Tester la connexion' sur la carte d'intégration. Un contact test est envoye à HubSpot.
- Vert 'Connecte' : vos identifiants sont valides et HubSpot à accepte le contact test.
- Erreur rouge : quelque chose ne va pas. Le message d'erreur indique le probleme.
Notes HubSpot avec résumé de conversation
Lorsque vous activez "Inclure le résumé", Heyloha crée automatiquement une Note sur le contact HubSpot avec un résumé de la conversation. Cela donne à votre équipe commerciale le contexte immédiat.
Journal de livraison
Chaque tentative d'envoi est enregistree 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'a 7 fois sur environ 30 secondes.
Une breve panne de HubSpot ne résulte pas en leads perdus grace au systeme de retry automatique.
Questions fréquentes
Quel plan HubSpot ai-je besoin ?
Vous avez 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. Utilisez 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 meme 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. Vous pouvez par exemple envoyer simultanement vers HubSpot et ActiveCampaign.
Configurer l'intégration webhook génériqueConfigurer l'intégration ActiveCampaign