Opt-out

STOP का मतलब रुकना है, अपने आप।

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.

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.`,
  category: "authentication",
}).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.`,
  category: "authentication",
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

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 के रूप में आता है।

जब कोई recipient opt out करता है, तो Bird उसे suppress कर देता है और आपके webhook को sms.opted_out event के साथ सूचित करता है ताकि आपके अपने records sync में रहें। हर Bird webhook की तरह यह event HMAC-signed होता है।

POST /webhooks/bird

sms.opted_out

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

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.

Opt-out FAQ

क्या मुझे STOP को खुद संभालना होगा?

नहीं। Bird हर send पर STOP को पहचानता है, recipient को suppress कर देता है, और उस नंबर पर आगे के messages को block कर देता है। आपको कोई keyword logic लिखना या maintain नहीं करना पड़ता।

STOP, HELP, और START में से हर एक क्या करता है?

STOP recipient को suppress करता है और messages रोक देता है। HELP एक automatic help response लौटाता है। START पहले किए गए opt-out को उलट देता है और recipient को फिर से subscribe कर देता है। हर एक पर per recipient कार्रवाई की जाती है।

क्या opt-out कर चुका recipient वापस आ सकता है?

हाँ। Opt-out को उलटा जा सकता है। जो recipient START text करता है, उसे suppression list से हटा दिया जाता है और वह फिर से messages पा सकता है। चुनाव recipient के पास रहता है।

मैं कैसे जाँचूँ कि कोई नंबर suppress है या नहीं?

Suppression list एक queryable API resource है। audience बनाने से पहले किसी नंबर को look up करें ताकि opt-out कर चुका recipient किसी send में दोबारा न आए।

अन्य compliance विषय

Opt-out तीन SMS compliance regimes में से एक है। बाकी देखें।

A2P 10DLCUS application traffic के लिए brand और campaign registration।Sender-ID registrationजहाँ देश अनिवार्य करते हैं वहाँ alphanumeric sender IDs को पहले से register करें।सभी SMS compliance10DLC, opt-out, और sender-ID registration एक ही जगह।SMS API अवलोकनपूरा SMS API: sending, numbers, two-way, compliance, routing, और analytics।

बिना कोई handler लिखे हर opt-out को honor करें।

Opt-out, Bird पर SMS compliance का एक regime है। STOP, HELP, और START हर send पर लागू किए जाते हैं, एक suppression list के साथ जिसे आप उसी API से query कर सकते हैं।

SMS compliance एक्सप्लोर करें शुरू करें