Fin for Sales peut se connecter directement à votre compte HubSpot et créer un connecteur de données opérationnel pour vous en quelques minutes. Aucun savoir API, code ou mappage manuel des champs n'est 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é. Passez en revue les mappages suggérés, modifiez ce que vous voulez et ajoutez-le à votre configuration. Dès lors, Fin peut extraire le contexte de contact en direct dans chaque conversation commerciale et synchroniser les contacts qualifiés vers HubSpot.
Ce que vous pouvez faire :
📥 Enrich Contact(read) | 📤 Sync Contact (write) |
Fin extrait le contexte de contact en direct depuis HubSpot dans vos conversations commerciales. | Fin synchronise les contacts qualifiés vers HubSpot. Il s'agit d'un upsert |
Note : Deux modèles sont disponibles : Enrich contact from HubSpot (read) et Sync conversation data to HubSpot contact (write).
Important : configurez Enrich Contact et Sync Contact ensemble
Le connecteur Sync contact (write) est un upsert, indexé 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 Sync ne créera pas de doublons à lui seul.
Au début d'une conversation, Fin ne connaît pas l'ID de contact HubSpot. Le connecteur Enrich Contact (read) est ce qui résout une personne revenante vers son enregistrement HubSpot existant (et son ID de contact).
Enrich est ce qui rend Sync utile. Sans lui, Fin écrit au bon contact mais n'a aucun contexte sur lequel qualifier en premier lieu.
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 for Sales depuis la section « Connected services » dans Fin AI Agent > Sales > Train > Integrations.
Étape 1 : Authentifier
Connectez HubSpot via OAuth si vous ne l'avez pas déjà fait.
Étape 2 : Choisir un modèle
Choisissez Enrich contact from HubSpot (read) ou Sync conversation data to HubSpot contact (write). Pour synchroniser les contacts en retour, configurez les deux (voir l'encadré ci‑dessus).
Étape 3 : Fournir un e‑mail de test
Cela exécute une recherche réelle contre le compte HubSpot de votre espace de travail afin que le connecteur puisse être construit et testé sur des données en direct. L'e‑mail doit appartenir à un contact HubSpot existant.
Étape 4 : Laisser 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 de test et assemble le connecteur.
Étape 5 : Passer en revue les mappages de champs
Vous verrez un tableau de propriété HubSpot → attribut Intercom que vous pouvez modifier avant de confirmer. Toute propriété HubSpot qui ne correspond pas à un attribut Intercom existant est automatiquement mappée à un nouvel attribut préfixé hs_ que l'IA crée pour vous.
Étape 6 : Ajoutez‑le à votre configuration
Read connector: ajoutez‑le à enrichment - il s'exécute au début de chaque conversation.
Write connector: attachez‑le à un routing outcome - il se déclenche lorsque ce résultat est atteint.
Note :
Sync is an upsert: Sync contact is keyed on email. HubSpot updates the contact with that email address, or creates one if no contact has it.
Auto-refresh: HubSpot access tokens expire periodically. The connector refreshes automatically, so you don't need to reconnect each time.
Custom properties included: Fin reads your HubSpot custom properties during setup, so your tailored data can be mapped too.
Dépannage
If you see… | What to do |
“No contacts found in HubSpot for email…” when creating a connector | The test email didn't match a contact in your HubSpot account. Check the email exists as a contact, then try again. |
Setup fails while reading your HubSpot properties | Usually a permissions or connection issue. Reconnect HubSpot in Settings > Integrations and run setup again. |
A sync (write) fails with a "required field missing" error | Your HubSpot account requires fields that weren't collected in the conversation. Make sure those required fields are being captured for the outcome that has the write connector. |
Connector stopped working after ~1 hour | Usually a HubSpot auth issue. The connector should auto-refresh and retry. If it persists, reconnect HubSpot. |
Still stuck? Reach out to our team and we'll help you get set up.