WhatsApp entrants vers e-mail via webhooks
Toutes les équipes ne vivent pas dans Slack ou Teams. Beaucoup de PME — un garage, un cabinet comptable, un salon de coiffure avec deux adresses — fonctionnent encore avec une boîte mail partagée du type info@ ou support@. Quand un client répond sur WhatsApp à un rappel de rendez-vous ou à une facture, vous voulez que cette réponse arrive aussi là, sans que quelqu'un doive garder la boîte TextMeFlow ouverte toute la journée. Cet article construit un petit endpoint qui transforme chaque message WhatsApp entrant en e-mail, via un webhook TextMeFlow.
Le principe est identique au transfert vers Slack ou vers Microsoft Teams : TextMeFlow envoie les données brutes du message à votre serveur, et vous les vérifiez puis les traduisez vers le canal que votre équipe utilise déjà.
Ce dont vous avez besoin
- Un compte TextMeFlow avec un numéro WhatsApp lié et une
webhook_urlconfigurée dans/admin/webhook - Un moyen d'envoyer des e-mails depuis du code : un compte SMTP (votre propre serveur mail, ou Gmail/Outlook avec un mot de passe d'application) ou une API d'e-mail transactionnel comme Postmark, Mailgun ou Resend
- Un petit serveur (Node/Express dans cet exemple)
Étape 1 : configurer l'envoi d'e-mails
En production, préférez une API d'e-mail transactionnel à votre propre serveur mail — elle gère les bounces et offre une meilleure délivrabilité. Avec Nodemailer, n'importe quel fournisseur SMTP fonctionne de la même façon :
const nodemailer = require('nodemailer');
const mailer = nodemailer.createTransport({
host: process.env.SMTP_HOST,
port: 587,
auth: { user: process.env.SMTP_USER, pass: process.env.SMTP_PASS },
});
Étape 2 : vérifier l'endpoint du webhook
Pour chaque message entrant, TextMeFlow envoie un corps JSON, signé en HMAC-SHA256 dans l'en-tête X-TextMeFlow-Signature (format : sha256=<hex>). Vérifiez toujours cette signature avant de faire confiance au contenu — sinon, quiconque devine l'URL de votre endpoint peut envoyer de faux messages. L'explication complète de cet en-tête se trouve dans l'article sur la vérification des signatures de webhook.
const express = require('express');
const crypto = require('crypto');
const app = express();
app.use(express.raw({ type: 'application/json' }));
const SECRET = process.env.TMF_WEBHOOK_SECRET;
const seen = new Set(); // à remplacer par une table en base en production
app.post('/textmeflow-inbound', async (req, res) => {
const raw = req.body;
const expected = 'sha256=' + crypto.createHmac('sha256', SECRET).update(raw).digest('hex');
const received = req.headers['x-textmeflow-signature'] || '';
if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received))) {
return res.sendStatus(401);
}
const eventId = req.headers['x-textmeflow-event-id'];
if (seen.has(eventId)) return res.sendStatus(200); // retry, déjà traité
seen.add(eventId);
res.sendStatus(200); // on confirme d'abord, on traite ensuite
forwardToEmail(JSON.parse(raw));
});
app.listen(3000);
Confirmez toujours avec un 200 avant de traiter le message — TextMeFlow attend une réponse dans les 10 secondes, et un appel SMTP lent ne doit pas mettre ce délai en péril.
Étape 3 : transformer le message en e-mail
Le payload contient type, from, from_name, to et message — les mêmes champs que TextMeBot, donc une intégration existante migre un pour un. Construisez-en un e-mail lisible :
async function forwardToEmail(payload) {
const { type, from, from_name, message } = payload;
const label = type === 'text' ? '' : ` (${type})`;
await mailer.sendMail({
from: '"Boîte WhatsApp" <[email protected]>',
to: '[email protected]',
replyTo: '[email protected]',
subject: `Nouveau message WhatsApp de ${from_name || from}${label}`,
text: `${from_name || from} (+${from}) a écrit :\n\n${message}`,
});
}
Pour les messages image, document ou location, le nom du fichier ou "<lat>,<lng>" se trouve dans message — pour l'instant, mentionnez simplement le type dans le sujet, pour que votre collègue sache qu'une pièce jointe arrive.
Garder un fil par client
Un vrai inconvénient de l'e-mail par rapport à Slack : il n'y a pas de canal, donc les messages d'un même client arrivent comme des e-mails séparés. Une solution simple consiste à fixer un sujet par numéro de téléphone (par exemple WhatsApp — +32470123456), pour que Gmail et Outlook les regroupent automatiquement dans un même fil :
subject: `WhatsApp — +${from}`,
Toute la conversation avec ce client reste ainsi lisible dans un seul fil, même quand la boîte partagée est gérée par plusieurs personnes.
Retries et idempotence
Une livraison échouée (timeout, 5xx, 429) est retentée jusqu'à 5 fois avec un backoff croissant (1 min, 5 min, 30 min, 2 h, 6 h). Sans la vérification seen ci-dessus, chaque nouvelle tentative crée un e-mail en double dans votre boîte. En production, remplacez le Set par une contrainte unique sur X-TextMeFlow-Event-Id dans votre base de données, afin qu'une insertion en double échoue simplement et soit ignorée.
Pour aller plus loin
Ce flux de base s'étend facilement : router les e-mails vers une adresse différente selon le numéro to (utile avec plusieurs appareils liés à partir du plan Business), ou ajouter des règles simples qui envoient un message lié à une facture vers la comptabilité et une question de rendez-vous vers l'accueil. La référence complète des champs se trouve dans la documentation des webhooks.
Vous voulez tester vous-même ? Le plan gratuit vous donne 50 messages par mois, à vie — largement assez pour construire et valider tout ce flux avant de passer à un plan payant. Démarrer gratuitement.
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