WhatsApp-Menübot mit Node.js und Express bauen
Ein Keyword-Bot beantwortet jeweils eine Nachricht. Ein Menübot merkt sich, wo der Kunde im Gespräch steht — „1 für Support, 2 für Abrechnung“ und danach eine Folgefrage innerhalb dieses Zweigs. Dieses bisschen Zustand ist der Unterschied zwischen einem Bot, der nach Skript klingt, und einem, der sich wie ein echter Empfang anfühlt. In diesem Tutorial baust du einen in Node.js mit Express, mit der TextMeFlow-API zum Senden und Empfangen.
Was du brauchst
- Ein TextMeFlow-Konto mit einer per QR gekoppelten WhatsApp-Nummer (Einstiegsanleitung)
- Deinen API-Key und dein Webhook-Secret aus dem Portal
- Node.js 18+ mit installiertem
express
Schritt 1 — der Webhook-Endpunkt
TextMeFlow schickt jede eingehende Nachricht als JSON per POST an deine Webhook-URL, signiert mit HMAC-SHA256 im Header X-TextMeFlow-Signature (sha256=<hex>). Die einzige Express-spezifische Falle: Du musst den rohen Request-Body lesen, bevor eine JSON-Parsing-Middleware ihn anfasst, sonst schlägt die Signaturprüfung gegen neu serialisierte Bytes fehl. Hänge express.raw() deshalb gezielt an die Webhook-Route, nicht global:
import express from "express";
import crypto from "crypto";
const app = express();
const WEBHOOK_SECRET = process.env.TMF_WEBHOOK_SECRET;
const API_KEY = process.env.TMF_API_KEY;
const API_URL = "https://api.textmeflow.eu/v1/messages";
app.post(
"/webhook",
express.raw({ type: "application/json" }),
async (req, res) => {
const expected =
"sha256=" +
crypto.createHmac("sha256", WEBHOOK_SECRET).update(req.body).digest("hex");
const received = req.header("X-TextMeFlow-Signature") || "";
const a = Buffer.from(expected);
const b = Buffer.from(received);
if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
return res.sendStatus(401);
}
const event = JSON.parse(req.body);
await handleMessage(event);
res.sendStatus(200);
}
);
crypto.timingSafeEqual wirft einen Fehler, wenn die beiden Buffer nicht gleich lang sind, also prüfe das zuerst — eine abweichende Länge bedeutet einfach „falsche Signatur“, keinen Absturz. Die vollständige Referenz zu Headern und Wiederholungsversuchen steht in der Anleitung zu Webhook-Signaturen.
Schritt 2 — Gesprächsstatus speichern
Eine Map mit der Absendernummer als Schlüssel genügt für einen Bot, der in einem einzelnen Prozess läuft:
const sessions = new Map(); // phone -> { step: string }
async function handleMessage(event) {
const from = event.from;
const text = (event.message || "").trim().toLowerCase();
const session = sessions.get(from) || { step: "root" };
let reply;
if (session.step === "root") {
if (text === "1") {
reply = "Support — beschreibe dein Problem in einer Nachricht, wir melden uns bei dir.";
session.step = "support";
} else if (text === "2") {
reply = "Abrechnung — antworte mit deiner Bestellnummer.";
session.step = "billing";
} else {
reply = "Hallo! Antworte mit 1 für Support oder 2 für Abrechnung.";
}
} else if (session.step === "support" || session.step === "billing") {
reply = "Danke, jemand aus dem Team meldet sich in Kürze bei dir.";
session.step = "root"; // nach Abschluss des Zweigs zurücksetzen
}
sessions.set(from, session);
if (reply) await sendMessage(from, reply);
}
Zwei Dinge sind für die Korrektheit entscheidend: Setze step wieder auf root, sobald ein Zweig abgeschlossen ist (sonst hängt der Kunde fest), und behandle jede unbekannte Eingabe in root als Menüaufforderung statt mit Schweigen — anders als ein reiner Keyword-Bot sollte ein Menübot dem Kunden immer sagen, welche Optionen er hat.
Schritt 3 — die Antwort senden
async function sendMessage(to, text) {
const res = await fetch(API_URL, {
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ to, text }),
});
if (!res.ok) throw new Error(`send failed: ${res.status}`);
}
Antworten zählen auf das monatliche Kontingent deines Tarifs und auf die Rate Limits pro Konto. Ein Menübot, der echten Kunden antwortet, bleibt zum Testen also locker innerhalb der 50 Nachrichten pro Monat im Gratis-Tarif oder im Produktivbetrieb innerhalb der 500 pro Monat bei Starter.
Schritt 4 — die Anti-Spam-Pipeline respektieren
Zwei Dinge passieren automatisch, und du musst sie nicht in deinen Bot-Code einbauen: STOP (und Varianten) wird auf API-Ebene verarbeitet, sodass ein abgemeldeter Empfänger bereits blockiert ist, bevor dein Webhook erneut auslöst, und Nachrichten, die zwischen 22:00 und 08:00 Uhr Ortszeit des Empfängers gesendet werden, werden auf 08:00 Uhr verschoben, außer du setzt "urgent": true — das lohnt sich eher bei einer Abrechnungsbestätigung als bei einer Menüantwort, die bis zum Morgen warten kann.
Schritt 5 — starten und testen
export TMF_API_KEY=... TMF_WEBHOOK_SECRET=...
node server.js
Mach den Port während der Entwicklung über einen Tunnel (ngrok oder ähnlich) erreichbar, trage diese URL im TextMeFlow-Portal als Webhook-Endpunkt ein und schreib an deine eigene Nummer, um das Menü durchzuspielen.
Skalieren über einen Prozess hinaus
Eine Map im Arbeitsspeicher verschwindet bei einem Neustart und teilt ihren Zustand nicht zwischen mehreren Serverinstanzen. Sobald du mehr als einen Prozess betreibst — oder Multi-Device im Business-Tarif nutzt — ersetze sie durch Redis mit kurzer TTL (eine Menüsitzung, die 30 Minuten inaktiv war, sollte ohnehin zurückgesetzt werden).
Bereit, das an einer echten Nummer auszuprobieren? Der Gratis-Tarif enthält 50 Nachrichten pro Monat, für immer — genug, um den kompletten Ablauf zu bauen und zu testen. Erstelle dein kostenloses Konto.
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