Opt-out

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

हर recipient opt out करने के लिए STOP, help response पाने के लिए HELP, और वापस opt in करने के लिए START text कर सकता है। Bird इन keywords को हर send पर अपने आप honor करता है और एक per-recipient suppression list रखता है जिसे आप query कर सकते हैं — आपकी ओर से कोई अतिरिक्त code नहीं।

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..."

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..."

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 को उलटा जा सकता है। जो recipient START text करता है उसे suppression से हटा दिया जाता है और वह फिर से messages पा सकता है — नियंत्रण हमेशा उनके पास रहता है।
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, और START उसी तरह आते हैं जैसे कोई भी reply आता है — two-way numbers पर inbound messages के रूप में। Bird आरक्षित keywords को intercept करता है और आपके application logic तक पहुँचने से पहले उन पर कार्रवाई करता है, इसलिए आपको suppression behavior मुफ्त में मिलता है और फिर भी आप वह सब कुछ देखते हैं जो आपके recipients भेजते हैं।

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 एक्सप्लोर करें शुरू करें