· 4 min · TextMeFlow Team

Transférer les messages WhatsApp vers Microsoft Teams

Beaucoup d'entreprises qui travaillent sous Microsoft 365 passent leur journée dans Teams, pas dans un tableau de bord à part. Un client qui répond sur WhatsApp à une facture ou à un rappel de rendez-vous doit donc arriver dans Teams — et ne pas être remarqué seulement lorsque quelqu'un se connecte par hasard à l'administration TextMeFlow. Cet article construit ce flux : d'un canal Teams doté d'une entrée webhook jusqu'à un endpoint vérifié qui transfère chaque message WhatsApp entrant sous forme de carte dans Teams.

Important : utilisez l'application Workflows, pas l'ancien connecteur « Incoming Webhook »

Microsoft a abandonné les connecteurs Office 365 classiques (l'ancien « Incoming Webhook » dans les paramètres du canal). La voie actuelle passe par l'application Workflows de Teams, construite sur Power Automate. Elle offre la même fonctionnalité — une URL unique qui transforme une requête POST en carte dans un canal — mais avec une prise en charge officielle et sans avertissement d'obsolescence.

Étape 1 : créer une URL de webhook dans Teams

  1. Ouvrez le canal où les messages doivent arriver, par exemple WhatsApp-inbox, et choisissez Workflows dans les options du canal.
  2. Cherchez le modèle « Post to a channel when a webhook request is received » et suivez l'assistant.
  3. Teams génère une URL unique. Stockez-la dans une variable d'environnement (TEAMS_WEBHOOK_URL) — jamais en dur dans votre dépôt, car quiconque connaît cette URL peut publier des messages dans votre canal.

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

Pour chaque message WhatsApp entrant, TextMeFlow envoie un corps JSON à la webhook_url que vous définissez dans /admin/webhook, 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. L'explication complète de ces en-têtes figure dans l'article sur la vérification des signatures de webhooks.

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 TEAMS_URL = process.env.TEAMS_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 accuser réception, traiter ensuite
  forwardToTeams(JSON.parse(raw));
});

app.listen(3000);

Renvoyez d'abord 200, puis seulement ensuite le traitement vers Teams. 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 : publier le message sous forme de carte dans Teams

La charge utile de TextMeFlow contient type, from, from_name, to et message — les mêmes champs que chez TextMeBot : une intégration existante migre donc à l'identique. Le déclencheur webhook de l'application Workflows attend un corps JSON ; le plus simple est une carte en texte brut :

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

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

Pour les messages image, document ou location, le nom du fichier ou "<lat>,<lng>" se trouve dans message — mentionnez donc simplement aussi le type afin que vos collègues sachent qu'une pièce jointe est arrivée.

N'oubliez pas les nouvelles tentatives et l'idempotence

Une livraison échouée (délai dépassé, 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 Teams reçoit un message en double à chaque nouvelle tentative. En production, n'utilisez pas un Set en mémoire — il disparaît au redémarrage — mais une contrainte d'unicité sur X-TextMeFlow-Event-Id dans votre base de données, de sorte qu'une insertion en double échoue simplement et soit ignorée.

Aller plus loin

Dirigez les messages vers différents canaux selon le numéro to — pratique dès que vous travaillez avec plusieurs appareils associés à partir du plan Business. La référence complète des champs et la liste des en-têtes se trouvent dans la documentation des webhooks.

Envie d'essayer vous-même ? Le plan gratuit vous donne 50 messages par mois, pour toujours — de quoi mettre en place et valider entièrement 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