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: "+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 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.
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.
{
"type": "sms.opted_out",
"data": {
"from": "+15005550006",
"keyword": "STOP",
"suppressed": true
}
}
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.
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.