Opt-out

STOP bedeutet Stopp, automatisch.

Jeder Empfänger kann STOP zum Abmelden, HELP für eine Hilfeantwort und START zum erneuten Anmelden senden. Bird berücksichtigt diese Keywords bei jedem Versand automatisch und führt eine Sperrliste pro Empfänger, die Sie abfragen können — ohne zusätzlichen Code auf Ihrer Seite.

send-otp.ts

200 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

send-otp.ts

200 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

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.
Das Opt-out ist umkehrbar. Ein Empfänger, der START sendet, wird aus der Sperre entfernt und kann wieder Nachrichten empfangen — er hat stets die Kontrolle.
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.

Wenn ein Empfänger sich abmeldet, sperrt Bird ihn und benachrichtigt Ihren Webhook mit einem sms.opted_out-Ereignis, sodass Ihre eigenen Datensätze synchron bleiben. Das Ereignis ist HMAC-signiert wie jeder Bird-Webhook.

POST /webhooks/bird

sms.opted_out

{
  "type": "sms.opted_out",
  "data": {
    "from": "+15005550006",
    "keyword": "STOP",
    "suppressed": true
  }
}

Opt-out ist ein eingehender Ablauf.

STOP, HELP und START treffen auf dieselbe Weise ein wie jede Antwort — als eingehende Nachrichten auf Zwei-Wege-Nummern. Bird fängt die reservierten Keywords ab und führt sie aus, bevor sie Ihre Anwendungslogik erreichen, sodass Sie das Sperrverhalten kostenlos erhalten und dennoch alles andere sehen, was Ihre Empfänger senden.

Opt-out-FAQ

Muss ich STOP selbst verarbeiten?+

Nein. Bird erkennt STOP bei jedem Versand, sperrt den Empfänger und blockiert weitere Nachrichten an diese Nummer. Sie schreiben oder pflegen keinerlei Keyword-Logik.

Was bewirken STOP, HELP und START jeweils?+

STOP sperrt den Empfänger und stoppt Nachrichten. HELP liefert eine automatische Hilfeantwort. START hebt ein vorheriges Opt-out auf und meldet den Empfänger erneut an. Jedes wird pro Empfänger ausgeführt.

Kann ein Empfänger, der sich abgemeldet hat, zurückkehren?+

Ja. Das Opt-out ist umkehrbar. Ein Empfänger, der START sendet, wird von der Sperrliste entfernt und kann wieder Nachrichten empfangen. Die Entscheidung bleibt beim Empfänger.

Wie prüfe ich, ob eine Nummer gesperrt ist?+

Die Sperrliste ist eine abfragbare API-Ressource. Schlagen Sie eine Nummer nach, bevor Sie eine Zielgruppe aufbauen, sodass ein abgemeldeter Empfänger nie wieder in einen Versand gelangt.

Weitere Compliance-Themen

Opt-out ist eines von drei SMS-Compliance-Regelwerken. Sehen Sie sich den Rest an.

A2P 10DLCMarken- und Kampagnenregistrierung für US-Anwendungstraffic.Sender-ID-RegistrierungRegistrieren Sie alphanumerische Sender-IDs vorab, wo Länder es verlangen.Gesamte SMS-Compliance10DLC, Opt-out und Sender-ID-Registrierung an einer Stelle.SMS-API-ÜberblickDie vollständige SMS-API: Senden, Nummern, Zwei-Wege, Compliance, Routing und Analytics.

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.

SMS-Compliance entdecken Jetzt starten