एक अल्फ़ान्यूमेरिक sender ID नंबर के बजाय आपके ब्रांड का नाम from फ़ील्ड में रखता है। कई देश आवश्यक बनाते हैं कि डिलीवर होने से पहले आप उस नाम को पहले से रजिस्टर करें। Bird रजिस्ट्रेशन फ़ाइल करता है और API के ज़रिए उसकी स्थिति रिपोर्ट करता है ताकि आपको पता चले कि sender कब लाइव है।
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"
कुछ senders को पहले रजिस्टर करने की ज़रूरत क्यों होती है।
Sender-ID registration Bird SMS API पर SMS compliance का हिस्सा है। स्पूफ़िंग रोकने के लिए, कई देश केवल उन्हीं अल्फ़ान्यूमेरिक sender ID को डिलीवर करते हैं जो स्थानीय कैरियर या नियामक के पास पहले से रजिस्टर हों। जहाँ यह लागू होता है, वहाँ बिना रजिस्टर किया गया ब्रांडेड sender अस्वीकार कर दिया जाता है या बदल दिया जाता है। Bird आपके लिए रजिस्ट्रेशन फ़ाइल करता है और उसकी स्थिति उजागर करता है, ताकि आप ऐसे sender में न भेजें जो अभी डिलीवर नहीं कर सकता।
रजिस्ट्रेशन कैसे काम करता है।
कहाँ यह ज़रूरी है, कौन इसे फ़ाइल करता है, और यह कब लाइव होता है।
- 01
जानें कि यह कहाँ ज़रूरी है।
किसी अल्फ़ान्यूमेरिक sender ID को रजिस्टर करने की ज़रूरत है या नहीं, यह डेस्टिनेशन देश पर निर्भर करता है। कुछ पूर्व-रजिस्ट्रेशन ज़रूरी बनाते हैं, कुछ डायनैमिक senders की अनुमति देते हैं, और कुछ अल्फ़ान्यूमेरिक की बिलकुल अनुमति नहीं देते।
- 02
Bird इसे आपके लिए फ़ाइल करता है।
sender ID और डेस्टिनेशन को dashboard से सबमिट करें। Bird आपकी ओर से रजिस्ट्रेशन को स्थानीय कैरियर या नियामक तक ले जाता है।
- 03
API के ज़रिए स्थिति ट्रैक करें।
अप्रूवल बाहरी रजिस्ट्री के ज़रिए होता है और इसमें कुछ दिनों से लेकर हफ़्तों तक का समय लगता है। रजिस्ट्रेशन की स्थिति पोल करें ताकि उस sender ID से भेजने से पहले आपका कोड उसका इंतज़ार करे।
- 04
यह अल्फ़ान्यूमेरिक senders पर लागू होता है।
रजिस्ट्रेशन अल्फ़ान्यूमेरिक sender ID को ही नियंत्रित करता है। नंबरों से भेजना — long codes, short codes, toll-free — इसके बजाय उन नंबर प्रकारों के नियमों का पालन करता है।
API से किसी रजिस्ट्रेशन की स्थिति जाँचें।
You file the sender ID from the dashboard; the requirements read tells you where it stands, one row per destination country. Branch on that row's status, and on whether the destination is switched on, before you send from that sender.
// The sender surface is not on the SDK yet, so read it over HTTP with a key
// carrying the sms_management:read scope.
const res = await fetch(
`https://eu1.platform.bird.com/v1/sms/senders/${senderId}/requirements`,
{ headers: { Authorization: `Bearer ${process.env.BIRD_API_KEY!}` } },
);
const { data: countries } = await res.json();
// Registration is decided per destination, so there is one row per country
// this sender can reach — never a single status for the sender itself.
const india = countries.find((c) => c.country_code === "IN");
// approved and not_required are the two statuses that satisfy a country.
// destination_enabled is a separate axis: a fully registered country still
// refuses the send while the workspace has it switched off.
if (india.status === "approved" && india.destination_enabled) {
// safe to send from this sender ID to India
}
रजिस्ट्रेशन अल्फ़ान्यूमेरिक sender का अनुसरण करता है।
यह अल्फ़ान्यूमेरिक sender IDs के पीछे का compliance चरण है। sender प्रकार आपको ब्रांड नाम से भेजने देता है जहाँ देश इसकी अनुमति देता है; रजिस्ट्रेशन वह है जो उस नाम को वहाँ डिलीवर करने योग्य बनाता है जहाँ देश पहले इसकी माँग करता है।
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.
अन्य compliance विषय
Sender-ID registration तीन SMS compliance व्यवस्थाओं में से एक है। बाकी देखें।
अपना sender ID रजिस्टर करें, फिर ब्रांडेड भेजें।
Sender-ID registration Bird पर SMS compliance की एक व्यवस्था है। dashboard से फ़ाइल करें, API के ज़रिए अप्रूवल ट्रैक करें, और जहाँ इसकी अनुमति हो वहाँ अपने ब्रांड नाम से भेजें।