· 5 min · TextMeFlow Team

Notifications WhatsApp depuis les webhooks Pipedrive

Pipedrive peut déclencher un webhook à l'instant où une affaire change d'étape, où une nouvelle affaire est créée ou où une activité est marquée comme terminée. La plupart des équipes commerciales envoient cela vers un canal Slack que personne ne consulte entre deux réunions. Envoyer le même événement sur WhatsApp le place sous les yeux du commercial qui doit agir : un message du type « affaire gagnée, envoyez le contrat » ou « appel de démo dans 30 minutes » qui est réellement lu en quelques minutes.

Il s'agit d'un schéma webhook vers API : les webhooks natifs de Pipedrive, un petit récepteur que vous hébergez et l'API de messages de TextMeFlow. Pas d'application de marketplace, pas de flux OAuth à maintenir.

Étape 1 : créez le webhook dans Pipedrive

Les webhooks Pipedrive se configurent sous Settings → Tools and apps → Webhooks (sur certains abonnements, cela se trouve plutôt dans une application « Webhooks » du Marketplace). Créez un nouveau webhook avec :

  • Événement : choisissez l'objet et l'action souhaités ; deal.updated, deal.added ou activity.updated sont les plus courants pour des notifications
  • URL du point de terminaison : votre récepteur (voir ci-dessous)
  • HTTP Auth : définissez un nom d'utilisateur et un mot de passe si vous voulez que Pipedrive s'authentifie auprès de votre récepteur ; faites-le, car sinon le point de terminaison acceptera des requêtes POST non authentifiées de la part de quiconque trouve l'URL

Pipedrive envoie l'objet complet ainsi qu'un instantané previous de l'objet avant la modification, ce qui permet de détecter un changement d'étape sans second appel d'API.

Étape 2 : construisez un récepteur qui vérifie ce qui a réellement changé

Un webhook deal.updated se déclenche à chaque modification de champ, pas seulement lors d'un changement d'étape : l'ajout d'une note, un ajustement de valeur ou une réaffectation de propriétaire déclenchent tous le même événement. Comparez current.stage_id à previous.stage_id avant de décider d'envoyer quoi que ce soit :

import express from 'express';
const app = express();
app.use(express.json());

app.post('/pipedrive-deal-hook', async (req, res) => {
  const { current, previous } = req.body;

  if (current.stage_id === previous?.stage_id) {
    return res.sendStatus(200); // not a stage change, ignore
  }

  const ownerPhone = current.owner_id?.phone;
  if (!ownerPhone) return res.sendStatus(200);

  await fetch('https://api.textmeflow.eu/v1/messages', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.TEXTMEFLOW_TOKEN}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      to: ownerPhone,
      text: `L'affaire "${current.title}" est passée à l'étape ${current.stage_id}. Valeur : ${current.currency} ${current.value}.`,
    }),
  });

  res.sendStatus(200);
});

La même logique fonctionne en PHP ou en Python : TextMeFlow fournit des SDK pour les deux, ou appelez directement le point de terminaison REST avec n'importe quel client HTTP.

Étape 3 : résolvez correctement les identifiants d'étape et les numéros de téléphone

La charge utile du webhook Pipedrive vous donne stage_id, pas le nom de l'étape : récupérez une fois la liste des étapes du pipeline (GET /v1/stages dans l'API Pipedrive) et mettez en cache la correspondance identifiant-nom plutôt que de la coder en dur, car les noms et l'ordre des étapes évoluent avec le processus de vente. Pour les numéros de téléphone, Pipedrive enregistre celui d'une personne ou d'un propriétaire sous forme de texte libre ; normalisez-le au format E.164 avant d'envoyer, et ne faites pas l'envoi (sans deviner) si le champ ne peut pas être interprété :

function toE164(raw, defaultCountry = '32') {
  const digits = raw.replace(/[^\d]/g, '');
  if (raw.startsWith('+')) return '+' + digits;
  if (digits.startsWith('00')) return '+' + digits.slice(2);
  if (digits.startsWith('0')) return `+${defaultCountry}${digits.slice(1)}`;
  return `+${digits}`;
}

Étape 4 : utilisez les webhooks d'activité pour les rappels, pas seulement ceux des affaires

Pour des rappels du type « appelez le client dans 30 minutes », abonnez-vous à activity.added ou activity.updated plutôt qu'aux événements d'affaire, et comparez due_date / due_time à l'heure actuelle dans votre récepteur avant d'envoyer : Pipedrive déclenche le webhook quand l'enregistrement de l'activité change, pas quand elle arrive réellement à échéance. Une approche simple : lors de activity.added, planifiez une tâche différée (une file d'attente, une vérification par cron ou un champ scheduled_at lu par un worker périodique) qui envoie le message WhatsApp à due_date/due_time moins votre délai d'anticipation, et annulez-la si l'activité est marquée comme terminée ou supprimée entre-temps.

Gardez le récepteur idempotent

Pipedrive peut renvoyer un webhook après un délai d'attente dépassé ou une erreur 5xx de votre point de terminaison. Dédoublonnez sur l'identifiant de l'objet plus le champ auquel vous réagissez (identifiant de l'affaire + nouvel identifiant d'étape, ou identifiant de l'activité + horodatage d'échéance), afin qu'une nouvelle tentative n'envoie pas deux fois le même message WhatsApp au même commercial.

À quoi cela sert

Bons usages : prévenir un commercial à l'instant où son affaire atteint « Contract Sent » ou « Won », lui rappeler un appel bientôt dû, alerter un manager lorsqu'une affaire de grande valeur stagne trop longtemps dans une même étape. Mauvais usage : envoyer par ce schéma des messages WhatsApp aux contacts ou prospects eux-mêmes sans leur consentement préalable ; il s'agit alors de communication client, pas d'une alerte commerciale interne, et cela exige une gestion correcte du consentement. Réservez ce schéma aux notifications internes individuelles à votre propre équipe, ce qui maintient aussi le volume bas et à l'écart du score de risque anti-spam.

Commencer gratuitement avec TextMeFlow : 50 messages par mois, sans limite de durée, de quoi configurer et tester un webhook Pipedrive avant de choisir une offre payante.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours