Fin pour les ventes peut se connecter directement à votre compte HubSpot et créer un connecteur de données fonctionnel en quelques minutes. Aucune connaissance API, aucun code, ni mappage manuel des champs requis.
Choisissez un modèle, authentifiez-vous avec HubSpot, et notre générateur IA inspecte votre instance HubSpot (y compris vos champs personnalisés) pour créer un connecteur entièrement configuré. Vérifiez les correspondances suggérées, modifiez-les si besoin, puis ajoutez-le à votre configuration. Dès lors, Fin peut intégrer le contexte des contacts en temps réel dans chaque conversation de vente et synchroniser les contacts qualifiés vers HubSpot.
Ce que vous pouvez faire :
📥 Enrichir le contact (lecture) | 📤 Synchroniser le contact (écriture) |
Fin récupère le contexte en temps réel des contacts depuis HubSpot dans vos conversations de vente. | Fin synchronise les contacts qualifiés vers HubSpot. Il s'agit d'un upsert : il met à jour le contact correspondant s'il existe, ou crée un nouveau contact sinon. |
Note : Deux modèles sont disponibles : Enrichir le contact depuis HubSpot (lecture) et Synchroniser les données de conversation vers le contact HubSpot (écriture).
Important : configurez Enrichir le contact et Synchroniser le contact ensemble
Le connecteur Synchroniser le contact (écriture) est un upsert, basé sur l'adresse email du contact. HubSpot met à jour le contact avec cet email, ou en crée un si aucun contact ne le possède — donc Synchroniser ne crée pas de doublons automatiquement.
Au début d'une conversation, Fin ne connaît pas l'ID du contact HubSpot. Le connecteur Enrichir le contact (lecture) permet d'associer une personne revenante à son enregistrement HubSpot existant (et son ID de contact).
Enrichir est ce qui rend Synchroniser utile. Sans cela, Fin écrit sur le bon contact mais n'a aucun contexte pour qualifier au départ.
Avant de commencer
Vous aurez besoin d'un compte HubSpot connecté (vous vous authentifierez via OAuth lors de la configuration).
Comment le configurer
Vous connectez HubSpot à Fin pour les ventes depuis la section "Services connectés" dans Fin AI Agent > Ventes > Formation > Intégrations.
Étape 1 : Authentifiez-vous
Connectez HubSpot via OAuth si ce n'est pas déjà fait.
Étape 2 : Choisissez un modèle
Choisissez Enrichir le contact depuis HubSpot (lecture) ou Synchroniser les données de conversation vers le contact HubSpot (écriture). Pour synchroniser les contacts, configurez les deux (voir l'encadré ci-dessus).
Étape 3 : Fournissez un email de test
Cela lance une recherche réelle dans le compte HubSpot de votre espace de travail pour que le connecteur soit construit et testé avec des données en direct. L'email doit appartenir à un contact HubSpot existant.
Étape 4 : Laissez l'IA générer le connecteur
Cela prend environ 15–30 secondes pendant que l'IA inspecte votre schéma HubSpot, exécute une requête test et assemble le connecteur.
Étape 5 : Vérifiez les correspondances de champs
Vous verrez un tableau de propriété HubSpot → attribut Intercom que vous pouvez modifier avant de confirmer. Toute propriété HubSpot ne correspondant pas à un attribut Intercom existant est automatiquement mappée à un nouvel attribut préfixé hs_ créé par l'IA pour vous.
Étape 6 : Ajoutez-le à votre configuration
Connecteur de lecture : ajoutez-le à l'enrichissement - il s'exécute au début de chaque conversation.
Connecteur d'écriture : attachez-le à un résultat de routage - il se déclenche lorsque ce résultat est atteint.
Note :
Synchroniser est un upsert : Synchroniser le contact est basé sur l'email. HubSpot met à jour le contact avec cette adresse email, ou en crée un si aucun contact ne la possède.
Rafraîchissement automatique : Les jetons d'accès HubSpot expirent périodiquement. Le connecteur se rafraîchit automatiquement, vous n'avez donc pas besoin de vous reconnecter à chaque fois.
Propriétés personnalisées incluses : Fin lit vos propriétés personnalisées HubSpot lors de la configuration, pour que vos données adaptées soient aussi mappées.
Dépannage
Si vous voyez… | Que faire |
“Aucun contact trouvé dans HubSpot pour l'email…” lors de la création d'un connecteur | L'email de test ne correspondait à aucun contact dans votre compte HubSpot. Vérifiez que l'email existe comme contact, puis réessayez. |
Échec de la configuration lors de la lecture de vos propriétés HubSpot | Généralement un problème de permissions ou de connexion. Reconnectez HubSpot dans Paramètres > Intégrations et relancez la configuration. |
Un échec de synchronisation (écriture) avec une erreur « champ requis manquant » | Votre compte HubSpot nécessite des champs qui n'ont pas été collectés dans la conversation. Assurez-vous que ces champs requis sont capturés pour le résultat qui utilise le connecteur d'écriture. |
Le connecteur a cessé de fonctionner après environ 1 heure | Généralement un problème d'authentification HubSpot. Le connecteur devrait se rafraîchir automatiquement et réessayer. Si le problème persiste, reconnectez HubSpot. |
Une réservation de réunion échoue avec une erreur générique « Quelque chose a mal tourné » juste après que le prospect confirme un créneau, même si les permissions sont accordées et les questions requises collectées | Vérifiez si le lien de réunion HubSpot a reCAPTCHA activé. Les formulaires de réunion protégés par reCAPTCHA ne sont pas pris en charge par Fin pour les ventes et feront échouer la confirmation de réservation. Désactivez reCAPTCHA sur le formulaire de réunion dans HubSpot, puis réessayez la réservation. |
Échec d'autorisation lors de la connexion à HubSpot : « L'autorisation a échoué car cette application n'a pas été approuvée pour accéder aux scopes requis [crm.schemas.contacts.read] dans votre compte. » | Cette erreur signifie que votre compte HubSpot utilise la gouvernance des applications, et que l'application Intercom a été approuvée sans l'une de ses permissions. Un Super Admin HubSpot doit corriger cela dans HubSpot, en allant dans : Paramètres > Intégrations > Applications connectées > Applications approuvées, cliquez sur Gérer l'accès à côté de Intercom Auth Only, ouvrez Permissions des données, et activez les paramètres Voir les détails sur la propriété pour les contacts. Après activation de la permission, retournez dans Fin AI Agent > Ventes > Formation > Intégrations dans Intercom et réessayez la connexion HubSpot. |