· 5 min · TextMeFlow Team

Transférer les messages WhatsApp entrants vers Slack (webhooks)

Nous ne voulons pas laisser attendre les clients qui répondent sur WhatsApp à une confirmation de réservation ou à une facture jusqu'à ce que quelqu'un jette un œil par hasard à l'espace d'administration. La plupart des équipes passent la journée dans Slack : c'est donc là que le message doit atterrir. TextMeFlow envoie chaque message WhatsApp entrant sous forme de webhook à votre serveur ; avec un petit morceau de code intermédiaire, il arrive directement dans un canal Slack, avec le nom de l'expéditeur et son numéro de téléphone.

Cet article construit le flux complet : du webhook entrant Slack à un endpoint vérifié et idempotent qui transfère les messages.

Ce dont vous avez besoin

  • Un compte TextMeFlow avec un numéro WhatsApp connecté et un webhook_url configuré dans /admin/webhook
  • Un espace de travail Slack où vous pouvez créer un webhook entrant
  • Un petit serveur (Node/Express dans cet exemple, mais cela fonctionne de la même façon en PHP ou en Python)

Étape 1 : créer un webhook entrant Slack

Dans Slack, créez une nouvelle application (ou réutilisez-en une existante), activez Incoming Webhooks et associez un canal, par exemple #whatsapp-inbox. Slack vous donne une URL du type https://hooks.slack.com/services/T000/B000/XXXX. Conservez-la dans une variable d'environnement, jamais en dur dans votre dépôt.

Étape 2 : créer un endpoint qui vérifie le webhook TextMeFlow

Pour chaque message entrant, TextMeFlow envoie en POST un corps JSON à votre webhook_url, 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 message, faute de quoi toute personne connaissant l'URL de votre endpoint peut envoyer de faux messages. Voir aussi l'article sur la vérification des signatures de webhook pour l'explication complète de ces en-têtes.

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 SLACK_URL = process.env.SLACK_WEBHOOK_URL;
const seen = new Set(); // à remplacer par une table en base de données 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); // nouvel essai, déjà traité
  seen.add(eventId);

  res.sendStatus(200); // d'abord confirmer, ensuite traiter
  forwardToSlack(JSON.parse(raw));
});

app.listen(3000);

Remarquez que nous renvoyons d'abord 200 et que nous n'envoyons vers Slack qu'ensuite. TextMeFlow attend une réponse dans les 10 secondes ; si vous attendez de façon synchrone un appel aval lent (comme Slack), vous risquez un nouvel essai injustifié.

Étape 3 : transférer le message vers Slack

La charge utile de TextMeFlow contient type, from, from_name, to, file et message, exactement les mêmes champs que TextMeBot : une intégration existante migre donc à l'identique. Construisez-en un message Slack lisible :

async function forwardToSlack(payload) {
  const { type, from, from_name, message } = payload;
  const label = type === 'text' ? '' : ` (${type})`;

  await fetch(SLACK_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      text: `📩 *${from_name || from}* (+${from})${label}: ${message}`,
    }),
  });
}

Pour les messages de type image, document ou location, le nom du fichier ou "<lat>,<lng>" se trouve dans message. L'hébergement des médias avec une vraie URL arrivera dans une prochaine version : pour l'instant, mentionnez simplement le type afin que vos collègues sachent qu'une pièce jointe est arrivée.

N'oubliez pas les réessais et l'idempotence

Une livraison échouée (timeout, 5xx, 429) est retentée jusqu'à 5 fois avec un délai croissant (1 min, 5 min, 30 min, 2 h, 6 h). Sans la vérification seen ci-dessus, votre canal Slack reçoit un message en double à chaque nouvel essai. En production, n'utilisez pas un Set en mémoire, qui disparaît au redémarrage, mais une contrainte d'unicité sur X-TextMeFlow-Event-Id dans votre base de données : un second insert échoue alors simplement et est ignoré.

Aller plus loin

Ce flux de base peut être étendu en quelques minutes : acheminez les messages vers différents canaux Slack selon le numéro to (pratique avec plusieurs appareils connectés à partir du forfait Business), ou ajoutez un bouton « Répondre » qui renvoie une réponse au client via l'endpoint /v1/messages, sans que personne ait besoin d'ouvrir WhatsApp. La référence complète des champs et la liste des en-têtes se trouvent dans la documentation des webhooks.

Envie de tester par vous-même ? Le forfait gratuit vous donne 50 messages par mois, pour toujours, de quoi mettre en place et valider tout ce flux avant de passer à un forfait payant. Démarrez 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