Eingehende WhatsApp-Nachrichten per Webhook an Slack weiterleiten
Kunden, die auf WhatsApp auf eine Buchungsbestätigung oder Rechnung antworten, wollen wir nicht warten lassen, bis zufällig jemand in den Admin-Bereich schaut. Die meisten Teams sind den ganzen Tag in Slack, also muss die Nachricht dort landen. TextMeFlow schickt jede eingehende WhatsApp-Nachricht als Webhook an deinen Server; mit einem kleinen Stück Vermittlungscode landet sie direkt in einem Slack-Kanal, samt Name und Telefonnummer des Absenders.
Dieser Artikel baut den kompletten Ablauf: vom Slack-Incoming-Webhook bis zu einem geprüften, idempotenten Endpunkt, der Nachrichten weiterleitet.
Was du brauchst
- Ein TextMeFlow-Konto mit verbundener WhatsApp-Nummer und einer konfigurierten
webhook_urlin/admin/webhook - Einen Slack-Workspace, in dem du einen Incoming Webhook anlegen darfst
- Einen kleinen Server (in diesem Beispiel Node/Express, mit PHP oder Python funktioniert dasselbe)
Schritt 1: Slack-Incoming-Webhook anlegen
Erstelle in Slack eine neue App (oder nutze eine bestehende), aktiviere Incoming Webhooks und verknüpfe einen Kanal, zum Beispiel #whatsapp-inbox. Slack gibt dir eine URL wie https://hooks.slack.com/services/T000/B000/XXXX. Speichere sie als Umgebungsvariable, niemals fest im Repo.
Schritt 2: Endpunkt bauen, der den TextMeFlow-Webhook prüft
Für jede eingehende Nachricht schickt TextMeFlow einen JSON-Body per POST an deine webhook_url, signiert mit HMAC-SHA256 im Header X-TextMeFlow-Signature (Format: sha256=<hex>). Prüfe diese Signatur immer, bevor du der Nachricht vertraust, sonst kann jeder, der deine Endpunkt-URL kennt, gefälschte Nachrichten einschleusen. Siehe auch den Artikel zur Prüfung von Webhook-Signaturen für die vollständige Erklärung dieser Header.
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(); // 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, schon verarbeitet
seen.add(eventId);
res.sendStatus(200); // erst bestätigen, dann verarbeiten
forwardToSlack(JSON.parse(raw));
});
app.listen(3000);
Beachte, dass wir zuerst 200 zurückgeben und erst danach an Slack posten. TextMeFlow erwartet innerhalb von 10 Sekunden eine Antwort; wenn du synchron auf einen langsamen nachgelagerten Aufruf (wie Slack) wartest, riskierst du eine unnötige Wiederholung.
Schritt 3: Nachricht an Slack weiterleiten
Die TextMeFlow-Payload enthält type, from, from_name, to, file und message, exakt dieselben Felder wie bei TextMeBot, eine bestehende Integration lässt sich also 1:1 migrieren. Baue daraus eine lesbare Slack-Nachricht:
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}`,
}),
});
}
Bei Nachrichten vom Typ image, document oder location steht der Dateiname oder "<lat>,<lng>" in message. Das Re-Hosting von Medien mit einer echten URL folgt in einem späteren Release. Erwähne daher vorerst einfach den Typ, damit deine Kollegen wissen, dass ein Anhang eingegangen ist.
Wiederholungen 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 Slack-Kanal bei jeder Wiederholung eine doppelte Nachricht. Verwende in der Produktion kein Set im Arbeitsspeicher, das bei einem Neustart verschwindet, sondern eine Unique-Constraint auf X-TextMeFlow-Event-Id in deiner Datenbank, sodass ein doppeltes Einfügen einfach fehlschlägt und ignoriert wird.
Weiter ausbauen
Dieser Grundablauf lässt sich in wenigen Minuten erweitern: Leite Nachrichten anhand der to-Nummer in verschiedene Slack-Kanäle (praktisch bei mehreren verbundenen Geräten ab dem Business-Tarif), oder füge einen „Antworten“-Button hinzu, der über den Endpunkt /v1/messages eine Antwort an den Kunden schickt, ohne dass jemand WhatsApp selbst öffnen muss. Die vollständige Feldreferenz und die Header-Liste stehen in der Webhook-Dokumentation.
Willst du das selbst ausprobieren? Der kostenlose Tarif bietet dir 50 Nachrichten pro Monat, für immer, genug, um diesen ganzen Ablauf aufzusetzen und zu validieren, bevor du auf einen kostenpflichtigen Tarif wechselst. Kostenlos starten.
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