WhatsApp an E-Mail weiterleiten per Webhook
Nicht jedes Team lebt in Slack oder Teams. Viele KMU — eine Werkstatt, ein Steuerbüro, ein Friseursalon mit zwei Filialen — arbeiten noch mit einem gemeinsamen Postfach wie info@ oder support@. Antwortet ein Kunde per WhatsApp auf eine Terminerinnerung oder eine Rechnung, soll diese Antwort auch dort landen, ohne dass jemand den ganzen Tag das TextMeFlow-Postfach offen haben muss. Dieser Artikel baut einen kleinen Endpoint, der jede eingehende WhatsApp-Nachricht per TextMeFlow-Webhook in eine E-Mail umwandelt.
Das Prinzip ist identisch zur Weiterleitung an Slack oder Microsoft Teams: TextMeFlow sendet die rohen Nachrichtendaten an deinen Server, du prüfst sie und übersetzt sie in den Kanal, den dein Team bereits nutzt.
Was du brauchst
- Ein TextMeFlow-Konto mit verknüpfter WhatsApp-Nummer und einer in
/admin/webhookeingerichtetenwebhook_url - Eine Möglichkeit, aus Code heraus E-Mails zu versenden: ein SMTP-Konto (dein eigener Mailserver oder Gmail/Outlook mit App-Passwort) oder eine transaktionale E-Mail-API wie Postmark, Mailgun oder Resend
- Ein kleiner Server (in diesem Beispiel Node/Express)
Schritt 1: E-Mail-Versand einrichten
Nutze in Produktion eine transaktionale E-Mail-API statt deines eigenen Mailservers — sie übernimmt Bounce-Handling und sorgt für bessere Zustellbarkeit. Mit Nodemailer funktioniert jeder SMTP-Anbieter gleich:
const nodemailer = require('nodemailer');
const mailer = nodemailer.createTransport({
host: process.env.SMTP_HOST,
port: 587,
auth: { user: process.env.SMTP_USER, pass: process.env.SMTP_PASS },
});
Schritt 2: den Webhook-Endpoint verifizieren
Für jede eingehende Nachricht sendet TextMeFlow einen JSON-Body, signiert mit HMAC-SHA256 im Header X-TextMeFlow-Signature (Format: sha256=<hex>). Prüfe diese Signatur immer, bevor du dem Inhalt vertraust — sonst kann jeder, der deine Endpoint-URL errät, gefälschte Nachrichten einschleusen. Die vollständige Erklärung dieses Headers steht im Artikel zur Prüfung 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 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
forwardToEmail(JSON.parse(raw));
});
app.listen(3000);
Bestätige immer zuerst mit 200, bevor du verarbeitest — TextMeFlow erwartet eine Antwort innerhalb von 10 Sekunden, und ein langsamer SMTP-Aufruf darf diese Frist nicht gefährden.
Schritt 3: Nachricht in eine E-Mail umwandeln
Der Payload enthält type, from, from_name, to und message — dieselben Felder wie bei TextMeBot, eine bestehende Integration lässt sich also 1:1 migrieren. Baue daraus eine lesbare E-Mail:
async function forwardToEmail(payload) {
const { type, from, from_name, message } = payload;
const label = type === 'text' ? '' : ` (${type})`;
await mailer.sendMail({
from: '"WhatsApp-Posteingang" <[email protected]>',
to: '[email protected]',
replyTo: '[email protected]',
subject: `Neue WhatsApp-Nachricht von ${from_name || from}${label}`,
text: `${from_name || from} (+${from}) schrieb:\n\n${message}`,
});
}
Bei image, document oder location steht der Dateiname bzw. "<lat>,<lng>" in message — erwähne vorerst einfach den Typ im Betreff, damit dein Kollege weiß, dass ein Anhang unterwegs ist.
Threads pro Kunde behalten
Ein echter Nachteil von E-Mail gegenüber Slack: Es gibt keinen Kanal, daher kommen Nachrichten desselben Kunden als einzelne E-Mails an. Eine einfache Lösung ist ein fester Betreff pro Telefonnummer (z. B. WhatsApp — +32470123456), damit Gmail und Outlook sie automatisch zu einem Thread zusammenfassen:
subject: `WhatsApp — +${from}`,
So bleibt das ganze Gespräch mit diesem Kunden in einem einzigen Mail-Thread lesbar — auch wenn das gemeinsame Postfach von mehreren Personen verwaltet wird.
Retries und Idempotenz
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 obige seen-Prüfung landet bei jedem Retry eine doppelte E-Mail in deinem Postfach. Ersetze die Set in Produktion durch eine eindeutige Constraint auf X-TextMeFlow-Event-Id in deiner Datenbank, sodass ein doppelter Insert einfach fehlschlägt und ignoriert wird.
Weiter ausbauen
Dieser Basisablauf lässt sich schnell erweitern: E-Mails je nach to-Nummer an eine andere Adresse routen (praktisch bei mehreren verknüpften Geräten ab dem Business-Plan), oder einfache Regeln ergänzen, die eine rechnungsbezogene Nachricht an die Buchhaltung und eine Terminfrage an den Empfang schicken. Die vollständige Feldreferenz steht in der Webhook-Dokumentation.
Willst du das selbst ausprobieren? Der kostenlose Plan gibt dir dauerhaft 50 Nachrichten pro Monat — genug, um diesen gesamten Ablauf aufzubauen und zu testen, bevor du zu einem kostenpflichtigen Plan 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