Short codes

बड़े पैमाने पर भेजने के लिए बनाया गया।

Short code एक 5–6 अंकों का नंबर है जो हाई-वॉल्यूम one-to-many SMS के लिए बना है: मार्केटिंग, अलर्ट, और हाई-रेट OTP। Carrier हर प्रोग्राम को भेजने से पहले जाँचते हैं, इसलिए प्रोविज़निंग लीड टाइम मिनटों में नहीं बल्कि हफ़्तों में नापा जाता है।

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

Today at 2:14 PM

Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

Short code कहाँ फ़िट होता है।

Short code, Bird SMS numbers पर मौजूद चार sender types में से एक है, जो बड़े Bird SMS API का हिस्सा है। यह वह विकल्प है जिसे आप तब चुनते हैं जब एक नंबर को कई प्राप्तकर्ताओं तक हाई वॉल्यूम पहुँचाना हो — और आप प्रोविज़निंग स्पीड को उस थ्रूपुट और carrier भरोसे के बदले छोड़ने को तैयार हों जो इसके साथ आता है।

Short code आपको क्या देता है।

हाई थ्रूपुट, carrier-vetted, one-to-many के लिए बना।

  1. 01

    किसी भी sender type में सबसे ज़्यादा थ्रूपुट।

    Short code को इस तरह इंजीनियर किया गया है कि एक नंबर भारी आउटबाउंड लोड उठा सके, और यही वजह है कि उसी दिन का कैंपेन या अलर्ट फ़ैन-आउट समय पर पहुँचता है।

  2. 02

    Dedicated या shared।

    Dedicated short code लें और उसकी sending reputation सिर्फ़ आपकी होती है; इसे keywords के पीछे शेयर करें ताकि तेज़ और सस्ते में शुरू कर सकें, इस कीमत पर कि आप अपने पड़ोसियों की reputation विरासत में पाते हैं।

  3. 03

    भेजने से पहले carrier-vetted।

    हर short code प्रोग्राम की carrier समीक्षा करते हैं, इसलिए नंबर लाइव ट्रैफ़िक के तहत भरोसा कमाने के बजाय उनका भरोसा पहले से स्थापित करके आता है।

  4. 04

    one-to-many के लिए सबसे अच्छा।

    मार्केटिंग सेंड, ट्रांज़ैक्शनल अलर्ट, और हाई-रेट OTP — सब short code में फ़िट होते हैं। दो-तरफ़ा बातचीत वाले ट्रैफ़िक के लिए long code आमतौर पर बेहतर शुरुआती विकल्प है।

इसे खोजें, खरीदें, और रूट करें।

Short code प्रोविज़न करने में वही client और वही call shape इस्तेमाल होता है जो किसी भी अन्य sender type में — सिर्फ़ type फ़ील्ड बदलती है। देश और क्षमता के हिसाब से खोजें, नंबर खरीदें, और उसके inbound को किसी webhook पर पॉइंट करें।

short-code.ts
201 · purchased
const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "short-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

Vetting आपको थ्रूपुट दिलाती है।

ट्रेडऑफ़ सीधा है: short code अपना ऊँचा, carrier-भरोसेमंद थ्रूपुट पहले vetting से गुज़रकर कमाता है, इसलिए हफ़्तों की लीड टाइम की योजना बनाएँ। इसे तब चुनें जब किसी प्रोग्राम का वॉल्यूम उससे आगे बढ़ जाए जो long code सपोर्ट करता है, या जब आपको पहले दिन से ऊँची और अनुमानित sending rate चाहिए। अगर आपका ट्रैफ़िक दो-तरफ़ा और बातचीत वाला है, या वॉल्यूम मध्यम है, तो long code जल्दी लाइव होता है और शुरू करने में कम खर्चीला है।

Short code से जुड़े सामान्य सवाल

SMS short code क्या है?+
Short code एक 5–6 अंकों का नंबर है जिसे carrier हाई-वॉल्यूम one-to-many SMS के लिए मंज़ूरी देते हैं — मार्केटिंग कैंपेन, अलर्ट, और हाई-रेट OTP। यह सबसे ज़्यादा थ्रूपुट वाला sender type है, और भेजने से पहले इसे carrier vetting से गुज़रना पड़ता है।
Short code को प्रोविज़न होने में कितना समय लगता है?+
मिनटों में नहीं, हफ़्तों में योजना बनाएँ। Carrier हर short code प्रोग्राम को लाइव होने से पहले जाँचते हैं, इसलिए short code में एक असल लीड टाइम होता है — long code के उलट, जिसे आप खरीदते ही रजिस्ट्रेशन क्लियर होने के बाद भेजना शुरू कर सकते हैं।
Dedicated या shared short code?+
Dedicated short code सिर्फ़ आपका होता है, इसलिए इसकी sending reputation पूरी तरह आपकी अपनी होती है। Shared short code एक नंबर को कई senders के बीच keywords के पीछे बाँटता है — सस्ता, शुरू करने में तेज़, लेकिन आप उस पर मौजूद बाकी सबकी reputation विरासत में पाते हैं।
मुझे इसके बजाय long code कब इस्तेमाल करना चाहिए?+
जब ट्रैफ़िक दो-तरफ़ा और बातचीत वाला हो, या वॉल्यूम vetting और लीड टाइम को सही न ठहराता हो। Long code local, डिफ़ॉल्ट रूप से दो-तरफ़ा, और अपना 10DLC कैंपेन क्लियर होते ही लाइव हो जाता है।

अपने वॉल्यूम के मुताबिक sender type चुनें।

Short code, Bird SMS numbers surface पर मौजूद एक sender type है। जब वॉल्यूम और थ्रूपुट vetting को सही ठहराएँ तो इसे प्रोविज़न करें, और उसी API से inbound रूट करें जिससे आप भेजते हैं।

एक चैनल से शुरुआत करें।
तैयार होने पर बाकी जोड़ें।

एक test API key तुरंत आपकी है। जब आप payment method जोड़ते हैं और sender verify करते हैं, तब production अनलॉक हो जाता है।

Claude Code, Cursor या Codex इस्तेमाल कर रहे हैं? एक setup prompt कॉपी करें और आपका agent आपके लिए Bird CLI और skills इंस्टॉल कर देगा। अपना चुनें:

Cursor