Envoyer des messages WhatsApp depuis Intercom (webhooks)
Intercom est conçu pour l'onglet de navigateur que vous avez ouvert. Dès qu'un client ferme cet onglet, votre réponse reste sans lecture jusqu'à ce qu'il y repense, ou jusqu'à ce que vous le relanciez par e-mail, qui est traité aussi lentement qu'un ticket de support. Les notifications WhatsApp comblent ce fossé : quand un agent répond ou qu'une conversation est résolue, le client reçoit un message qu'il verra réellement en quelques minutes. Inutile d'installer une application Intercom du marketplace pour cela. Un abonnement webhook et un petit récepteur qui appelle l'API de messages de TextMeFlow suffisent.
Étape 1 : créer un abonnement webhook dans Intercom
Dans Intercom, rendez-vous dans Settings → Developers → Webhooks (ou créez une application privée sous Settings → Developers → Developer Hub si votre espace de travail l'exige) et ajoutez un nouvel abonnement webhook. Il vous faut :
- Une URL cible : un petit récepteur que vous hébergez, par ex.
https://yourapp.example.com/intercom-hook - Les topics auxquels vous abonner. Deux comptent ici :
conversation.admin.replied(un agent a envoyé une réponse) etconversation.admin.closed(la conversation a été résolue) - Un client secret, avec lequel Intercom signe chaque envoi via un en-tête
X-Hub-Signature
Abonnez-vous uniquement aux topics que vous allez exploiter. Intercom propose des dizaines d'événements de conversation (assignée, mise en pause, taguée, partie ajoutée par un bot, etc.). En choisissant précisément replied et closed, votre récepteur reste simple et vous n'envoyez pas de message WhatsApp pour des opérations internes.
Étape 2 : vérifier la signature avant de faire confiance au payload
Chaque envoi de webhook Intercom comprend une signature HMAC-SHA1 du corps brut, calculée avec votre client secret. Vérifiez-la avant de lire quoi que ce soit dans le payload. C'est la même rigueur que TextMeFlow demande à ses propres consommateurs de webhooks (voir vérifier les signatures de webhook) :
import crypto from 'crypto';
function verifyIntercomSignature(rawBody, signatureHeader, secret) {
const expected = crypto
.createHmac('sha1', secret)
.update(rawBody)
.digest('hex');
const provided = signatureHeader.replace('sha1=', '');
return crypto.timingSafeEqual(
Buffer.from(expected, 'hex'),
Buffer.from(provided, 'hex')
);
}
Rejetez tout ce qui ne correspond pas avec un 401 avant de toucher à req.body. Un payload non vérifié n'est qu'une chaîne que quelqu'un a envoyée en POST à votre endpoint.
Étape 3 : relier la conversation à un numéro de téléphone
Le payload du webhook Intercom contient la conversation et le contact, mais pas forcément un numéro de téléphone exploitable. Cela dépend de ce que vous avez enregistré sur la fiche du contact Intercom. Si votre parcours d'inscription ou une synchronisation précédente a déjà écrit le numéro du client dans un attribut personnalisé (par ex. phone_whatsapp), lisez-le dans payload.data.item.contacts.contacts[0]. Si ce champ n'est pas rempli de façon fiable, vous avez deux options : rechercher le contact via l'API Intercom par id pour récupérer son champ standard phone, ou ne pas envoyer de message quand le champ est vide plutôt que de deviner un numéro.
Étape 4 : recevoir le webhook et envoyer le message WhatsApp
import express from 'express';
const app = express();
app.use(express.json({ verify: (req, res, buf) => { req.rawBody = buf; } }));
app.post('/intercom-hook', async (req, res) => {
const signature = req.headers['x-hub-signature'];
if (!verifyIntercomSignature(req.rawBody, signature, process.env.INTERCOM_CLIENT_SECRET)) {
return res.sendStatus(401);
}
const topic = req.body.topic;
const conversation = req.body.data?.item;
const phone = conversation?.contacts?.contacts?.[0]?.phone;
if (!phone) return res.sendStatus(200);
const text = topic === 'conversation.admin.closed'
? `Votre conversation avec le support est résolue. Répondez ici si vous avez encore besoin d'aide.`
: `Vous avez une nouvelle réponse dans votre conversation avec le support. Consultez-la quand vous aurez un moment.`;
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: phone, text }),
});
res.sendStatus(200);
});
app.listen(3000);
Répondez rapidement avec 200 et faites l'appel WhatsApp sans bloquer la logique de nouvelle tentative d'Intercom. Intercom réessaie un envoi qui expire, et vous ne voulez pas de messages en double parce que votre récepteur était lent, et non défaillant.
Étape 5 : ne retenir que les transitions qui comptent pour les clients
conversation.admin.replied se déclenche à chaque message d'un agent, y compris un rapide « nous regardons ça » suivi de trois autres messages dans la minute. Si votre équipe de support envoie plusieurs courtes réponses par conversation, envisagez un debounce : retenez la notification 60 à 90 secondes et envoyez-la une seule fois si aucun nouveau topic de réponse n'arrive pour cet ID de conversation, ou ne notifiez que pour la première réponse après une période de silence du client. Un message à chaque rafale de frappe apprend aux clients à ignorer votre numéro WhatsApp, ce qui est l'opposé de l'objectif de cette intégration. Les notes sur le pipeline anti-spam expliquent comment les envois répétitifs affectent la délivrabilité de façon plus générale.
N'envoyez qu'aux numéros ayant donné leur consentement
Les conversations Intercom sont déjà des échanges que le client a lancés, ce qui couvre le cas transactionnel (réponses et résolutions sur son propre ticket ouvert). Cela ne vous donne pas carte blanche pour écrire à ce numéro pour autre chose : le suivi marketing exige toujours son propre opt-in. Gardez ces deux usages séparés dans vos propres registres.
Une fois cela en place, le même schéma (s'abonner à un topic de webhook, vérifier la signature, associer un numéro de téléphone, appeler l'API de messages) fonctionne avec n'importe quel outil de support doté de webhooks d'événements, pas seulement Intercom. Prêt à l'essayer sur votre propre compte ?
Démarrer gratuitement avec TextMeFlow : 50 messages par mois, sans carte bancaire.
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