Setiap penerima dapat mengirim SMS STOP untuk berhenti berlangganan, HELP untuk mendapatkan respons bantuan, dan START untuk berlangganan kembali. Bird mematuhi kata kunci ini secara otomatis pada setiap pengiriman dan menyimpan daftar supresi per-penerima yang dapat Anda kueri. Tanpa kode tambahan di sisi Anda.
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: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
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 reversibel. Penerima yang mengirim SMS START akan dihapus dari daftar supresi dan dapat menerima pesan kembali. 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.
Ketika penerima memilih untuk berhenti berlangganan (opt out), Bird akan menekan mereka dan memberi tahu webhook Anda dengan event sms_suppression.created sehingga catatan Anda sendiri tetap sinkron. Penekanan adalah pasangan pengirim dan penerima yang tepat, sehingga payload menyebutkan originator yang dihentikan serta subscriber. Event ini ditandatangani dengan HMAC seperti setiap webhook Bird lainnya.
{
"type": "sms_suppression.created",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"suppression_id": "ssu_01krdgeqcxet5s7t44vh8rt9mg",
"workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
"destination": "+15005550006",
"originator": "+12025550188",
"reason": "keyword_stop"
}
}
Opt-out adalah alur inbound.
STOP, HELP, dan START masuk dengan cara yang sama seperti balasan lainnya, yaitu sebagai pesan masuk pada nomor dua arah. Bird menyadap kata kunci yang dicadangkan dan memprosesnya sebelum mencapai logika aplikasi Anda, sehingga Anda mendapatkan perilaku supresi secara gratis dan tetap dapat melihat semua pesan lain yang dikirim penerima Anda.
Terapkan dalam praktik.
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Topik kepatuhan lainnya
Opt-out adalah satu dari tiga rezim kepatuhan SMS. Lihat sisanya.
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.