# Intégration HubSpot : l'agent Nodale synchronise vos leads Bastien Izzo, CEO · Publié le 4 novembre 2026 > **En bref.** Connectez HubSpot depuis la page des intégrations de votre espace de travail Nodale. Après chaque conversation, Nodale retrouve ou crée le contact et son entreprise, remplit les propriétés HubSpot que vous avez associées dans le sens de synchronisation choisi, et ajoute une note au contact, à son entreprise et à ses transactions ouvertes. Nodale est un agent IA qui transforme l'inbound en leads chauds : les visiteurs des sites B2B obtiennent des réponses et une démo en direct, 24/7 et dans plus de 50 langues, et partagent leur intention, leur cas d'usage et leur budget, pour que les entreprises convertissent davantage le trafic qu'elles paient déjà. Cette page s'adresse à l'admin d'un espace de travail Nodale qui connecte HubSpot. Elle décrit ce que Nodale demande à HubSpot, ce qu'il y écrit et ce qu'il y relit. ## Installer l'intégration Il vous faut être **admin de votre espace de travail Nodale**, et utilisateur HubSpot autorisé à installer des applications dans votre portail. Les autres membres de l'espace voient la connexion, sans pouvoir la modifier. 1. Dans Nodale, ouvrez **Settings**, puis **Workspace**, puis **Integrations**, et choisissez la carte **HubSpot**. 2. Cliquez sur **Connect HubSpot**. HubSpot ouvre sa page de consentement. 3. Choisissez le portail à connecter, lisez les scopes (listés plus bas) et acceptez-les. 4. HubSpot vous renvoie vers Nodale, qui affiche : « HubSpot is connected. Your portal is shown below. » La carte de connexion indique ensuite le portail, la date de connexion et la dernière synchronisation. Un espace de travail Nodale se connecte à un seul portail HubSpot. À la connexion, Nodale ajoute à votre portail une propriété d'entreprise masquée, **Nodale record ID** (`nodale_external_id`), dans un groupe de propriétés nommé **Nodale**. Elle permet à Nodale de retrouver les entreprises qu'il a créées. ## Les scopes que Nodale demande HubSpot affiche ces scopes sur sa page de consentement. Tous sont obligatoires. | Scope | Ce que Nodale en fait | |---|---| | `oauth` | Identifie le portail que vous avez connecté. | | `crm.objects.contacts.read` | Retrouve un contact par son email et lit les propriétés que vous avez associées. | | `crm.objects.contacts.write` | Crée et met à jour les contacts, et associe un contact à son entreprise. | | `crm.objects.companies.read` | Retrouve une entreprise par son domaine ou par son lien avec le contact, et lit ses propriétés associées. | | `crm.objects.companies.write` | Crée et met à jour les entreprises. | | `crm.objects.deals.read` | Liste vos pipelines de transactions et retrouve les transactions ouvertes du contact, pour y joindre la note. | | `crm.objects.deals.write` | Demandé avec les scopes CRM. Nodale ne crée ni ne modifie aucune transaction. | | `crm.schemas.contacts.read` | Liste les propriétés de contact que vous pouvez associer. | | `crm.schemas.contacts.write` | Crée une propriété de contact quand vous en demandez une depuis Nodale. | | `crm.schemas.companies.read` | Liste les propriétés d'entreprise que vous pouvez associer. | | `crm.schemas.companies.write` | Crée une propriété d'entreprise quand vous en demandez une, ainsi que la propriété Nodale record ID. | | `crm.schemas.deals.read` | Demandé avec les scopes CRM. Nodale n'associe aucune propriété de transaction. | | `crm.schemas.deals.write` | Demandé avec les scopes CRM. Nodale ne crée aucune propriété de transaction. | | `scheduler.meetings.meeting-link.read` | Lit vos liens de prise de rendez-vous HubSpot, pour que l'agent y réserve des rendez-vous (voir plus bas). | ## Contacts et entreprises ### Quand Nodale lit et écrit dans HubSpot - **Dès que le visiteur donne un email**, Nodale lit le contact et son entreprise dans HubSpot, pour que l'agent sache ce que votre CRM sait déjà de lui. La lecture n'écrit jamais rien dans HubSpot. - **Après chaque conversation**, une fois son résumé rédigé, Nodale envoie le lead à HubSpot. Un lead part dès qu'il a un email, qu'il soit qualifié ou non. - Les leads antérieurs à la connexion ne sont pas envoyés. ### Comment Nodale retrouve le contact et l'entreprise - **Le contact** : celui que Nodale a déjà associé, sinon celui qui a le même **email**, sinon Nodale le crée. Un contact archivé n'est pas touché. - **L'entreprise** : l'entreprise principale du contact dans HubSpot, sinon celle que Nodale a déjà associée, sinon l'entreprise qui a le même **domaine**, sinon Nodale la crée avec ce domaine et y associe le contact. Aucune entreprise n'est recherchée pour une adresse email personnelle (Gmail, par exemple). ### Associer les champs Ouvrez l'onglet **Mapping** de la page HubSpot. Chaque ligne envoie un champ Nodale vers une propriété HubSpot. ![L'onglet Mapping de l'intégration HubSpot dans Nodale](https://nodale.ai/assets/integrations/hubspot/mapping.webp) - **Always sent here** : l'email va dans la propriété `email` du contact, le domaine de l'entreprise dans la propriété `domain` de l'entreprise. Ils remplissent la propriété quand elle est vide. - **Identity** : prénom, nom, intitulé de poste. - **Context** : UTM source, UTM medium, UTM campaign et site référent, issus de la première visite du lead. - **Qualification** : les éléments du cadre de qualification de votre agent. - **Custom** : les champs personnalisés de votre espace de travail, sur le contact ou sur l'entreprise. La première fois, Nodale propose une correspondance : les champs d'identité et de contexte associés aux propriétés HubSpot du même nom. Validez-la, ou partez de zéro. Les modifications restent en brouillon jusqu'à ce que vous cliquiez sur **Validate**. Retirer une correspondance ne supprime ni champ Nodale ni propriété HubSpot. Un champ en erreur n'est pas envoyé tant que vous ne l'avez pas corrigé ; tout le reste continue de se synchroniser. **Créer une propriété HubSpot.** Pour un champ sans propriété, choisissez **Create a HubSpot property** : à la validation, Nodale l'ajoute dans HubSpot, dans le groupe **Nodale** (sous le nom `nodale_...`), et y envoie le champ. **Importer des propriétés HubSpot.** **Add HubSpot properties to Nodale** transforme les propriétés HubSpot que vous cochez en champs Nodale, associés à elles. Une liste déroulante devient un champ à choix, une case à cocher un champ oui/non, tout le reste du texte. **Faire correspondre les valeurs.** Un champ à choix envoyé vers une liste déroulante demande que chacune de ses valeurs corresponde à une option HubSpot. Il n'est pas envoyé tant que chaque valeur n'en a pas une. ### Choisir le sens de synchronisation Chaque champ associé a un sens de synchronisation. Par défaut : **Bi-sync on create, HubSpot priority on update**. Une valeur Nodale vide n'efface jamais HubSpot. ![Le menu du sens de synchronisation d'un champ associé dans Nodale](https://nodale.ai/assets/integrations/hubspot/sync-direction.webp) | Sens de synchronisation | Premier envoi du lead | Envois suivants | Les deux ont une valeur | |---|---|---|---| | **Bi-sync** | Chaque côté remplit la valeur vide de l'autre ; une valeur HubSpot renseignée l'emporte | Le côté modifié depuis la dernière synchronisation se propage | Premier envoi : HubSpot l'emporte. Ensuite, le côté modifié depuis la dernière synchronisation ; HubSpot si les deux ont changé | | **Bi-sync on create, HubSpot priority on update** (par défaut) | Chaque côté remplit la valeur vide de l'autre | HubSpot l'emporte s'il a une valeur, sinon Nodale la remplit | Chacun garde la sienne au premier envoi, puis HubSpot l'emporte | | **HubSpot priority** | La valeur HubSpot remonte dans Nodale ; Nodale n'écrit jamais | Idem | HubSpot l'emporte | | **Nodale priority** | Nodale écrit, même par-dessus une valeur | Idem ; rien ne remonte | Nodale l'emporte | | **Deactivate sync** | Rien ne circule | Rien ne circule | Chacun garde la sienne | Par exemple, HubSpot a « Marketing Manager » comme intitulé de poste, et le visiteur dit à l'agent « Head of Growth ». Par défaut, HubSpot garde « Marketing Manager ». Avec Nodale priority, HubSpot reçoit « Head of Growth ». HubSpot ne renvoie des valeurs vers Nodale que pour le prénom, le nom, l'intitulé de poste et les champs de qualification. Une propriété HubSpot en lecture seule ne peut être qu'en HubSpot priority ou désactivée. ## La note de chaque conversation Chaque conversation devient **une note** dans HubSpot, associée au contact, à son entreprise et aux transactions ouvertes du contact. Elle est écrite une fois et jamais mise à jour. Sa date est celle du début de la conversation. Choisissez ce qu'elle contient dans l'onglet **Note**. Dans l'ordre : | Bloc | Ce qu'il contient | Désactivable | |---|---|---| | Summary | Ce pour quoi le visiteur est venu et le déroulé de la conversation. | Non | | Next step | Ce que l'agent recommande de faire ensuite. | Oui | | Qualification criteria | Les valeurs recueillies au regard de vos critères. | Oui | | Qualification framework | Une ligne courte par pilier de votre cadre (MEDDIC par défaut ; SPICED, BANT, CHAMP ou NEAT), rédigée à partir de la conversation. Absent quand vous qualifiez avec votre propre liste. | Oui | | Demos shown | Les démos qui ont été jouées. | Oui | | Pages visited | Les pages vues avant et pendant la conversation. | Oui | | Open the lead in Nodale | Un lien vers le lead. | Non | | Full transcript | Toute la conversation, en lignes qui commencent par « Visitor: » ou « Agent: ». | Oui | Tous les blocs sont activés par défaut. Une note reste sous la limite de taille de HubSpot : la transcription est d'abord raccourcie (« Transcript shortened, the full conversation is in Nodale. »), puis les derniers blocs sont retirés. Le résumé et le lien restent toujours. Une fois que le contenu d'une conversation n'est plus conservé, sa note part sans la transcription. ## Transactions Nodale **ne crée aucune transaction et n'en modifie aucune** : ni montant, ni étape, ni propriété de transaction. Il joint la note de chaque conversation aux **transactions ouvertes** du contact : les transactions du contact dans votre pipeline par défaut (ou, s'il n'a pas d'étape ouverte, dans le premier pipeline qui en a une) dont l'étape n'est pas fermée. Un contact que Nodale vient de créer n'a pas encore de transaction : sa première note va donc au contact et à l'entreprise seulement. ## Réserver des rendez-vous avec HubSpot Meetings L'agent peut réserver des rendez-vous dans vos liens de prise de rendez-vous HubSpot, pendant la conversation. Il passe par la même connexion HubSpot : il n'y a rien d'autre à installer. Un portail connecté avant l'arrivée de cette fonction affiche **To reconnect** sur ses outcomes de prise de rendez-vous : reconnectez HubSpot une fois pour accorder le scope des liens de rendez-vous. 1. Dans Nodale, ouvrez **Agents**, puis l'onglet **Outcomes**, et créez un **New outcome** de type **Meeting booking**. 2. Choisissez un **Meeting type**. Chaque lien de rendez-vous HubSpot, personnel ou d'équipe, est listé une fois par durée, par exemple « HubSpot Meetings · Intro call · 30 min ». 3. Reliez chaque **question obligatoire** du lien de rendez-vous à un élément que l'agent recueille. Le nom et l'email sont remplis automatiquement. Une question de téléphone n'est pas prise en charge : rendez-la facultative dans HubSpot. Quand le visiteur a donné un email professionnel et que le moment s'y prête, l'agent lui propose des créneaux dans son fuseau horaire et sa langue, et réserve celui qu'il choisit. HubSpot crée le rendez-vous avec le nom, l'email, le fuseau horaire et les réponses du visiteur, selon les règles du lien (horaires, délai de prévenance, disponibilités de l'équipe). Si le créneau a été pris entre-temps, l'agent en propose d'autres. ![Les créneaux que l'agent propose au visiteur dans la conversation](https://nodale.ai/assets/integrations/hubspot/booking.webp) Nodale n'annule ni ne déplace de rendez-vous : cela se fait dans HubSpot. ## Données et déconnexion - Nodale n'écrit que les propriétés que vous avez associées, la note et la propriété d'entreprise Nodale record ID. - La déconnexion ne supprime rien dans HubSpot. Effacer un lead dans Nodale ne supprime rien dans HubSpot non plus. - Des questions : support@nodale.ai. ## Dépannage | Message dans Nodale | Ce qui s'est passé | |---|---| | HubSpot was not connected: access was refused on the HubSpot page. | La page de consentement a été fermée ou refusée. | | The HubSpot connection link expired or was already used. Start again from this page. | Le lien est valable dix minutes, une seule fois. Cliquez de nouveau sur Connect HubSpot. | | HubSpot did not answer. Please try again in a few minutes. | HubSpot était indisponible. | | HubSpot refused the connection. Please try again, or contact support if it keeps happening. | HubSpot a rejeté la demande. | | Couldn't connect HubSpot. Please try again. | Tout autre échec. |