Every recipient can text STOP to opt out, HELP to get a help response, and START to opt back in. Bird honors these keywords automatically on every send and keeps a per-recipient suppression list you can query. No extra code on your side.
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 वह एक नियम है जो हमेशा चालू रहता है।
Opt-out handling Bird SMS API पर SMS compliance का हिस्सा है, और registration के विपरीत यह हर जगह लागू होता है जहाँ आप send करते हैं, बिना किसी setup के। आरक्षित keywords STOP, HELP, और START inbound messages में पहचाने जाते हैं और per recipient उन पर कार्रवाई की जाती है, इसलिए जो व्यक्ति opt out करता है वह आपके sends में तब तक opted out रहता है जब तक वह वापस आने का चुनाव न करे।
keywords कैसे व्यवहार करते हैं।
आरक्षित keywords, per recipient लागू।
- 01
STOP अपने आप suppress करता है।
जब कोई recipient STOP text करता है, तो Bird उसे suppression list में जोड़ देता है और उस नंबर पर आगे के sends को आपकी किसी कार्रवाई के बिना block कर देता है।
- 02
HELP एक help response लौटाता है।
जो recipient HELP text करता है उसे एक automatic help reply मिलता है, ताकि आप बिना कोई handler wire किए carriers की help-keyword आवश्यकता पूरी करें।
- 03
START उन्हें फिर से subscribe करता है।
Opt-out is reversible. A recipient who texts START is removed from suppression and can receive messages again. They're always in control.
- 04
Suppression list queryable है, per recipient।
audience बनाने से पहले API के जरिए जाँचें कि कोई नंबर suppress है या नहीं, ताकि opt-out कर चुका recipient किसी send में दोबारा न घुसे।
Opt-out एक signed event के रूप में आता है।
When a recipient opts out, Bird suppresses them and notifies your webhook with an sms_suppression.created event so your own records stay in sync. A suppression is the exact sender and recipient pair, so the payload names the originator it stops as well as the subscriber. The event is HMAC-signed like every Bird webhook.
{
"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 एक inbound flow है।
STOP, HELP, and START arrive the same way any reply does, as inbound messages on two-way numbers. Bird intercepts the reserved keywords and acts on them before they reach your application logic, so you get the suppression behavior for free and still see everything else your recipients send.
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.
अन्य compliance विषय
Opt-out तीन SMS compliance regimes में से एक है। बाकी देखें।
बिना कोई handler लिखे हर opt-out को honor करें।
Opt-out, Bird पर SMS compliance का एक regime है। STOP, HELP, और START हर send पर लागू किए जाते हैं, एक suppression list के साथ जिसे आप उसी API से query कर सकते हैं।