WhatsApp-STOP-Antworten automatisch verarbeiten: Opt-out & CRM
Ein Kunde antwortet auf deine WhatsApp-Nachricht mit „STOP“. Was passiert dann – und was musst du noch tun? Bei TextMeFlow: nichts, denn das Opt-out wird automatisch auf API-Ebene verarbeitet. Hört aber dein CRM oder Ticketsystem nicht mit, bleibt diese Person in deinen eigenen Listen stehen, als wäre nichts geschehen. Dieser Artikel erklärt, wie der Opt-in/Opt-out-Mechanismus funktioniert und wie du ihn an deine eigenen Systeme anbindest.
Hinweis: Das sind allgemeine Informationen dazu, wie unsere Pipeline funktioniert, keine Rechtsberatung zu deinen Pflichten nach DSGVO oder ePrivacy-Regeln – wende dich dafür an einen Juristen.
Die Opt-in-Präambel: automatisch, solange du sie nicht abschaltest
Bei der allerersten Nachricht an einen neuen Empfänger setzt TextMeFlow automatisch eine kurze Zeile vor deine Nachricht:
Hallo! Du erhältst diese Nachrichten von {sender}. Antworte STOP, um sie zu beenden.
Dieses (Account, Empfänger)-Paar wird 90 Tage lang gespeichert – danach gehen weitere Nachrichten unverändert durch. Diese Präambel ist die günstigste Versicherung gegen eine Meta-Sperre, die es gibt, und ist standardmäßig aktiv. Du kannst sie pro Account im Portal abschalten, etwa bei Buchungsabläufen, in denen der Empfänger auf deinem eigenen Formular bereits ausdrücklich eingewilligt hat und der STOP-Text überflüssig wirkt. Wichtig: Das Abschalten der Präambel schaltet nicht die zugrunde liegende Zählung neuer Kontakte ab – sie läuft weiter für den Risikowert. Mehr zu diesem Wert und dazu, was ihn steigen lässt, liest du in unserer Erklärung des Risikowerts.
Welche Wörter ein Opt-out auslösen
TextMeFlow erkennt mehrere Varianten, nicht nur das englische „STOP“: STOP, STOPP, ARRÊT, BASTA, STOPPEN und UNSUBSCRIBE werden alle als Opt-out-Anfrage behandelt, unabhängig davon, in welcher Sprache du selbst sendest. Du musst dafür kein eigenes Keyword-Matching bauen – das geschieht auf Nachrichtenebene, noch bevor die Nachricht überhaupt deinen eigenen Webhook erreicht.
Was nach einem STOP passiert
Sobald ein Empfänger eines dieser Wörter zurückschickt, registriert TextMeFlow ein Opt-out für genau dieses (Account, Empfänger)-Paar. Ab diesem Moment werden alle weiteren Sendungen an diese Nummer mit dem Fehlercode recipient_opted_out abgelehnt – auch wenn du es versehentlich erneut aus einem Skript oder einem Bulk-Import versuchst. Das ist eine harte Sperre auf API-Ebene, nichts, was du vor dem Senden noch selbst prüfen müsstest. Versuchst du es trotzdem, zählt das außerdem für deinen Risikowert (+50 Punkte) – ein Grund mehr, dein eigenes System synchron zu halten, statt blind weiterzusenden.
Der opt_out-Webhook: dein CRM synchron halten
Das Blockieren des Versands ist dein Sicherheitsnetz, aber du willst nicht warten, bis jede Sendung scheitert, um zu wissen, wer sich abgemeldet hat. Deshalb sendet TextMeFlow im Moment des Opt-outs selbst ein Webhook-Ereignis vom Typ opt_out (konfigurierbar). Ein minimaler Handler sieht so aus:
app.post('/webhooks/textmeflow', (req, res) => {
const { event, data } = req.body;
if (event === 'opt_out') {
crm.markUnsubscribed(data.recipient, {
channel: 'whatsapp',
optedOutAt: data.timestamp,
});
}
res.sendStatus(200);
});
Die vollständige Ereignisliste und wie du die HMAC-Signatur jedes Aufrufs prüfst, findest du in unserer Anleitung zu Webhooks. Ohne diese Anbindung riskieren dein CRM oder dein E-Mail-Tool, jemanden weiter als „aktiven Kunden“ zu zeigen, obwohl WhatsApp für diese Person seit Monaten geschlossen ist – verwirrend für den Support und ein unnötiges Hindernis, falls der Kunde später erneut einwilligt und du einen neuen Opt-in-Moment brauchst.
Praktisch: Was das für dich bedeutet
- Baue keine eigene STOP-Erkennung – sie steckt schon in der Pipeline, für mehrere Sprachen gleichzeitig.
- Verlass dich nicht nur auf den Fehlercode beim Senden; abonniere
opt_out, damit dein CRM sofort aktuell ist und nicht erst beim nächsten fehlgeschlagenen Versand. - Lass die Opt-in-Präambel eingeschaltet, es sei denn, du bist sicher, dass deine Empfänger bereits dein eigenes Einwilligungsformular durchlaufen haben.
- Teste es selbst: Sende dir eine Nachricht, antworte STOP und prüfe, ob dein
opt_out-Webhook eingeht und ob ein zweiter Versand an dieselbe Nummer tatsächlich mitrecipient_opted_outabgelehnt wird.
Mehr dazu, wie die gesamte Anti-Spam-Pipeline aufgebaut ist, einschließlich Rate Limits und Ruhezeiten? Lies die vollständige Anti-Spam-Richtlinie. Willst du es selbst ausprobieren? Starte kostenlos mit 50 Nachrichten pro Monat, für immer – keine Kreditkarte nötig.
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