Każdy odbiorca może wysłać STOP, aby zrezygnować, HELP, aby otrzymać odpowiedź pomocniczą, oraz START, aby ponownie wyrazić zgodę. Bird automatycznie obsługuje te słowa kluczowe przy każdym wysłaniu i prowadzi listę blokad dla poszczególnych odbiorców, którą możesz odpytywać. Bez dodatkowego kodu po Twojej stronie.
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: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
Opt-out to jedyna reguła, która jest zawsze włączona.
Obsługa opt-out to część zgodności SMS w API SMS od Bird i w przeciwieństwie do rejestracji obowiązuje wszędzie, gdzie wysyłasz, bez konfiguracji. Zastrzeżone słowa kluczowe STOP, HELP i START są rozpoznawane w wiadomościach przychodzących i obsługiwane per odbiorca, więc osoba, która zrezygnuje, pozostaje zrezygnowana we wszystkich Twoich wysyłkach, dopóki sama nie zdecyduje się wrócić.
Jak zachowują się słowa kluczowe.
Zastrzeżone słowa kluczowe, wymuszane per odbiorca.
- 01
STOP blokuje automatycznie.
Gdy odbiorca wyśle STOP, Bird dodaje go do listy blokad i wstrzymuje dalsze wysyłki na ten numer bez żadnego działania z Twojej strony.
- 02
HELP zwraca odpowiedź pomocniczą.
Odbiorca, który wyśle HELP, otrzymuje automatyczną odpowiedź pomocniczą, więc spełniasz wymóg operatorów dotyczący słowa kluczowego help bez podłączania własnego handlera.
- 03
START zapisuje go ponownie.
Rezygnacja jest odwracalna. Odbiorca, który wyśle START, zostaje usunięty z listy blokad i może ponownie otrzymywać wiadomości. Zawsze ma pełną kontrolę.
- 04
Listę blokad można odpytywać, per odbiorca.
Sprawdź przez API, czy numer jest zablokowany, zanim zbudujesz grupę odbiorców, aby odbiorca, który zrezygnował, nigdy nie wślizgnął się ponownie do wysyłki.
Opt-out przychodzi jako podpisane zdarzenie.
Gdy odbiorca rezygnuje, Bird go blokuje i powiadamia Twój webhook zdarzeniem sms.opted_out, dzięki czemu Twoje własne rekordy pozostają zsynchronizowane. Zdarzenie jest podpisane HMAC jak każdy webhook Bird.
{
"type": "sms.opted_out",
"data": {
"from": "+15005550006",
"keyword": "STOP",
"suppressed": true
}
}
Opt-out to przepływ przychodzący.
STOP, HELP i START docierają tak samo jak każda inna odpowiedź — jako wiadomości przychodzące na numery dwukierunkowe. Bird przechwytuje zarezerwowane słowa kluczowe i reaguje na nie, zanim trafią do logiki Twojej aplikacji — dzięki temu mechanizm blokowania dostajesz za darmo, a jednocześnie widzisz wszystko inne, co wysyłają Twoi odbiorcy.
Inne tematy zgodności
Opt-out to jeden z trzech reżimów zgodności SMS. Zobacz pozostałe.
Uwzględniaj każdy opt-out bez pisania handlera.
Opt-out to jeden z reżimów zgodności SMS w Bird. STOP, HELP i START są wymuszane przy każdej wysyłce, z listą blokad, którą możesz odpytywać z tego samego API.