Aller au contenu
WbizTool

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éthodeHubSpot → WhatsAppWhatsApp → HubSpotCe qu'il faut
ZapierDéclencheur New Contact ou Updated Deal Stage, puis une action d'envoi WbizToolLe déclencheur WbizTool Incoming WhatsApp Message, puis HubSpot Find Contact et Create EngagementUn compte Zapier. Aucun webhook à configurer.
MakeHubSpot CRM Watch Contacts, puis le module HTTPUn custom webhook Make, puis des requêtes HTTP vers l'API HubSpotUn compte Make. Il n'y a pas d'application WbizTool sur Make : le module HTTP appelle l'API WbizTool.
n8nHubSpot Trigger, puis WbizTool Send MessageUn node Webhook, puis le node HubSpot et des requêtes HTTP vers HubSpotn8n avec le community node WbizTool. Le HubSpot Trigger nécessite un compte développeur HubSpot et une application.
Pabbly ConnectUn déclencheur HubSpot, puis API (Pabbly)Webhook by Pabbly, puis des requêtes API vers HubSpotUn compte Pabbly Connect. Cela passe par les étapes HTTP et webhook de Pabbly.
Workflow HubSpotL'action Send a webhook appelle directement l'API WbizToolUtilisez une autre méthodeData 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éé :

  1. Déclencheur : HubSpot, New Contact

    Choisissez HubSpot et le déclencheur New Contact (nouveau contact), puis connectez votre compte HubSpot.

  2. 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.

  3. 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.

  4. 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 :

  1. 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.

  2. 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.

  3. 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.

  1. 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.

  2. 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.

  3. HTTP, Make a request

    Méthode POST, URL https://wbiztool.com/api/v1/send_msg/. Ajoutez un en-tête Authorization avec la valeur Bearer YOUR_API_KEY. Type de corps application/x-www-form-urlencoded, avec ces champs :

    ChampValeur
    whatsapp_clientVotre WhatsApp Client ID, par exemple 678
    phoneLe Phone number du contact, issu du module HubSpot
    country_codeSeulement si vos numéros sont enregistrés sans indicatif, par exemple 1
    msgVotre texte, avec des champs comme le prénom insérés
  4. 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": 1 signifie 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.

  1. Installez le node WbizTool

    Installez n8n-nodes-wbiztool et créez un credential WbizTool API. Consultez Intégration n8n.

  2. 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.

  3. Importez le workflow

    Dans n8n, importez le fichier et choisissez vos credentials dans chaque node HubSpot, HTTP Request et WbizTool.

  4. Définissez votre étape et votre message

    Dans le node Deal stage is, remplacez closedwon par 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.

  5. Activez

    Le déclencheur enregistre alors son webhook auprès de HubSpot.

Ce que fait le workflow :

  1. HubSpot Trigger avec deux événements : Contact Created, et Deal Property Changed pour la propriété Deal Stage.
  2. Un node IF envoie les événements de contact d'un côté et les événements de transaction de l'autre.
  3. Pour une transaction, il vérifie la nouvelle étape, puis lit la transaction et ses contacts associés avec une HTTP Request vers HubSpot.
  4. HubSpot → Search Contacts lit le prénom et les numéros de téléphone du contact.
  5. 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.

  1. 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.

  2. Ajoutez Send a webhook

    Cliquez sur +, et sous Data ops choisissez Send a webhook. Méthode POST, URL du webhook https://wbiztool.com/api/v1/send_msg/.

  3. 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 sur Authorization et l'emplacement sur Request header.

  4. 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 678
    msgValeur fixe : votre message
    country_codeValeur fixe, seulement si vos numéros sont enregistrés sans indicatif
  5. 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 msg est 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 4xx sauf 429, donc un message refusé, par exemple pour Invalid 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_key avec 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 :

  1. Ignorez les discussions de groupe (contact.is_group vaut true) et les contacts dont WhatsApp masque le numéro (contact.phone_hidden vaut true).
  2. Retirez votre indicatif du pays au début de contact.phone (voir Numéros de téléphone).
  3. Recherchez les contacts HubSpot dont le Phone number ou le Mobile phone number est égal à ce numéro.
  4. S'il n'y en a aucun, créez un contact avec Phone number + et contact.phone, et First name contact.name.
  5. 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.

  1. 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.

  2. Filter by Zapier

    Continuez uniquement si Contact Phone Hidden est faux et Is Group est faux.

  3. 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 +12125550120 devienne 2125550120.

  4. 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.

  5. HubSpot, Create Engagement

    Type Note, associée à l'ID de contact de l'étape Find Contact. Corps : WhatsApp from Contact Name : Message Content.

Avec Make#

  1. Importez le modèle

    Importez hubspot-whatsapp-to-note.make.json dans un nouveau scénario.

  2. 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_KEY dans l'en-tête Authorization par cette clé.

  3. Créez le webhook

    Dans le module Webhooks → Custom webhook, cliquez sur Add, donnez-lui un nom et copiez son adresse.

  4. 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.

  5. Définissez votre indicatif du pays

    Dans le module Search the contact by phone, le modèle retire 1 au début du numéro (/^1/, deux fois). Remplacez 1 par votre indicatif du pays, par exemple 91.

  6. 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#

  1. 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.

  2. Définissez votre indicatif du pays

    Dans le node National number, réglez countryCode sur le vôtre, par exemple 91.

  3. Activez et copiez l'adresse

    Activez le workflow et copiez la Production URL du node WbizTool webhook.

  4. 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

ÉtapeRequêteCorps
Trouver le contactPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups avec phone EQ le numéro sans son indicatif du pays, et un second groupe avec mobilephone ; limit 1
Le créer s'il manquePOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties : phone +12125550120, firstname à partir de contact.name
Ajouter la notePOST https://api.hubapi.com/crm/objects/2026-09/notesproperties : 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#

FichierOutilCe qu'il fait
hubspot-new-contact-to-whatsapp.make.jsonMakeNouveau contact HubSpot → message WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeWhatsApp entrant → note sur le contact (nécessite le module Unibox)
hubspot-to-whatsapp.n8n.jsonn8nNouveau contact ou étape de transaction → message WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nWhatsApp 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èmeCe qu'il faut vérifier
Invalid phone numberLe 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éroLe 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 keyLa 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 clientUtilisez l'ID du numéro affiché dans Numéros WhatsApp.
Send a webhook n'apparaît pas dans les actions du workflowIl faut Data Hub Professional ou Enterprise. Utilisez plutôt Zapier, Make, n8n ou Pabbly Connect.
Make ne parvient pas à se connecter à HubSpotUn Super Admin du compte HubSpot doit d'abord approuver l'application Make.
Aucune note n'apparaît dans HubSpotVé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 refuseVotre 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 HubSpotHubSpot 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 foisWbizTool peut, rarement, envoyer un message deux fois. Ignorez un message.id déjà enregistré.
Pas de note pour certains messagesLes 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.

Voir aussi#