Bird reaches 190+ countries over 240 direct-to-carrier connections. When a carrier path degrades, we reselect the route in real time, before the next message goes out. And every send returns a carrier delivery receipt, so you always know whether the handset got it.
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"
वह layer जिस पर आपका send सवार होता है।
Routing Bird SMS API के नीचे की layer है। आप एक endpoint को from, to और text के साथ call करते हैं; इसके नीचे, हम recipient का carrier पता लगाते हैं, एक connection चुनते हैं, और मैसेज सौंप देते हैं। जब कोई path खराब होता है, route बदल जाता है और आपका code नहीं बदलता।
routing layer आपके लिए क्या तय करती है।
हर मैसेज पर तय, एक API call के पीछे।
- 01
Direct-to-carrier connections।
240 connections wire us straight into the mobile operators across 190+ countries. No reseller chain sitting between your send and the carrier's SMSC.
- 02
Real-time route reselection।
हम हर path पर delivery और latency पर नजर रखते हैं। जब कोई carrier route खराब होने लगता है, तो अगला मैसेज उसी ऑपरेटर तक किसी स्वस्थ connection से जाता है। Failover आपके ध्यान में आने से पहले हो जाता है।
- 03
send से पहले MNP lookup।
हम हर send पर recipient का मौजूदा carrier पता लगाते हैं, ताकि एक ported नंबर उस ऑपरेटर तक route हो जो असल में उसे रखता है, न कि उस तक जिससे वह जारी हुआ था।
- 04
हर मैसेज के लिए एक delivery receipt।
carrier का अपना DLR sms.delivered या sms.failed webhook के रूप में वापस आता है, जिसमें वह network होता है जहां वह पहुंचा और उसे कितना समय लगा। आपकी ओर से कोई अनुमान नहीं।
- 05
Least-cost या highest-quality, हर route पर।
Routing हर destination के लिए cost को delivery quality के मुकाबले तौलता है। Transactional traffic सबसे तेज, सबसे भरोसेमंद path को तरजीह देता है; bulk traffic least cost की ओर झुक सकता है।
क्यों direct-to-carrier एक aggregator श्रृंखला से बेहतर है।
बहुत सारा SMS traffic किसी ऑपरेटर तक पहुंचने से पहले दो या तीन resellers से होकर गुजरता है। हर hop मैसेज के अटकने, कीमत बढ़ने, और delivery receipt के गुम होने या नकली बनने के लिए एक जगह जोड़ देता है। एक direct connection इन बिचौलियों को हटा देता है: मैसेज Bird से carrier तक जाता है, और receipt उसी रास्ते वापस आती है। इसी तरह दुनिया के लगभग 40% commercial SMS पहले से इस network के जरिए चलते हैं, जिसमें 95% मैसेज 2.5 सेकंड से कम में delivered होते हैं।
delivery receipt, सीधे carrier से।
A send returns 202; the outcome arrives as a signed webhook carrying the carrier's DLR. The payload names the carrier that took the message and the exact mobile network (MCC-MNC) it landed on.
{
"type": "sms.delivered",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"sms_id": "sms_4kT01Lq2m",
"workspace_id": "ws_8KQ2",
"to": "+15005550006",
"from": "+12025550188",
"tags": null,
"metadata": null,
"carrier": "Verizon",
"mcc_mnc": "311480",
"cost": {
"amount": "0.0079",
"currency_code": "USD",
"transaction_amount": "0.0079",
"passthrough_amount": null
}
}
}
mcc_mnc उस सटीक मोबाइल network की पहचान करता है जिसने मैसेज लिया; नंबर के home carrier से अलग कोई value आपके लिए यह संकेत है कि recipient ने port कराया।
sms.deliveredcarrier ने पुष्टि की कि handset को मैसेज मिला (DLR)।sms.failedCarrier rejected or could not deliver, with the reason attached.
Routing number intelligence पर टिका है।
The MNP lookup that picks the right carrier is the same number intelligence you can call on its own with Lookup: line type, current operator, and portability before you send. Once a message is on the wire, wire up webhooks for the delivery receipt and read the error reference to handle each failure code, or check the deliverability guide for what the receipts tell you.
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.
बाकी का SMS platform
एक API, keys का एक सेट। बाकी क्षमताओं को एक्सप्लोर करें।
ऐसा routing जिसके बारे में आपको कभी सोचना ही न पड़े।
Coverage, carrier connectivity, failover, और delivery receipts — ये Bird SMS API की एक क्षमता हैं, उस infrastructure पर जिसे हम एक दशक से चला रहे हैं।