· 4 min · TextMeFlow Team

WhatsApp-Nachrichten per Webhook an Microsoft Teams weiterleiten

Viele Unternehmen, die mit Microsoft 365 arbeiten, verbringen den ganzen Tag in Teams und nicht in einem separaten Dashboard. Ein Kunde, der per WhatsApp auf eine Rechnung oder Terminerinnerung antwortet, sollte deshalb in Teams landen — und nicht erst auffallen, wenn jemand zufällig im TextMeFlow-Admin eingeloggt ist. Dieser Artikel baut diesen Flow: von einem Teams-Kanal mit Webhook-Eingang bis zu einem verifizierten Endpunkt, der jede eingehende WhatsApp-Nachricht als Karte an Teams weiterleitet.

Wichtig: Nutze die Workflows-App, nicht den alten „Incoming Webhook"-Connector

Microsoft hat die klassischen Office-365-Connectors (den alten „Incoming Webhook" in den Kanaleinstellungen) eingestellt. Der aktuelle Weg führt über die Workflows-App in Teams, die auf Power Automate basiert. Sie bietet dieselbe Funktionalität — eine eindeutige URL, die eine POST-Anfrage in eine Karte in einem Kanal verwandelt —, aber unterstützt und ohne Veraltungswarnung.

Schritt 1: Webhook-URL in Teams erstellen

  1. Öffne den Kanal, in dem die Nachrichten landen sollen, zum Beispiel WhatsApp-inbox, und wähle in den Kanaloptionen Workflows.
  2. Suche die Vorlage „Post to a channel when a webhook request is received" und folge dem Assistenten.
  3. Teams erzeugt eine eindeutige URL. Speichere sie als Umgebungsvariable (TEAMS_WEBHOOK_URL) — niemals fest im Repository, denn wer diese URL kennt, kann Nachrichten in deinem Kanal posten.

Schritt 2: Endpunkt bauen, der den TextMeFlow-Webhook verifiziert

Für jede eingehende WhatsApp-Nachricht sendet TextMeFlow einen JSON-Body an die webhook_url, die du unter /admin/webhook festlegst, signiert mit HMAC-SHA256 im Header X-TextMeFlow-Signature (Format sha256=<hex>). Verifiziere diese Signatur immer, bevor du der Nachricht vertraust. Die vollständige Erklärung dieser Header findest du im Artikel zur Verifizierung von Webhook-Signaturen.

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(); // in der Produktion durch eine DB-Tabelle ersetzen

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); // Wiederholung, bereits verarbeitet
  seen.add(eventId);

  res.sendStatus(200); // erst bestätigen, dann verarbeiten
  forwardToTeams(JSON.parse(raw));
});

app.listen(3000);

Sende zuerst 200 zurück und verarbeite erst danach in Richtung Teams. TextMeFlow erwartet innerhalb von 10 Sekunden eine Antwort; wartest du synchron auf einen langsamen nachgelagerten Aufruf, riskierst du eine unberechtigte Wiederholung.

Schritt 3: Nachricht als Karte in Teams posten

Die Payload von TextMeFlow enthält type, from, from_name, to und message — dieselben Felder wie bei TextMeBot, eine bestehende Integration lässt sich also 1:1 migrieren. Der Webhook-Trigger der Workflows-App erwartet einen JSON-Body; am einfachsten ist eine Karte mit reinem Text:

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}`,
    }),
  });
}

Bei image-, document- oder location-Nachrichten steht der Dateiname oder "<lat>,<lng>" in message — nenne also einfach zusätzlich den Typ, damit Kollegen wissen, dass ein Anhang angekommen ist.

Wiederholungen und Idempotenz nicht vergessen

Eine fehlgeschlagene Zustellung (Timeout, 5xx, 429) wird bis zu 5-mal mit zunehmendem Backoff wiederholt (1 Min., 5 Min., 30 Min., 2 Std., 6 Std.). Ohne die seen-Prüfung oben erhält dein Teams-Kanal bei jeder Wiederholung eine doppelte Nachricht. Verwende in der Produktion kein Set im Arbeitsspeicher — es verschwindet beim Neustart —, sondern einen Unique-Constraint auf X-TextMeFlow-Event-Id in deiner Datenbank, sodass ein doppelter Insert einfach fehlschlägt und ignoriert wird.

Weiter ausbauen

Leite Nachrichten anhand der to-Nummer an unterschiedliche Kanäle weiter — praktisch, sobald du ab dem Business-Tarif mit mehreren gekoppelten Geräten arbeitest. Die vollständige Feldreferenz und die Header-Liste findest du in der Webhook-Dokumentation.

Möchtest du das selbst ausprobieren? Der kostenlose Tarif bietet dir 50 Nachrichten pro Monat, für immer — genug, um diesen Flow vollständig aufzubauen und zu prüfen, bevor du auf einen bezahlten Tarif wechselst. Starte kostenlos.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis