Notifications WhatsApp depuis les webhooks Zoho CRM
L'automatisation des workflows de Zoho CRM peut déclencher un webhook sortant à chaque modification d'un enregistrement : un lead passe à « Qualified », une affaire atteint « Closed Won », une tâche est en retard. La plupart des équipes y branchent une alerte e-mail qui reste non lue dans une boîte de réception. Envoyer le même événement sur WhatsApp le fait arriver sous les yeux du commercial qui doit agir, puisqu'un message WhatsApp est ouvert en quelques minutes plutôt qu'en quelques heures.
C'est le même schéma webhook vers API que pour d'autres CRM : une règle de workflow Zoho, un petit récepteur que vous hébergez, et l'API de messages de TextMeFlow. Aucune extension Zoho Marketplace à installer ni à maintenir.
Étape 1 : créer un webhook sortant dans Zoho CRM
Dans Zoho CRM, allez dans Setup → Automation → Workflow Rules et créez une règle liée au module qui vous intéresse (Leads, Deals, Tasks). Définissez le déclencheur — « When a record is edited » ou « When a field is updated » — puis ajoutez une Instant Action → Webhook à la règle. Zoho vous permet de choisir quels champs de l'enregistrement sont envoyés dans le corps du webhook ; sélectionnez ceux dont vous aurez besoin ensuite : l'identifiant de l'enregistrement, l'e-mail ou le téléphone du propriétaire, le champ modifié et sa nouvelle valeur.
Les webhooks Zoho ne prennent pas en charge l'authentification HTTP Basic par défaut ; ajoutez donc un secret partagé sous forme de paramètre de requête ou de valeur d'en-tête à l'URL que vous configurez (https://yourapp.com/zoho-hook?key=...) et vérifiez-le dans votre récepteur avant toute autre action — sinon le endpoint accepte des POST non authentifiés de n'importe qui trouvant l'URL.
Étape 2 : construire un récepteur qui associe le propriétaire à un numéro de téléphone
Zoho envoie les champs que vous avez associés en form-encoded ou en JSON, selon la configuration de l'action webhook. Un récepteur Node pour une règle « Statut du lead modifié » ressemble à ceci :
import express from 'express';
const app = express();
app.use(express.urlencoded({ extended: true }));
app.post('/zoho-hook', async (req, res) => {
if (req.query.key !== process.env.ZOHO_WEBHOOK_KEY) {
return res.sendStatus(401);
}
const { lead_status, owner_phone, lead_name } = req.body;
if (lead_status !== 'Qualified' || !owner_phone) {
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: owner_phone,
text: `Le lead "${lead_name}" vient de passer à Qualified. Relancez-le aujourd'hui.`,
}),
});
res.sendStatus(200);
});
La règle de workflow de Zoho se déclenche à chaque enregistrement qui correspond au déclencheur ; le garde-fou lead_status !== 'Qualified' est donc important — sans lui, vous enverriez un message à chaque modification d'un lead déjà qualifié, et pas seulement lors du passage à ce statut.
Étape 3 : normaliser les numéros de téléphone avant l'envoi
Zoho stocke les champs de téléphone en texte libre, tels que le commercial les a saisis. Normalisez en E.164 et ignorez l'envoi plutôt que de deviner lorsqu'un numéro ne s'analyse pas proprement :
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}`;
}
La même logique s'applique que vous construisiez le récepteur en PHP, Python ou Node — le endpoint REST de TextMeFlow se moque du langage qui l'appelle, et des exemples d'intégration pour les trois figurent dans la documentation.
Étape 4 : utiliser les transitions Blueprint pour les étapes soumises à validation
Si le changement d'étape qui vous intéresse passe par un Blueprint Zoho (un processus d'approbation formel plutôt qu'une simple mise à jour de champ), le déclencheur de la règle de workflow est « When a Blueprint transition occurs » au lieu d'une modification de champ. C'est important pour des cas comme « Affaire passée à Contract Sent après validation du manager » — un déclencheur sur simple mise à jour de champ se déclencherait sur la modification brute du champ avant même la fin de l'étape d'approbation, et vous préviendriez le commercial trop tôt.
Gardez le récepteur idempotent
Zoho peut renvoyer un webhook si votre endpoint ne répond pas assez vite ou renvoie un statut non 2xx. Dédoublonnez sur l'identifiant de l'enregistrement plus la valeur du champ à laquelle vous réagissez (id du lead + « Qualified », id de l'affaire + « Closed Won »), pour qu'une nouvelle tentative n'envoie pas deux fois le même message WhatsApp au même commercial. Une contrainte d'unicité sur cette paire dans la table qui consigne les notifications envoyées suffit — pas besoin de logique de dédoublonnage sur mesure.
À quoi cela sert
Bons usages : alerter un commercial dès que son lead est qualifié ou que son affaire est conclue, prévenir un manager lorsqu'une affaire de forte valeur stagne trop longtemps à une même étape, avertir un chef d'équipe quand une tâche est marquée en retard. Mauvais usage : écrire au lead ou au contact lui-même avec ce schéma sans son opt-in préalable — c'est de la communication client, qui exige une gestion correcte du consentement, et non une alerte commerciale interne. Réservez ce schéma aux notifications internes en tête-à-tête avec votre propre équipe ; le volume reste ainsi faible et à l'écart du score de risque anti-spam.
Démarrez gratuitement avec TextMeFlow — 50 messages par mois, sans limite de durée, de quoi brancher et tester un webhook Zoho CRM 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