Opt-out

STOP artinya berhenti, secara otomatis.

Setiap penerima dapat mengirim teks STOP untuk opt out, HELP untuk mendapat respons bantuan, dan START untuk opt in kembali. Bird menghormati keyword ini secara otomatis pada setiap pengiriman dan memelihara daftar supresi per penerima yang dapat Anda kueri — tanpa kode tambahan di sisi Anda.

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 adalah satu aturan yang selalu aktif.

Penanganan opt-out adalah bagian dari kepatuhan SMS di Bird SMS API, dan tidak seperti registrasi, ia berlaku di mana pun Anda mengirim, tanpa pengaturan. Keyword khusus STOP, HELP, dan START dikenali dalam pesan inbound dan ditindaklanjuti per penerima, sehingga orang yang opt out tetap opt out di seluruh pengiriman Anda sampai mereka memilih untuk kembali.

Bagaimana keyword berperilaku.

Keyword khusus, diberlakukan per penerima.

01
STOP mensupresi secara otomatis.
Saat penerima mengirim teks STOP, Bird menambahkannya ke daftar supresi dan memblokir pengiriman berikutnya ke nomor itu tanpa tindakan apa pun dari Anda.
02
HELP mengembalikan respons bantuan.
Penerima yang mengirim teks HELP mendapat balasan bantuan otomatis, sehingga Anda memenuhi persyaratan keyword bantuan operator tanpa memasang handler.
03
START mendaftarkan mereka kembali.
Opt-out bersifat dapat dibalik. Penerima yang mengirim teks START dihapus dari supresi dan dapat menerima pesan lagi — mereka selalu memegang kendali.
04
Daftar supresi dapat dikueri, per penerima.
Periksa apakah sebuah nomor disupresi melalui API sebelum Anda membangun audiens, agar penerima yang telah opt out tidak pernah menyelinap kembali ke pengiriman.

Opt-out datang sebagai event bertanda tangan.

Saat penerima opt out, Bird mensupresi mereka dan memberitahu webhook Anda dengan event sms.opted_out agar catatan Anda sendiri tetap selaras. Event ini ditandatangani HMAC seperti setiap webhook Bird.

POST /webhooks/bird

sms.opted_out

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

Opt-out adalah alur inbound.

STOP, HELP, dan START datang dengan cara yang sama seperti balasan apa pun — sebagai pesan inbound pada nomor dua arah. Bird mencegat keyword khusus dan menindaklanjutinya sebelum mencapai logika aplikasi Anda, sehingga Anda mendapatkan perilaku supresi secara gratis dan tetap melihat segala hal lain yang dikirim penerima Anda.

FAQ opt-out

Apakah saya harus menangani STOP sendiri?+

Tidak. Bird mengenali STOP pada setiap pengiriman, mensupresi penerima, dan memblokir pesan berikutnya ke nomor itu. Anda tidak perlu menulis atau memelihara logika keyword apa pun.

Apa yang dilakukan STOP, HELP, dan START masing-masing?+

STOP mensupresi penerima dan menghentikan pesan. HELP mengembalikan respons bantuan otomatis. START membalik opt-out sebelumnya dan mendaftarkan kembali penerima. Masing-masing ditindaklanjuti per penerima.

Bisakah penerima yang telah opt out kembali?+

Ya. Opt-out bersifat dapat dibalik. Penerima yang mengirim teks START dihapus dari daftar supresi dan dapat menerima pesan lagi. Pilihan tetap ada pada penerima.

Bagaimana saya memeriksa apakah sebuah nomor disupresi?+

Daftar supresi adalah resource API yang dapat dikueri. Telusuri sebuah nomor sebelum Anda membangun audiens agar penerima yang telah opt out tidak pernah masuk kembali ke pengiriman.

Topik kepatuhan lainnya

Opt-out adalah satu dari tiga rezim kepatuhan SMS. Lihat sisanya.

A2P 10DLCRegistrasi brand dan campaign untuk trafik aplikasi AS.Registrasi sender IDPra-registrasi alphanumeric sender ID di tempat yang diwajibkan negara.Semua kepatuhan SMS10DLC, opt-out, dan registrasi sender ID dalam satu tempat.Ikhtisar SMS APISMS API lengkap: pengiriman, nomor, dua arah, kepatuhan, routing, dan analitik.

Hormati setiap opt-out tanpa menulis handler.

Opt-out adalah satu rezim kepatuhan SMS di Bird. STOP, HELP, dan START diberlakukan pada setiap pengiriman, dengan daftar supresi yang dapat Anda kueri dari API yang sama.

Jelajahi kepatuhan SMS Mulai sekarang