Intégrations
Pipedrive et WhatsApp
Connectez Pipedrive au numéro WhatsApp que vous avez relié à WbizTool. Écrivez à une personne quand son affaire (deal) passe à une étape, et enregistrez en notes dans Pipedrive les messages WhatsApp qu'elle vous envoie.
WbizTool n'a pas d'application Pipedrive. Vous reliez les deux avec un outil que vous utilisez peut-être déjà : les Automatisations de Pipedrive, Zapier, Make, n8n ou Pabbly Connect. Cette page présente chaque méthode étape par étape, avec des modèles prêts à l'emploi pour Make et n8n.
Qui peut le faire : toute personne disposant d'une clé API WbizTool peut envoyer des messages. L'enregistrement des messages entrants 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) et un Propriétaire ou un Éditeur pour configurer le webhook. Dans Pipedrive, il vous faut les droits que demande votre méthode (voir Choisir une méthode).
Ce que vous pouvez faire#
| Sens | Exemple | Ce qu'il faut dans WbizTool |
|---|---|---|
| Pipedrive → WhatsApp | Une affaire passe à Proposal sent : la personne reçoit « Bonjour Emma, votre proposition est dans votre boîte mail. » Une nouvelle personne est ajoutée : elle reçoit un message de bienvenue. | Une clé API et un numéro WhatsApp connecté. |
| WhatsApp → Pipedrive | Un client écrit à votre numéro WhatsApp : le message est ajouté comme note sur la personne qui a ce numéro de téléphone, et la personne est créée si Pipedrive ne l'a pas encore. | Le module Unibox, et le numéro ajouté dans Numéros de la boîte. |
Les messages partent de votre propre numéro WhatsApp, les règles de WhatsApp s'appliquent donc : écrivez à des personnes qui s'attendent à avoir de vos nouvelles, comme vos prospects et vos clients.
Avant de commencer#
- Un numéro WhatsApp connecté dans les paramètres WhatsApp, et son WhatsApp Client ID sur la même page.
- Votre Client ID et une clé API depuis Paramètres → Clés API. Créez une clé réservée à Pipedrive, pour pouvoir la supprimer séparément plus tard. Consultez Clés API.
- Des numéros de téléphone avec leur indicatif du pays dans Pipedrive, par exemple
+44 20 7946 0018. Consultez Numéros de téléphone. - Pour les messages entrants : le module Unibox avec un numéro de boîte libre. Consultez Numéros de la boîte et webhooks de messages entrants.
Choisir une méthode#
| Méthode | Pipedrive → WhatsApp | WhatsApp → Pipedrive | Forfait et droits Pipedrive |
|---|---|---|---|
| Automatisations Pipedrive | Oui, sans autre outil : l'action webhook de l'automatisation appelle l'API WbizTool. | Non | Les Automatisations et leur action webhook sont disponibles à partir du forfait Growth. Seuls les administrateurs globaux créent le webhook automatisé. |
| Zapier | Oui, avec les actions de l'application WbizTool. | Oui, avec le déclencheur WbizTool Incoming WhatsApp Message. | Tout forfait avec accès à Zapier. |
| Make | Oui, avec le module HTTP de Make. Blueprint ci-dessous. | Oui, avec un webhook Make. Blueprint ci-dessous. | Tout forfait. Les blueprints utilisent les webhooks de Pipedrive (tous les forfaits) et un jeton d'API Pipedrive. |
| n8n | Oui, avec le Pipedrive Trigger et le node WbizTool. Workflow ci-dessous. | Oui, avec un node Webhook et le node Pipedrive. Workflow ci-dessous. | Tout forfait. n8n a besoin d'un jeton d'API Pipedrive. |
| Pabbly Connect | Oui, avec son action de requête API (Pabbly). | Oui, avec son déclencheur webhook. | Tout forfait. |
Les Webhooks de Pipedrive (tous les forfaits) envoient un corps fixe que l'API WbizTool ne sait pas lire, ils n'appellent donc pas WbizTool directement. Ils lancent plutôt un workflow Make, n8n ou Pabbly, comme dans la recette Make.
Numéros de téléphone#
Les deux côtés n'écrivent pas les numéros de la même façon. Gardez ces règles en tête quand vous associez les champs :
- Pour envoyer, passez le téléphone Pipedrive tel quel. L'API d'envoi de messages supprime les espaces, tirets, points, parenthèses et le
+. Un numéro écrit avec+, comme+44 20 7946 0018, garde son propre indicatif du pays. Un numéro local, comme020 7946 0018, a besoin decountry_code(ici44), sinon il part vers le mauvais numéro ou échoue. - Les messages entrants ne donnent que des chiffres. Dans le webhook,
contact.phoneest le numéro sans+, par exemple442079460018. Recherchez dans Pipedrive avec ces chiffres, et ajoutez un+devant quand vous créez une personne. - Pipedrive garde les téléphones tels qu'ils ont été saisis. Sa recherche trouve une personne d'après les chiffres de son numéro, mais un numéro enregistré sans indicatif du pays peut être manqué. Enregistrez les numéros avec l'indicatif.
- Numéros masqués et groupes. WhatsApp masque parfois le numéro d'un expéditeur :
contact.phoneest alors vide etcontact.phone_hiddenvauttrue. Les discussions de groupe ontcontact.is_groupàtrue. Les recettes ci-dessous ignorent les deux.
Automatisations Pipedrive#
Les Automatisations de Pipedrive peuvent envoyer une requête webhook comme action. Dirigez-la vers l'API d'envoi de messages de WbizTool et l'automatisation envoie elle-même le message WhatsApp, sans autre outil.
Dans Pipedrive : un forfait Growth ou supérieur. Seuls les administrateurs globaux peuvent créer le webhook automatisé ; créer l'automatisation demande les droits d'utiliser les Automatisations.
Créez le webhook automatisé
Dans Pipedrive, ouvrez le menu du compte et allez dans Tools and apps → Webhooks. Cliquez sur + Webhooks et choisissez Automated webhook. Nommez-le « WbizTool » et saisissez
https://wbiztool.com/api/v1/comme URL de l'endpoint. L'URL doit se terminer par/, car l'automatisation ajoute le chemin. Laissez l'authentification vide : les identifiants WbizTool vont dans le corps.Créez l'automatisation
Ouvrez le menu du compte en haut à droite, allez dans Tools and apps → Automations et cliquez sur + Automation. Sélectionnez Event trigger, choisissez deal comme élément et réglez l'événement déclencheur sur Updated. Sélectionnez l'étape de l'affaire comme champ à surveiller et cliquez sur Apply trigger. Ajoutez ensuite une condition sur le nom de l'étape de l'affaire, pour que l'automatisation ne s'exécute que lorsqu'une affaire passe à cette étape.
Pour un message de bienvenue, choisissez plutôt person comme élément et l'événement Added.
Ajoutez l'action webhook
Ajoutez l'action webhook et choisissez le webhook « WbizTool ». Réglez la méthode sur POST et ajoutez le chemin
send_msg/.Remplissez le corps
Choisissez le corps Key-value et ajoutez les champs ci-dessous. Utilisez le bouton des champs pour insérer le téléphone et le nom de la personne.
Clé Valeur client_idVotre Client ID. api_keyVotre clé API. whatsapp_clientLe WhatsApp Client ID du numéro qui envoie. phoneLe téléphone de la personne de contact, via le bouton des champs. country_codeSeulement si vos numéros Pipedrive sont locaux, sans indicatif du pays : l'indicatif téléphonique, par exemple 44.msgVotre message, par exemple Hi [person's first name], your proposal is in your inbox. Reply here if you have questions.Vous pouvez aussi choisir Raw et écrire les mêmes champs en JSON. Avec Key-value, vous n'avez pas à vous soucier des guillemets dans les noms.
Testez
Enregistrez l'automatisation, activez-la et faites passer une affaire de test à l'étape. Ouvrez Automations → History puis l'exécution : elle montre le corps envoyé. WbizTool répond
"status": 1quand le message est mis en file d'attente ; une erreur reçoit une réponse HTTP400avec unmessage, commeInvalid phone number.
Zapier#
Utilisez l'application WbizTool sur Zapier avec l'application Pipedrive de Zapier.
Une affaire change d'étape : envoyer un message WhatsApp#
Déclencheur : Pipedrive Updated Deal Stage
Choisissez Pipedrive et le déclencheur Updated Deal Stage (étape de l'affaire mise à jour). Pour un message de bienvenue, utilisez plutôt New Person.
Filtre : seulement votre étape
Ajoutez Filter by Zapier et continuez uniquement si l'étape de l'affaire est celle que vous voulez. Le déclencheur s'exécute à chaque changement d'étape.
Trouvez le téléphone de la personne
Si les données du déclencheur ne contiennent pas de téléphone pour la personne de l'affaire, ajoutez la recherche Pipedrive Get Person avec l'ID de la personne de l'affaire.
Action : WbizTool Send Text-Only WhatsApp Message
Choisissez votre numéro d'envoi sous WhatsApp Number. Associez le téléphone de la personne à Phone Number, ne remplissez Country Code que si vos numéros Pipedrive sont locaux, et rédigez le Message avec le nom de la personne.
Testez et publiez
Une étape réussie signifie que le message a été mis en file d'attente. Si WbizTool ne peut pas l'accepter, l'étape échoue avec la raison, par exemple
WbizTool: Invalid phone number.
Un message WhatsApp arrive : ajouter une note dans Pipedrive#
Nécessite le module Unibox. Consultez Prérequis du déclencheur.
Déclencheur : WbizTool Incoming WhatsApp Message
Choisissez le numéro sous WhatsApp Number. Quand vous publiez le Zap, WbizTool ajoute le numéro à la boîte de réception et transmet ses messages reçus à Zapier.
Filtre : des personnes, pas des groupes
Ajoutez Filter by Zapier : continuez uniquement si Is Group est faux et Contact Phone Hidden est faux.
Trouvez ou créez la personne
Ajoutez Find or Create Person de Pipedrive : il recherche les personnes sur un champ (choisissez le champ du téléphone, avec Contact Phone) et crée une personne si aucune n'est trouvée. Pour une nouvelle personne, réglez le nom sur Contact Name et le téléphone sur
+suivi de Contact Phone.Créez la note
Ajoutez Create Note de Pipedrive. Liez-la à la personne de l'étape précédente et rédigez le contenu, par exemple :
WhatsApp from Contact Name: Message Content, avec Message Time si vous voulez l'heure.
Make#
Il n'y a pas d'application WbizTool sur Make. Les deux blueprints utilisent les modules Webhooks, HTTP et JSON de Make : le module HTTP appelle l'API WbizTool et l'API de Pipedrive.
| Blueprint | Ce qu'il fait |
|---|---|
| pipedrive-deal-stage-to-whatsapp.blueprint.json | Webhook de Pipedrive (une affaire a changé) → filtre sur votre étape → récupération de la personne de l'affaire → envoi d'un message WhatsApp à cette personne. |
| whatsapp-to-pipedrive-note.blueprint.json | Webhook de message entrant de WbizTool → recherche de la personne par téléphone → ajout d'une note, en créant d'abord la personne si besoin. |
Les blueprints reposent sur les modules génériques de Make : ils fonctionnent donc sur tous les forfaits Make et ne demandent aucune connexion Pipedrive dans Make.
Il vous faut votre jeton d'API Pipedrive (dans Pipedrive, Settings → Personal preferences → API) et l'adresse Pipedrive de votre entreprise, par exemple yourcompany.pipedrive.com.
Une affaire change d'étape : envoyer un message WhatsApp#
Importez le blueprint
Créez un scénario dans Make, cliquez sur les trois points de la barre inférieure, choisissez Import Blueprint et sélectionnez le fichier.
Créez le webhook
Ouvrez le premier module (Webhooks → Custom webhook), cliquez sur Add, enregistrez et copiez l'adresse que Make affiche.
Remplissez les espaces réservés
- Dans le filtre après le webhook, remplacez
YOUR_STAGE_IDpar l'ID de votre étape. Pour le trouver, faites passer une fois une affaire de test à cette étape et lisezdata.stage_iddans la sortie du webhook. - Dans le module Get the person, remplacez
YOUR_COMPANYetYOUR_PIPEDRIVE_API_TOKEN. - Dans le module Send WhatsApp, remplacez
YOUR_WBIZTOOL_API_KEYdans l'en-têteAuthorization,YOUR_WHATSAPP_CLIENT_IDdans le corps, ainsi que le texte du message.
- Dans le filtre après le webhook, remplacez
Dirigez le webhook de Pipedrive vers Make
Dans Pipedrive, allez dans Settings → Tools and apps → Webhooks et créez un webhook : event action change (updated dans les anciennes versions), event object deal, et l'adresse Make comme URL de l'endpoint.
Activez-le
Activez le scénario et faites passer une affaire de test à l'étape. La sortie du module HTTP montre la réponse de WbizTool :
"status": 1signifie que le message a été mis en file d'attente.
Pour le construire plutôt avec les modules Pipedrive de Make, utilisez Watch New Events (ou un Custom webhook comme ci-dessus), Get a Person, et le module HTTP avec la même requête que le module Send WhatsApp du blueprint. Les modules Pipedrive de Make ne renvoient la personne d'une affaire que sous forme d'ID, il vous faut donc Get a Person pour obtenir le téléphone.
Un message WhatsApp arrive : ajouter une note dans Pipedrive#
Importez le blueprint
Importez
whatsapp-to-pipedrive-note.blueprint.jsondans un nouveau scénario.Créez le webhook
Ouvrez Webhooks → Custom webhook, cliquez sur Add, enregistrez et copiez l'adresse.
Remplissez les espaces réservés
Remplacez
YOUR_COMPANYetYOUR_PIPEDRIVE_API_TOKENdans les quatre modules HTTP Pipedrive (recherche, création de la personne et les deux notes).Ajoutez l'adresse dans WbizTool
Dans Numéros de la boîte, ajoutez votre numéro à la boîte de réception, ou ouvrez Paramètres du webhook sur sa carte. Collez l'adresse Make sous URL du webhook, gardez seulement Messages reçus coché et enregistrez.
Activez et testez
Activez le scénario et envoyez un message à votre numéro WhatsApp depuis un autre téléphone. En une minute ou deux, la note apparaît sur la personne dans Pipedrive.
Le blueprint ignore les discussions de groupe, les numéros masqués et les messages envoyés. Pour le construire plutôt avec les modules Pipedrive de Make, utilisez Search Persons sur le champ du téléphone, un routeur, Create a Person et Create a Note.
n8n#
Utilisez les nodes Pipedrive Trigger et Pipedrive de n8n avec le community node WbizTool (n8n-nodes-wbiztool). Installez d'abord le community node.
| Workflow | Ce qu'il fait |
|---|---|
| pipedrive-deal-stage-to-whatsapp.n8n.json | Pipedrive Trigger (affaire modifiée) → If l'affaire est passée à votre étape → Pipedrive Get person → WbizTool Send Message. |
| whatsapp-to-pipedrive-note.n8n.json | Webhook (message entrant de WbizTool) → If c'est le message d'une personne → Pipedrive Search person par téléphone → Create une note, en créant d'abord la personne si aucune n'est trouvée. |
Importez le workflow
Dans n8n, créez un workflow, ouvrez le menu ⋯ et choisissez Import from File. Vous pouvez aussi coller le contenu du fichier sur le canevas.
Ajoutez les credentials
Ouvrez chaque node Pipedrive et créez un credential Pipedrive API avec votre jeton d'API Pipedrive (Settings → Personal preferences → API dans Pipedrive). Ouvrez le node WbizTool Send Message et choisissez votre credential WbizTool API (Client ID, clé API et le WhatsApp Client ID qui envoie).
Définissez votre étape et votre message
Dans le premier workflow, remplacez
YOUR_STAGE_IDdans le node If par l'ID de votre étape (faites passer une affaire de test à l'étape et lisezdata.stage_iddans la sortie du déclencheur), et modifiez le Message Text. Laissez Country Code vide si vos numéros Pipedrive contiennent l'indicatif du pays.Activez
Activez le workflow. Le Pipedrive Trigger crée lui-même son webhook dans Pipedrive.
Pour le second workflow, copiez la Production URL du node Webhook et collez-la sous URL du webhook dans Numéros de la boîte, avec seulement Messages reçus coché.
Les nodes Pipedrive de ces fichiers sont la version 2 du node Pipedrive de n8n. Si votre n8n est plus ancien et les affiche comme inconnus, mettez n8n à jour ou remplacez-les par le node Pipedrive de votre version, avec les mêmes réglages.
Pabbly Connect#
Il n'y a pas d'application WbizTool sur Pabbly Connect : utilisez ses modules généraux.
- Pipedrive → WhatsApp : lancez le workflow avec le déclencheur Pipedrive de Pabbly, ou avec son déclencheur webhook alimenté par un webhook Pipedrive. Ajoutez ensuite API (Pabbly) avec Execute API Request vers
https://wbiztool.com/api/v1/send_msg/, configuré comme dans Pabbly Connect, et associez le téléphone et le nom de la personne. - WhatsApp → Pipedrive : commencez par le déclencheur webhook de Pabbly, collez son adresse sous URL du webhook dans Numéros de la boîte, et envoyez un message de test à votre numéro pour que Pabbly voie les champs. Ajoutez ensuite les étapes Pipedrive de Pabbly : trouvez la personne par
contact.phone, créez-la si besoin, et ajoutez une note avecmessage.content.
Ce qui arrive depuis WhatsApp#
Chaque message entrant est une requête JSON. Les champs utilisés par les recettes :
| Champ | Exemple | À utiliser pour |
|---|---|---|
event | message_received | Ignorez message_sent si vous avez aussi coché Messages envoyés. |
contact.phone | 12125550120 | La recherche dans Pipedrive, et le téléphone de la nouvelle personne (avec +). |
contact.name | Emma Thompson | Le nom de la nouvelle personne. Peut être vide : utilisez alors le téléphone. |
contact.is_group, contact.phone_hidden | false | Ignorer les discussions de groupe et les numéros masqués. |
message.content | Can I add a gift note to it? | La note. Les photos et les fichiers arrivent sous forme d'étiquette, comme 📸 Image. |
message.timestamp | 2026-10-15T10:30:04+00:00 | Le moment de l'envoi, en UTC. |
Tous les champs, la signature et les nouvelles tentatives sont décrits dans Numéros de la boîte et webhooks de messages entrants.
Dépannage#
| Problème | Ce qu'il faut vérifier |
|---|---|
Auth Error: invalid api key | La clé a été supprimée ou mal saisie, ou n'appartient pas à l'espace de travail du Client ID. Dans Make et n8n, vérifiez l'en-tête Authorization: Bearer ou le credential. |
Invalid phone number | Le champ du téléphone était vide ou contenait autre chose, comme un nom. Vérifiez que la personne a un téléphone dans Pipedrive et que vous avez associé le champ du téléphone. |
| Le message est parti vers le mauvais numéro | Pipedrive a le numéro sans son indicatif du pays. Enregistrez-le avec l'indicatif, comme +44 20 7946 0018, ou envoyez country_code. |
Invalid JSON format: … | Un corps JSON brut s'est cassé, souvent à cause d'un guillemet ou d'un saut de ligne dans un champ associé. Dans les Automatisations Pipedrive, utilisez le corps Key-value ; dans Make, gardez les modules JSON du blueprint. |
| L'exécution de l'automatisation indique « Maximum retry limit reached » | WbizTool a répondu par une erreur. Ouvrez l'exécution dans Automations → History et lisez le corps envoyé. |
| Aucun webhook n'arrive de WbizTool | Le numéro doit afficher Synchronisation dans Numéros de la boîte, avec Messages reçus coché, avec le module Unibox. Make, n8n et Pabbly doivent répondre 2xx en moins de 8 secondes : activez le scénario ou le workflow. Les messages sont transmis en une minute ou deux. |
| Votre serveur ou pare-feu refuse le webhook de WbizTool | Autorisez les requêtes avec le User-Agent WbizTool-Webhooks/1. Certains hébergeurs bloquent les clients inconnus avec 403. |
| Une note est ajoutée mais la personne n'est pas trouvée, et un doublon est créé | Le numéro de la personne dans Pipedrive est enregistré sous une autre forme, par exemple sans l'indicatif du pays. Enregistrez-le avec l'indicatif, puis fusionnez les deux personnes dans Pipedrive. |
| Rien ne se passe pour un message de groupe | C'est voulu : les recettes ignorent les discussions de groupe et les numéros masqués, qui n'ont pas de téléphone à retrouver. |
Voir aussi#
- API d'envoi de messages : tous les champs que vous pouvez envoyer
- Numéros de la boîte et webhooks de messages entrants
- Clés API
- Intégration Zapier
- Intégration n8n
- Envoyer des messages WhatsApp depuis n'importe quel outil d'automatisation : Make, Pabbly Connect et d'autres

