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 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.`,
category: "authentication",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
Today at 2:14 PM
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.
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.
{
"type": "sms.opted_out",
"data": {
"from": "+15005550006",
"keyword": "STOP",
"suppressed": true
}
}
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.