Aller au contenu
WbizTool

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#

SensExempleCe qu'il faut dans WbizTool
Pipedrive → WhatsAppUne 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 → PipedriveUn 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#

Choisir une méthode#

MéthodePipedrive → WhatsAppWhatsApp → PipedriveForfait et droits Pipedrive
Automatisations PipedriveOui, sans autre outil : l'action webhook de l'automatisation appelle l'API WbizTool.NonLes Automatisations et leur action webhook sont disponibles à partir du forfait Growth. Seuls les administrateurs globaux créent le webhook automatisé.
ZapierOui, avec les actions de l'application WbizTool.Oui, avec le déclencheur WbizTool Incoming WhatsApp Message.Tout forfait avec accès à Zapier.
MakeOui, 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.
n8nOui, 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 ConnectOui, 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, comme 020 7946 0018, a besoin de country_code (ici 44), sinon il part vers le mauvais numéro ou échoue.
  • Les messages entrants ne donnent que des chiffres. Dans le webhook, contact.phone est le numéro sans +, par exemple 442079460018. 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.phone est alors vide et contact.phone_hidden vaut true. Les discussions de groupe ont contact.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.

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

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

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

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

  5. 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": 1 quand le message est mis en file d'attente ; une erreur reçoit une réponse HTTP 400 avec un message, comme Invalid phone number.

Zapier#

Utilisez l'application WbizTool sur Zapier avec l'application Pipedrive de Zapier.

Une affaire change d'étape : envoyer un message WhatsApp#

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

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

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

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

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

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

  2. Filtre : des personnes, pas des groupes

    Ajoutez Filter by Zapier : continuez uniquement si Is Group est faux et Contact Phone Hidden est faux.

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

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

BlueprintCe qu'il fait
pipedrive-deal-stage-to-whatsapp.blueprint.jsonWebhook 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.jsonWebhook 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#

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

  2. Créez le webhook

    Ouvrez le premier module (Webhooks → Custom webhook), cliquez sur Add, enregistrez et copiez l'adresse que Make affiche.

  3. Remplissez les espaces réservés

    • Dans le filtre après le webhook, remplacez YOUR_STAGE_ID par l'ID de votre étape. Pour le trouver, faites passer une fois une affaire de test à cette étape et lisez data.stage_id dans la sortie du webhook.
    • Dans le module Get the person, remplacez YOUR_COMPANY et YOUR_PIPEDRIVE_API_TOKEN.
    • Dans le module Send WhatsApp, remplacez YOUR_WBIZTOOL_API_KEY dans l'en-tête Authorization, YOUR_WHATSAPP_CLIENT_ID dans le corps, ainsi que le texte du message.
  4. 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.

  5. 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": 1 signifie 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#

  1. Importez le blueprint

    Importez whatsapp-to-pipedrive-note.blueprint.json dans un nouveau scénario.

  2. Créez le webhook

    Ouvrez Webhooks → Custom webhook, cliquez sur Add, enregistrez et copiez l'adresse.

  3. Remplissez les espaces réservés

    Remplacez YOUR_COMPANY et YOUR_PIPEDRIVE_API_TOKEN dans les quatre modules HTTP Pipedrive (recherche, création de la personne et les deux notes).

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

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

WorkflowCe qu'il fait
pipedrive-deal-stage-to-whatsapp.n8n.jsonPipedrive Trigger (affaire modifiée) → If l'affaire est passée à votre étape → Pipedrive Get person → WbizTool Send Message.
whatsapp-to-pipedrive-note.n8n.jsonWebhook (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.
  1. 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.

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

  3. Définissez votre étape et votre message

    Dans le premier workflow, remplacez YOUR_STAGE_ID dans le node If par l'ID de votre étape (faites passer une affaire de test à l'étape et lisez data.stage_id dans la sortie du déclencheur), et modifiez le Message Text. Laissez Country Code vide si vos numéros Pipedrive contiennent l'indicatif du pays.

  4. 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 avec message.content.

Ce qui arrive depuis WhatsApp#

Chaque message entrant est une requête JSON. Les champs utilisés par les recettes :

ChampExempleÀ utiliser pour
eventmessage_receivedIgnorez message_sent si vous avez aussi coché Messages envoyés.
contact.phone12125550120La recherche dans Pipedrive, et le téléphone de la nouvelle personne (avec +).
contact.nameEmma ThompsonLe nom de la nouvelle personne. Peut être vide : utilisez alors le téléphone.
contact.is_group, contact.phone_hiddenfalseIgnorer les discussions de groupe et les numéros masqués.
message.contentCan I add a gift note to it?La note. Les photos et les fichiers arrivent sous forme d'étiquette, comme 📸 Image.
message.timestamp2026-10-15T10:30:04+00:00Le 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èmeCe qu'il faut vérifier
Auth Error: invalid api keyLa 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 numberLe 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éroPipedrive 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 WbizToolLe 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 WbizToolAutorisez 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 groupeC'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#