· 4 min · TextMeFlow Team

Transférer des messages WhatsApp vers Discord (webhooks)

Toutes les équipes ne vivent pas dans Slack ou Teams : beaucoup de petites entreprises, de communautés et d'équipes de développement gèrent leur communication interne via Discord. Lorsque des clients répondent sur WhatsApp à une confirmation, une facture ou une question, vous ne voulez pas voir ce message seulement quand quelqu'un se connecte par hasard à l'environnement d'administration. Avec un petit morceau de code intermédiaire, vous laissez TextMeFlow publier chaque message WhatsApp entrant directement dans un canal Discord.

Cet article construit le flux complet : de l'URL du webhook Discord à un endpoint vérifié qui transfère les messages, sans notifications en double lors des nouvelles tentatives.

Ce dont vous avez besoin

  • Un compte TextMeFlow avec un numéro WhatsApp associé et une webhook_url configurée dans /admin/webhook
  • Un serveur Discord où vous avez le droit de créer un webhook de canal
  • Un petit serveur (Node/Express dans cet exemple, mais la même chose fonctionne en PHP ou Python)

Étape 1 : créer le webhook Discord

Dans Discord, allez dans Paramètres du serveur → Intégrations → Webhooks → Nouveau webhook, choisissez le canal (par exemple #whatsapp-inbox) et copiez l'URL du webhook. Elle ressemble à ceci : https://discord.com/api/webhooks/123456789/xxxxx. Conservez cette URL dans une variable d'environnement, jamais en dur dans votre dépôt : toute personne qui possède cette URL peut publier des messages dans votre canal.

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

Pour chaque message entrant, TextMeFlow envoie 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, sinon quiconque devine l'URL de votre endpoint peut envoyer de faux messages. L'explication complète de ces en-têtes 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 DISCORD_URL = process.env.DISCORD_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); // nouvelle tentative, déjà traité
  seen.add(eventId);

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

app.listen(3000);

Nous renvoyons d'abord 200 et ne publions sur Discord qu'ensuite. TextMeFlow attend une réponse dans les 10 secondes ; si vous attendez de façon synchrone un appel aval lent, vous risquez une nouvelle tentative injustifiée.

Étape 3 : transférer le message vers Discord

Le payload de TextMeFlow contient type, from, from_name, to, file et message, les mêmes champs que TextMeBot : une intégration existante se migre donc presque à l'identique. Les webhooks Discord acceptent un simple corps JSON avec un champ content :

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

  await fetch(DISCORD_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      content: `📩 **${from_name || from}** (+${from})${label}: ${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 à côté, afin que votre équipe sache qu'une pièce jointe est arrivée.

N'oubliez pas les nouvelles tentatives et l'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, votre canal Discord reçoit un message en double à chaque nouvelle tentative. 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, afin qu'une insertion en double échoue simplement et soit ignorée.

Aller plus loin

Ce flux de base est rapide à étendre : dirigez les messages vers différents canaux Discord selon le numéro to (pratique avec plusieurs appareils associés à partir du plan Business), ou utilisez le champ embeds de Discord pour une carte un peu plus lisible, avec l'expéditeur, l'heure et le type de message séparés. La référence complète des champs et la liste des en-têtes se trouvent dans la documentation des webhooks.

Envie de l'essayer vous-même ? Le plan gratuit vous offre 50 messages par mois, pour toujours, de quoi mettre en place et valider tout ce flux avant de passer à un plan payant. Commencez 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