Intégrations
HubSpot et WhatsApp
Connectez HubSpot à votre numéro WhatsApp dans les deux sens :
- HubSpot → WhatsApp : quand un contact est créé ou qu'une transaction (deal) passe à une étape, envoyez à cette personne un message WhatsApp depuis votre propre numéro.
- WhatsApp → HubSpot : quand quelqu'un écrit à votre numéro WhatsApp, ajoutez le message comme note sur son contact HubSpot, et créez le contact s'il n'existe pas encore.
WbizTool n'a pas d'application HubSpot. Ces recettes relient les deux via Zapier, Make, n8n, Pabbly Connect ou un workflow HubSpot, avec des modèles prêts à l'emploi pour Make et n8n.
Qui peut le faire : dans WbizTool, un Propriétaire crée la clé API dans Paramètres → Clés API (voir Clés API) ; les Propriétaires et les Éditeurs configurent les Numéros de la boîte pour le sens WhatsApp → HubSpot. Dans HubSpot, il vous faut les droits de connecter des applications ou de modifier des workflows ; chaque méthode ci-dessous indique ce dont elle a besoin.
Avant de commencer#
- Un numéro WhatsApp connecté dans Numéros WhatsApp. Consultez Connecter votre numéro WhatsApp.
- Votre clé API, et pour certains outils votre Client ID, depuis Paramètres → Clés API, ainsi que le WhatsApp Client ID du numéro qui envoie (son ID dans Numéros WhatsApp).
- Pour WhatsApp → HubSpot uniquement : le module Unibox. Les messages entrants arrivent dans HubSpot via le webhook des numéros de la boîte, qui nécessite le module Unibox : 20 $ par mois ou 200 $ par an au prix catalogue américain pour chaque numéro de la boîte, sur un forfait payant ou à vie (pas l'essai gratuit). L'envoi de messages n'en a pas besoin.
Choisir une méthode#
| Méthode | HubSpot → WhatsApp | WhatsApp → HubSpot | Ce qu'il faut |
|---|---|---|---|
| Zapier | Déclencheur New Contact ou Updated Deal Stage, puis une action d'envoi WbizTool | Le déclencheur WbizTool Incoming WhatsApp Message, puis HubSpot Find Contact et Create Engagement | Un compte Zapier. Aucun webhook à configurer. |
| Make | HubSpot CRM Watch Contacts, puis le module HTTP | Un custom webhook Make, puis des requêtes HTTP vers l'API HubSpot | Un compte Make. Il n'y a pas d'application WbizTool sur Make : le module HTTP appelle l'API WbizTool. |
| n8n | HubSpot Trigger, puis WbizTool Send Message | Un node Webhook, puis le node HubSpot et des requêtes HTTP vers HubSpot | n8n avec le community node WbizTool. Le HubSpot Trigger nécessite un compte développeur HubSpot et une application. |
| Pabbly Connect | Un déclencheur HubSpot, puis API (Pabbly) | Webhook by Pabbly, puis des requêtes API vers HubSpot | Un compte Pabbly Connect. Cela passe par les étapes HTTP et webhook de Pabbly. |
| Workflow HubSpot | L'action Send a webhook appelle directement l'API WbizTool | Utilisez une autre méthode | Data Hub Professional ou Enterprise. Aucun autre outil nécessaire. |
Numéros de téléphone#
Les deux sens n'écrivent pas les numéros de la même façon : vérifiez ce point avant d'associer les champs.
HubSpot → WhatsApp. Associez le Phone number du contact (ou son Mobile phone number) au phone du destinataire. WbizTool supprime pour vous les espaces, tirets, points et parenthèses, donc +1 (212) 555-0120 fonctionne. Un numéro enregistré avec + ou 00 contient son indicatif du pays. Un numéro enregistré sans, comme 2125550120, a besoin de l'indicatif : remplissez Country Code dans Zapier et n8n, ou country_code dans une requête HTTP, par exemple 1 ou 91. Un numéro enregistré avec l'indicatif mais sans +, comme 12125550120, fonctionne tel quel. Consultez phone et country_code dans Envoyer un message.
WhatsApp → HubSpot. Le webhook donne l'expéditeur en chiffres internationaux sans +, dans contact.phone, par exemple 12125550120. HubSpot recherche les numéros de téléphone uniquement sur l'indicatif régional et le numéro local, sans l'indicatif du pays. Avant la recherche, retirez donc votre indicatif du pays au début : 12125550120 devient 2125550120. Les modèles le font pour un indicatif que vous définissez. Quand vous créez un contact, enregistrez le numéro sous la forme + suivi des chiffres, comme +12125550120, pour que HubSpot connaisse son pays.
Envoyer un message WhatsApp depuis HubSpot#
Avec Zapier#
Utilisez le déclencheur HubSpot dont vous avez besoin, puis une action WbizTool. Connectez WbizTool avec votre Client ID et votre clé API (voir Intégration Zapier).
Quand un contact est créé :
Déclencheur : HubSpot, New Contact
Choisissez HubSpot et le déclencheur New Contact (nouveau contact), puis connectez votre compte HubSpot.
Filter by Zapier
Continuez uniquement si le numéro de téléphone du contact existe (exists). Les contacts sans numéro feraient échouer l'étape suivante.
Action : WbizTool, Send Text-Only WhatsApp Message
Choisissez le numéro d'envoi sous WhatsApp Number. Associez Phone Number au numéro de téléphone du contact. Ne remplissez Country Code que si vos numéros HubSpot sont enregistrés sans indicatif. Rédigez le Message, par exemple
Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.Testez et publiez
Une étape réussie signifie que le message a été mis en file d'attente. WbizTool l'envoie ensuite depuis votre numéro.
Quand une transaction passe à une étape :
Déclencheur : HubSpot, Updated Deal Stage
Choisissez Updated Deal Stage (étape de transaction mise à jour) et sélectionnez le pipeline et l'étape, par exemple Closed won.
Trouvez le contact de la transaction
Une transaction ne contient pas de numéro de téléphone : c'est son contact qui l'a. Ajoutez HubSpot Get Contact avec l'ID du contact associé à la transaction. Si les données du déclencheur ne contiennent pas d'ID de contact, ajoutez d'abord HubSpot Find Associations pour obtenir les contacts de la transaction.
Filtrez, puis envoyez
Ajoutez une étape Filter by Zapier qui continue si le numéro de téléphone existe, puis Send Text-Only WhatsApp Message comme ci-dessus. Vous pouvez utiliser des champs de la transaction dans le texte, comme le nom de la transaction.
Avec Make#
Il n'y a pas d'application WbizTool sur Make. Le module HTTP de Make appelle l'API Envoyer un message. Des deux modèles Make, celui-ci utilise une connexion HubSpot dans Make (Watch Contacts) ; celui du sens WhatsApp → HubSpot n'utilise que les modules intégrés de Make et une clé de service HubSpot.
Importez le modèle ou commencez un scénario
Importez hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint dans un nouveau scénario), ou construisez-le avec les étapes ci-dessous.
HubSpot CRM, Watch Contacts
Ajoutez le module HubSpot CRM Watch Contacts et connectez HubSpot. Un Super Admin de votre compte HubSpot doit d'abord approuver l'application Make. Make demande par où commencer : choisissez From now on (à partir de maintenant) pour n'écrire qu'aux nouveaux contacts.
HTTP, Make a request
Méthode
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Ajoutez un en-têteAuthorizationavec la valeurBearer YOUR_API_KEY. Type de corps application/x-www-form-urlencoded, avec ces champs :Champ Valeur whatsapp_clientVotre WhatsApp Client ID, par exemple 678phoneLe Phone number du contact, issu du module HubSpot country_codeSeulement si vos numéros sont enregistrés sans indicatif, par exemple 1msgVotre texte, avec des champs comme le prénom insérés Ajoutez un filtre et exécutez une fois
Sur le lien entre les deux modules, ajoutez un filtre qui ne laisse passer que les contacts dont le numéro de téléphone existe. Exécutez le scénario une fois : une réponse avec
"status": 1signifie que le message a été mis en file d'attente.
Les champs de formulaire continuent de fonctionner quand une valeur associée contient des guillemets ou des sauts de ligne, ce qui peut casser un corps JSON brut. Le JSON fonctionne aussi ; consultez Champs du corps. Pour une étape de transaction dans Make, utilisez un workflow HubSpot qui envoie vers un custom webhook Make, ou la méthode Zapier ou n8n.
Avec n8n#
Le modèle hubspot-to-whatsapp.n8n.json gère les deux événements dans un seul workflow : un nouveau contact, et une transaction qui passe à une étape.
Installez le node WbizTool
Installez
n8n-nodes-wbiztoolet créez un credential WbizTool API. Consultez Intégration n8n.Créez les credentials HubSpot
Le HubSpot Trigger a besoin d'un credential HubSpot Developer API : un compte développeur HubSpot, une application avec les scopes de lecture des contacts et des transactions, et l'URL de redirection de n8n dans cette application (voir la page des credentials HubSpot de n8n). Les autres étapes HubSpot utilisent un credential HubSpot Service Key : dans HubSpot, allez dans Development → Keys → Service keys, cliquez sur Create service key et ajoutez les scopes de lecture des contacts et des transactions.
Importez le workflow
Dans n8n, importez le fichier et choisissez vos credentials dans chaque node HubSpot, HTTP Request et WbizTool.
Définissez votre étape et votre message
Dans le node Deal stage is, remplacez
closedwonpar la valeur interne de votre étape. Modifiez le texte dans les deux nodes WbizTool Send Message, et n'y remplissez Country Code que si vos numéros sont enregistrés sans indicatif.Activez
Le déclencheur enregistre alors son webhook auprès de HubSpot.
Ce que fait le workflow :
- HubSpot Trigger avec deux événements : Contact Created, et Deal Property Changed pour la propriété Deal Stage.
- Un node IF envoie les événements de contact d'un côté et les événements de transaction de l'autre.
- Pour une transaction, il vérifie la nouvelle étape, puis lit la transaction et ses contacts associés avec une HTTP Request vers HubSpot.
- HubSpot → Search Contacts lit le prénom et les numéros de téléphone du contact.
- WbizTool Send Message envoie le texte au numéro de téléphone, ou au numéro mobile si le téléphone est vide.
Avec un workflow HubSpot#
Avec Data Hub Professional ou Enterprise, un workflow peut appeler lui-même l'API WbizTool avec l'action Send a webhook. Aucun autre outil n'intervient.
Créez un workflow basé sur les contacts
Dans HubSpot, allez dans Automation → Workflows et créez un workflow sur les contacts, avec le déclencheur voulu, par exemple la création d'un contact ou le changement de sa phase du cycle de vie.
Ajoutez Send a webhook
Cliquez sur +, et sous Data ops choisissez Send a webhook. Méthode
POST, URL du webhookhttps://wbiztool.com/api/v1/send_msg/.Définissez l'authentification
Choisissez API key comme type d'authentification. Ajoutez un secret dont la valeur est
Bearer YOUR_API_KEY(avec votre clé WbizTool), réglez le nom de la clé API surAuthorizationet l'emplacement sur Request header.Personnalisez le corps de la requête
Choisissez Customize request body et ajoutez :
Clé Valeur phonePropriété : Phone number whatsapp_clientValeur fixe : votre WhatsApp Client ID, par exemple 678msgValeur fixe : votre message country_codeValeur fixe, seulement si vos numéros sont enregistrés sans indicatif Testez
Testez l'action avec un contact qui a votre propre numéro. WbizTool répond
{"status": 1, "message": "Created", "msg_id": …}quand il a mis le message en file d'attente.
- Le message ne peut pas inclure le nom du contact. Dans Customize request body, chaque clé prend soit une propriété HubSpot, soit une valeur fixe, donc
msgest un texte fixe, le même pour tous les contacts. Pour une salutation personnalisée, utilisez la méthode Zapier, Make ou n8n. - Nouvelles tentatives : HubSpot réessaie un webhook en échec pendant trois jours au maximum. Il ne réessaie pas les réponses
4xxsauf429, donc un message refusé, par exemple pourInvalid phone number, n'est pas renvoyé. Pour éviter qu'une nouvelle tentative après un délai dépassé n'envoie un message deux fois, ajoutez une cléidempotency_keyavec la propriété Record ID, si le workflow écrit à chaque contact au plus une fois par jour. Consultez Réessayer en toute sécurité. - Transactions : ces étapes utilisent un workflow basé sur les contacts, car le numéro de téléphone est sur le contact, pas sur la transaction. Pour des messages sur une étape de transaction, utilisez la méthode Zapier ou n8n.
Avec Pabbly Connect#
Pabbly Connect lance un workflow à partir d'événements HubSpot comme New Contact Added ou Deal Updated. Ajoutez ensuite API (Pabbly) → Execute API Request avec POST vers https://wbiztool.com/api/v1/send_msg/, comme dans Envoyer des messages WhatsApp depuis n'importe quel outil d'automatisation, et associez le numéro de téléphone du contact à phone.
Enregistrer les messages WhatsApp entrants dans HubSpot#
Chaque message qu'une personne envoie à votre numéro devient une note sur son contact HubSpot. Ce sens nécessite le module Unibox (20 $ par mois ou 200 $ par an au prix catalogue américain pour chaque numéro de la boîte, sur un forfait payant ou à vie), car les messages sortent de WbizTool via le webhook des numéros de la boîte.
La recette est la même dans chaque outil :
- Ignorez les discussions de groupe (
contact.is_groupvauttrue) et les contacts dont WhatsApp masque le numéro (contact.phone_hiddenvauttrue). - Retirez votre indicatif du pays au début de
contact.phone(voir Numéros de téléphone). - Recherchez les contacts HubSpot dont le Phone number ou le Mobile phone number est égal à ce numéro.
- S'il n'y en a aucun, créez un contact avec Phone number
+etcontact.phone, et First namecontact.name. - Créez une note sur le contact avec le message :
message.content, àmessage.timestamp.
Avec Zapier#
Vous ne définissez d'URL de webhook nulle part : le déclencheur WbizTool se connecte à Zapier quand vous publiez le Zap.
Déclencheur : WbizTool, Incoming WhatsApp Message
Choisissez le numéro sous WhatsApp Number. Le Zap utilise l'un de vos numéros de la boîte (voir Prérequis du déclencheur). Seuls les messages que l'on vous envoie le lancent.
Filter by Zapier
Continuez uniquement si Contact Phone Hidden est faux et Is Group est faux.
Formatter by Zapier : retirer l'indicatif du pays
Choisissez Formatter, l'événement d'action Numbers, la transformation Format Phone Number. Entrée :
+suivi de Contact Phone. Choisissez un format national sans symboles sous To Format, pour que+12125550120devienne2125550120.HubSpot, Find Contact
Recherchez par Phone Number avec la sortie du Formatter. Cochez l'option qui crée le contact s'il est introuvable, avec Phone Number
+et Contact Phone, et First Name à partir de Contact Name.HubSpot, Create Engagement
Type Note, associée à l'ID de contact de l'étape Find Contact. Corps :
WhatsApp fromContact Name : Message Content.
Avec Make#
Importez le modèle
Importez hubspot-whatsapp-to-note.make.json dans un nouveau scénario.
Ajoutez votre clé de service HubSpot
Dans HubSpot, allez dans Development → Keys → Service keys, cliquez sur Create service key et ajoutez les scopes de lecture et d'écriture des contacts. Dans chaque module HTTP du scénario, remplacez
YOUR_HUBSPOT_SERVICE_KEYdans l'en-têteAuthorizationpar cette clé.Créez le webhook
Dans le module Webhooks → Custom webhook, cliquez sur Add, donnez-lui un nom et copiez son adresse.
Ajoutez l'adresse à votre numéro de la boîte
Dans WbizTool, ouvrez Numéros de la boîte, cliquez sur Paramètres du webhook sur la carte du numéro (ou sur Ajouter un numéro à la boîte), collez l'adresse sous URL du webhook (facultatif) et cliquez sur Enregistrer. Gardez Messages reçus coché ; cochez aussi Messages envoyés si vous voulez vos réponses dans HubSpot.
Définissez votre indicatif du pays
Dans le module Search the contact by phone, le modèle retire
1au début du numéro (/^1/, deux fois). Remplacez1par votre indicatif du pays, par exemple91.Activez le scénario
Envoyez un message à votre numéro WhatsApp depuis un autre téléphone. Il arrive en une minute ou deux, et Make apprend les champs du webhook à partir de lui : vérifiez une fois les associations.
Le scénario : Custom webhook → une requête HTTP vers la recherche de contacts de HubSpot → un routeur. Quand un contact est trouvé, une requête HTTP lui ajoute la note. Sinon, une requête crée le contact et une autre ajoute la note. Les étapes JSON → Transform to JSON transforment le message et le nom en texte JSON, pour que les guillemets et les sauts de ligne ne cassent pas les requêtes.
Avec n8n#
Importez le workflow
Importez hubspot-whatsapp-to-note.n8n.json et choisissez un credential HubSpot Service Key dans les nodes HubSpot et HTTP Request. La clé a besoin des scopes de lecture et d'écriture des contacts.
Définissez votre indicatif du pays
Dans le node National number, réglez
countryCodesur le vôtre, par exemple91.Activez et copiez l'adresse
Activez le workflow et copiez la Production URL du node WbizTool webhook.
Ajoutez l'adresse à votre numéro de la boîte
Collez-la comme webhook du numéro dans Numéros de la boîte, comme dans les étapes Make ci-dessus.
Le node HubSpot de n8n n'a pas d'action pour les notes, le workflow crée donc le contact et la note avec des nodes HTTP Request qui utilisent le même credential HubSpot. Le node Webhook répond immédiatement, bien en deçà des 8 secondes que WbizTool attend.
Avec Pabbly Connect#
Commencez par Webhook by Pabbly et collez son URL comme webhook du numéro dans Numéros de la boîte. Appelez ensuite l'API HubSpot avec API (Pabbly) → Execute API Request, avec une clé de service HubSpot comme jeton Bearer : POST https://api.hubapi.com/crm/objects/2026-09/contacts/search pour trouver le contact, POST …/contacts pour en créer un, et POST …/notes pour ajouter la note (voir Les requêtes de votre serveur).
Sur votre propre serveur#
Recevez le webhook comme décrit dans Webhooks de messages entrants, vérifiez sa signature, répondez 200 immédiatement, puis faites ces appels à l'API HubSpot avec une clé de service.
Les requêtes de votre serveur
| Étape | Requête | Corps |
|---|---|---|
| Trouver le contact | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups avec phone EQ le numéro sans son indicatif du pays, et un second groupe avec mobilephone ; limit 1 |
| Le créer s'il manque | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties : phone +12125550120, firstname à partir de contact.name |
| Ajouter la note | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties : hs_timestamp à partir de message.timestamp, hs_note_body avec le texte ; associations vers le contact avec associationCategory HUBSPOT_DEFINED et associationTypeId 202 (note vers contact) |
{
"properties": {
"hs_timestamp": "2026-10-15T10:30:04+00:00",
"hs_note_body": "WhatsApp from Emma Thompson (+12125550120): Can I add a gift note to it?"
},
"associations": [
{
"to": { "id": "CONTACT_ID" },
"types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 202 }]
}
]
}
Les endpoints de recherche de HubSpot acceptent cinq requêtes par seconde et par compte. Ignorez un message.id déjà enregistré : WbizTool peut, rarement, envoyer un message deux fois.
Modèles#
| Fichier | Outil | Ce qu'il fait |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | Nouveau contact HubSpot → message WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | WhatsApp entrant → note sur le contact (nécessite le module Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Nouveau contact ou étape de transaction → message WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | WhatsApp entrant → note sur le contact (nécessite le module Unibox) |
Les modèles ne contiennent aucune clé. Après l'import, choisissez vos propres connexions ou credentials à chaque étape, et remplacez YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, le WhatsApp Client ID 678 et l'indicatif du pays par les vôtres.
Dépannage#
| Problème | Ce qu'il faut vérifier |
|---|---|
Invalid phone number | Le téléphone du contact est vide, contient des lettres, ou a moins de 6 ou plus de 17 chiffres. Ajoutez un filtre qui ignore les contacts sans numéro. |
| Le message part vers le mauvais numéro | Le numéro est enregistré sans son indicatif du pays et aucun indicatif n'a été envoyé. Remplissez Country Code ou country_code, ou enregistrez les numéros dans HubSpot avec +. |
Auth Error: invalid api key | La clé a été supprimée ou mal saisie. Dans un workflow HubSpot, la valeur du secret doit être Bearer suivi de la clé, et le nom de la clé API Authorization. |
Invalid whatsapp client | Utilisez l'ID du numéro affiché dans Numéros WhatsApp. |
| Send a webhook n'apparaît pas dans les actions du workflow | Il faut Data Hub Professional ou Enterprise. Utilisez plutôt Zapier, Make, n8n ou Pabbly Connect. |
| Make ne parvient pas à se connecter à HubSpot | Un Super Admin du compte HubSpot doit d'abord approuver l'application Make. |
| Aucune note n'apparaît dans HubSpot | Vérifiez que le numéro affiche Synchronisation dans Numéros de la boîte, que l'URL du webhook est celle de votre outil et que Messages reçus est coché. Envoyez un message depuis un autre téléphone : les réponses depuis la boîte de réception Unibox ne sont pas transmises. |
| Les webhooks n'arrivent pas, ou votre hébergeur les refuse | Votre récepteur doit répondre 2xx en moins de 8 secondes et ne doit pas rediriger. Certains pare-feu d'hébergement bloquent les clients inconnus : les webhooks de WbizTool arrivent avec le User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), autorisez-le. |
| Un nouveau contact est créé pour une personne déjà dans HubSpot | HubSpot n'a pas trouvé le numéro. Vérifiez que l'indicatif du pays retiré est le bon et que le numéro du contact se trouve dans Phone number ou Mobile phone number. Pour des clients dans plusieurs pays, consultez Numéros de téléphone. |
| Un message est enregistré deux fois | WbizTool peut, rarement, envoyer un message deux fois. Ignorez un message.id déjà enregistré. |
| Pas de note pour certains messages | Les discussions de groupe et les contacts dont WhatsApp masque le numéro sont ignorés volontairement. Les messages reçus pendant que le numéro était arrêté ne sont pas transmis. |

