Jeder Empfänger kann STOP senden, um sich abzumelden, HELP für eine Hilfe-Antwort und START, um sich wieder anzumelden. Bird berücksichtigt diese Schlüsselwörter automatisch bei jedem Versand und führt eine Unterdrückungsliste pro Empfänger, die Sie abfragen können. Kein zusätzlicher Code auf Ihrer Seite.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
Opt-out ist die eine Regel, die immer aktiv ist.
Die Opt-out-Verarbeitung ist Teil der SMS-Compliance auf der Bird SMS-API, und anders als die Registrierung gilt sie überall, wohin Sie senden, ohne Einrichtung. Die reservierten Keywords STOP, HELP und START werden in eingehenden Nachrichten erkannt und pro Empfänger ausgeführt, sodass eine Person, die sich abmeldet, über Ihre Sendungen hinweg abgemeldet bleibt, bis sie sich entscheidet, zurückzukehren.
Wie sich die Keywords verhalten.
Reservierte Keywords, pro Empfänger durchgesetzt.
- 01
STOP sperrt automatisch.
Wenn ein Empfänger STOP sendet, fügt Bird ihn der Sperrliste hinzu und blockiert weitere Sendungen an diese Nummer, ohne dass Sie etwas tun müssen.
- 02
HELP liefert eine Hilfeantwort.
Ein Empfänger, der HELP sendet, erhält eine automatische Hilfeantwort, sodass Sie die Help-Keyword-Anforderung der Carrier erfüllen, ohne einen Handler zu verdrahten.
- 03
START meldet ihn erneut an.
Die Abmeldung ist umkehrbar. Ein Empfänger, der START sendet, wird von der Unterdrückungsliste entfernt und kann wieder Nachrichten empfangen. Die Kontrolle liegt immer beim Empfänger.
- 04
Die Sperrliste ist abfragbar, pro Empfänger.
Prüfen Sie über die API, ob eine Nummer gesperrt ist, bevor Sie eine Zielgruppe aufbauen, sodass ein abgemeldeter Empfänger nie wieder in einen Versand rutscht.
Ein Opt-out trifft als signiertes Ereignis ein.
When a recipient opts out, Bird suppresses them and notifies your webhook with an sms_suppression.created event so your own records stay in sync. A suppression is the exact sender and recipient pair, so the payload names the originator it stops as well as the subscriber. The event is HMAC-signed like every Bird webhook.
{
"type": "sms_suppression.created",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"suppression_id": "ssu_01krdgeqcxet5s7t44vh8rt9mg",
"workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
"destination": "+15005550006",
"originator": "+12025550188",
"reason": "keyword_stop"
}
}
Opt-out ist ein eingehender Ablauf.
STOP, HELP und START treffen genauso ein wie jede andere Antwort – als eingehende Nachrichten auf Zwei-Wege-Nummern. Bird fängt die reservierten Schlüsselwörter ab und verarbeitet sie, bevor sie Ihre Anwendungslogik erreichen. So erhalten Sie das Unterdrückungsverhalten automatisch und sehen trotzdem alles andere, was Ihre Empfänger senden.
Weitere Compliance-Themen
Opt-out ist eines von drei SMS-Compliance-Regelwerken. Sehen Sie sich den Rest an.
Berücksichtigen Sie jedes Opt-out, ohne einen Handler zu schreiben.
Opt-out ist ein Regelwerk der SMS-Compliance bei Bird. STOP, HELP und START werden bei jedem Versand durchgesetzt, mit einer Sperrliste, die Sie über dieselbe API abfragen können.