Opt-out

STOP znaczy stop, automatycznie.

Każdy odbiorca może wysłać STOP, aby zrezygnować, HELP, aby otrzymać odpowiedź pomocniczą, oraz START, aby ponownie się zapisać. Bird uwzględnia te słowa kluczowe automatycznie przy każdej wysyłce i prowadzi listę blokad per odbiorca, którą możesz odpytywać — bez dodatkowego kodu po Twojej stronie.

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 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.
Opt-out jest odwracalny. Odbiorca, który wyśle START, zostaje usunięty z blokad i może ponownie otrzymywać wiadomości — zawsze ma 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.

POST /webhooks/bird

sms.opted_out

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

Opt-out to przepływ przychodzący.

STOP, HELP i START przychodzą tak samo jak każda odpowiedź — jako wiadomości przychodzące na numerach dwukierunkowych. Bird przechwytuje zastrzeżone słowa kluczowe i obsługuje je, zanim dotrą do logiki Twojej aplikacji, więc otrzymujesz zachowanie blokowania za darmo i nadal widzisz wszystko inne, co wysyłają Twoi odbiorcy.

FAQ dotyczące opt-out

Czy muszę samodzielnie obsługiwać STOP?+

Nie. Bird rozpoznaje STOP przy każdej wysyłce, blokuje odbiorcę i wstrzymuje dalsze wiadomości na ten numer. Nie piszesz ani nie utrzymujesz żadnej logiki słów kluczowych.

Co robi każde ze słów STOP, HELP i START?+

STOP blokuje odbiorcę i zatrzymuje wiadomości. HELP zwraca automatyczną odpowiedź pomocniczą. START cofa wcześniejszy opt-out i ponownie zapisuje odbiorcę. Każde jest obsługiwane per odbiorca.

Czy odbiorca, który zrezygnował, może wrócić?+

Tak. Opt-out jest odwracalny. Odbiorca, który wyśle START, zostaje usunięty z listy blokad i może ponownie otrzymywać wiadomości. Wybór pozostaje po stronie odbiorcy.

Jak sprawdzę, czy numer jest zablokowany?+

Lista blokad to zasób API, który można odpytywać. Sprawdź numer przed zbudowaniem grupy odbiorców, aby odbiorca, który zrezygnował, nigdy nie trafił ponownie do wysyłki.

Inne tematy zgodności

Opt-out to jeden z trzech reżimów zgodności SMS. Zobacz pozostałe.

A2P 10DLCRejestracja marki i kampanii dla ruchu aplikacyjnego w USA.Rejestracja identyfikatora nadawcyWstępna rejestracja alfanumerycznych identyfikatorów nadawcy tam, gdzie kraje tego wymagają.Cała zgodność SMS10DLC, opt-out i rejestracja identyfikatora nadawcy w jednym miejscu.Przegląd API SMSPełne API SMS: wysyłka, numery, komunikacja dwukierunkowa, zgodność, routing i analityka.

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.

Poznaj zgodność SMS Rozpocznij