Fin pour Sales 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 AI 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 Contact (lecture) | 📤 Synchroniser Contact (écriture) |
Fin récupère le contexte en direct 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 contact depuis HubSpot (lecture) et Synchroniser les données de conversation vers le contact HubSpot (écriture).
Important : configurez Enrichir Contact et Synchroniser Contact ensemble
Le connecteur Synchroniser contact (écriture) est un upsert, basé sur l'adresse e-mail du contact. HubSpot met à jour le contact avec cette adresse e-mail, ou en crée un si aucun contact ne la possède — donc Synchroniser ne crée pas de doublons seul.
Au début d'une conversation, Fin ne connaît pas l'ID du contact HubSpot. Le connecteur Enrichir Contact (lecture) permet d'identifier une personne revenante avec 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 Sales depuis la section "Services connectés" dans Fin AI Agent > Sales > Train > Integrations.
Étape 1 : Authentifiez-vous
Connectez HubSpot via OAuth si ce n'est pas déjà fait.
Étape 2 : Choisissez un modèle
Choisissez Enrichir 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 e-mail 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'e-mail 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.
Étape 6 : Ajoutez-le à votre configuration
Connecteur lecture : ajoutez-le à l'enrichissement - il s'exécute au début de chaque conversation.
Connecteur écriture : attachez-le à un résultat de routage - il se déclenche lorsque ce résultat est atteint.
Note :
Synchroniser est un upsert : Synchroniser contact est basé sur l'e-mail. HubSpot met à jour le contact avec cette adresse e-mail, 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 personnalisées soient aussi mappées.
Dépannage
Si vous voyez… | Que faire |
“Aucun contact trouvé dans HubSpot pour l'e-mail…” lors de la création d'un connecteur | L'e-mail de test ne correspondait à aucun contact dans votre compte HubSpot. Vérifiez que l'e-mail existe comme contact, puis réessayez. |
La configuration échoue 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 obligatoires sont bien capturés pour le résultat qui utilise le connecteur écriture. |
Le connecteur a cessé de fonctionner après ~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 Sales et empêcheront la confirmation de réservation. Désactivez reCAPTCHA sur le formulaire de réunion dans HubSpot, puis réessayez la réservation. |