· 4 min · TextMeFlow Team

WhatsApp-Nachrichten per Webhook an Discord weiterleiten

Nicht jedes Team sitzt in Slack oder Teams: Viele kleinere Unternehmen, Communitys und Dev-Teams wickeln ihre interne Kommunikation über Discord ab. Wenn Kunden auf WhatsApp auf eine Bestätigung, Rechnung oder Frage antworten, willst du diese Nachricht nicht erst sehen, wenn sich zufällig jemand in die Admin-Umgebung einloggt. Mit einem kleinen Stück Zwischencode lässt du TextMeFlow jede eingehende WhatsApp-Nachricht direkt in einen Discord-Kanal posten.

Dieser Artikel baut den kompletten Ablauf: von der Discord-Webhook-URL bis zu einem verifizierten Endpoint, der Nachrichten weiterleitet, ohne doppelte Benachrichtigungen bei Retries.

Was du brauchst

  • Ein TextMeFlow-Konto mit verknüpfter WhatsApp-Nummer und einer konfigurierten webhook_url unter /admin/webhook
  • Einen Discord-Server, auf dem du einen Kanal-Webhook erstellen darfst
  • Einen kleinen Server (in diesem Beispiel Node/Express, aber dasselbe funktioniert in PHP oder Python)

Schritt 1: Discord-Webhook erstellen

Gehe in Discord zu Servereinstellungen → Integrationen → Webhooks → Neuer Webhook, wähle den Kanal (zum Beispiel #whatsapp-inbox) und kopiere die Webhook-URL. Sie sieht ungefähr so aus: https://discord.com/api/webhooks/123456789/xxxxx. Speichere diese URL als Umgebungsvariable, niemals hartcodiert in deinem Repo: Jeder mit dieser URL kann Nachrichten in deinen Kanal posten.

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

TextMeFlow sendet für jede eingehende Nachricht einen JSON-Body an deine webhook_url, signiert mit HMAC-SHA256 im Header X-TextMeFlow-Signature (Format: sha256=<hex>). Verifiziere diese Signatur immer, bevor du der Nachricht vertraust, sonst kann jeder, der deine Endpoint-URL errät, gefälschte Nachrichten einschleusen. Die vollständige Erklärung dieser Header steht im Artikel über die 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 DISCORD_URL = process.env.DISCORD_WEBHOOK_URL;
const seen = new Set(); // in 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); // Retry, bereits verarbeitet
  seen.add(eventId);

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

app.listen(3000);

Wir senden zuerst 200 zurück und posten erst danach an Discord. TextMeFlow erwartet innerhalb von 10 Sekunden eine Antwort; wartest du synchron auf einen langsamen nachgelagerten Aufruf, riskierst du einen unberechtigten Retry.

Schritt 3: Nachricht an Discord weiterleiten

Die TextMeFlow-Payload enthält type, from, from_name, to, file und message, dieselben Felder wie bei TextMeBot, sodass sich eine bestehende Integration nahezu 1:1 migrieren lässt. Discord-Webhooks akzeptieren einen einfachen JSON-Body mit einem content-Feld:

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

Bei image-, document- oder location-Nachrichten steht der Dateiname oder "<lat>,<lng>" in message. Nenne vorerst einfach den Typ dazu, damit dein Team weiß, dass ein Anhang angekommen ist.

Retries und Idempotenz nicht vergessen

Eine fehlgeschlagene Zustellung (Timeout, 5xx, 429) wird bis zu 5-mal mit steigendem Backoff wiederholt (1 Min., 5 Min., 30 Min., 2 Std., 6 Std.). Ohne die seen-Prüfung oben bekommt dein Discord-Kanal bei jedem Retry eine doppelte Nachricht. Nutze in Produktion kein Set im Arbeitsspeicher, das bei einem Neustart verschwindet, sondern eine Unique-Constraint auf X-TextMeFlow-Event-Id in deiner Datenbank, sodass ein doppelter Insert einfach fehlschlägt und ignoriert wird.

Weiter ausbauen

Dieser Basis-Ablauf lässt sich schnell erweitern: Leite Nachrichten anhand der to-Nummer an unterschiedliche Discord-Kanäle (praktisch bei mehreren verknüpften Geräten ab dem Business-Plan), oder nutze das embeds-Feld von Discord für eine etwas übersichtlichere Karte mit Absender, Uhrzeit und Nachrichtentyp getrennt. Die vollständige Feldreferenz und Header-Liste findest du in der Webhook-Dokumentation.

Willst du es selbst ausprobieren? Der kostenlose Plan gibt dir 50 Nachrichten pro Monat, dauerhaft, genug, um diesen gesamten Ablauf aufzusetzen und zu validieren, bevor du zu einem bezahlten Plan 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