Routing

Jalur dari pengiriman ke handset.

Siap dalam:

Bird menjangkau 150+ negara melalui 240 koneksi langsung ke operator. Saat sebuah jalur operator menurun, kami memilih ulang rute secara real time, sebelum pesan berikutnya keluar. Dan setiap pengiriman mengembalikan delivery receipt operator, sehingga Anda selalu tahu apakah handset menerimanya.

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

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

Layer yang ditumpangi pengiriman Anda.

Routing adalah layer di bawah Bird SMS API. Anda memanggil satu endpoint dengan from, to, dan text; di baliknya, kami menentukan operator penerima, memilih koneksi, dan menyerahkan pesannya. Saat sebuah jalur memburuk, rute berubah dan kode Anda tidak.

Apa yang diputuskan layer routing untuk Anda.

Ditentukan per pesan, di balik satu panggilan API.

01
Koneksi langsung ke operator.
240 koneksi menghubungkan kami langsung ke operator seluler di seluruh 150+ negara. Tanpa rantai reseller yang duduk di antara pengiriman Anda dan SMSC operator.
02
Pemilihan ulang rute real time.
Kami memantau pengiriman dan latensi pada setiap jalur. Saat sebuah rute operator mulai menurun, pesan berikutnya mengambil koneksi yang lebih sehat ke operator yang sama. Failover terjadi sebelum Anda menyadarinya.
03
Lookup MNP sebelum pengiriman.
Kami menentukan operator terkini penerima pada setiap pengiriman, sehingga nomor yang telah diporting diroute ke operator yang benar-benar memegangnya alih-alih operator asalnya.
04
Delivery receipt untuk setiap pesan.
DLR milik operator kembali sebagai webhook sms.delivered atau sms.failed, membawa jaringan tempat ia mendarat dan berapa lama waktunya. Tanpa tebak-tebakan dari sisi Anda.
05
Biaya terendah atau kualitas tertinggi, per rute.
Routing menimbang biaya terhadap kualitas pengiriman untuk setiap tujuan. Trafik transaksional mengutamakan jalur tercepat dan paling andal; trafik massal dapat condong ke biaya terendah.

Mengapa langsung ke operator mengalahkan rantai aggregator.

Banyak trafik SMS melewati dua atau tiga reseller sebelum mencapai operator. Setiap hop menambah tempat bagi pesan untuk tertahan, bagi harga untuk naik, dan bagi delivery receipt untuk dibuang atau dipalsukan. Koneksi langsung menghilangkan perantara itu: pesan berpindah dari Bird ke operator, dan receipt kembali dengan cara yang sama. Itulah cara sekitar 40% SMS komersial dunia sudah berjalan melalui jaringan ini, dengan 95% pesan terkirim dalam waktu di bawah 2,5 detik.

Delivery receipt, langsung dari operator.

Sebuah pengiriman mengembalikan 202; hasilnya datang sebagai webhook bertanda tangan yang membawa DLR operator. Payload-nya memberitahu Anda jaringan tempat ia mendarat, negara tujuan, dan latensi pulang-pergi.

POST /webhooks/bird

signed

{
  "type": "sms.delivered",
  "id":   "evt_7jR42x...",
  "created_at": "2026-05-19T15:42:01.221Z",
  "data": {
    "sms_id":     "sms_4kT01Lq2m",
    "from":       "Bird",
    "to":         "+15005550006",
    "mcc_mnc":    "310-260",
    "country":    "US",
    "latency_ms": 1284
  }
}

mcc_mnc mengidentifikasi jaringan seluler persis yang mengambil pesan; nilai yang berbeda dari operator asal nomor adalah sinyal Anda bahwa penerima telah diporting.

sms.deliveredOperator mengonfirmasi handset menerima pesan (DLR).
sms.failedOperator menolak atau tidak dapat mengirimkan — dengan alasan yang terlampir.

Routing bersandar pada intelijen nomor.

Lookup MNP yang memilih operator yang tepat adalah intelijen nomor yang sama yang dapat Anda panggil sendiri dengan Lookup — line type, operator terkini, dan portabilitas sebelum Anda mengirim. Begitu sebuah pesan berada di jalur, pasang webhook untuk delivery receipt dan baca referensi error untuk menangani setiap kode kegagalan, atau periksa panduan deliverability untuk memahami apa yang diberitahukan receipt.

FAQ routing SMS

Apa arti routing langsung ke operator?+

Pesan Anda diserahkan langsung ke operator seluler melalui salah satu dari 240 koneksi langsung kami, bukan melalui rantai reseller. Lebih sedikit hop berarti lebih sedikit tempat bagi pesan untuk tertahan atau delivery receipt untuk hilang.

Apa yang terjadi saat sebuah rute operator menurun?+

Bird memilih ulang rute secara real time. Jika sebuah jalur mulai membuang receipt atau melambat, pesan berikutnya mengambil koneksi yang lebih sehat ke operator yang sama, dan pengiriman yang Anda tulis tidak pernah berubah.

Bagaimana saya tahu sebuah pesan benar-benar mencapai handset?+

Setiap pesan mengembalikan delivery receipt operator sebagai webhook sms.delivered atau sms.failed, membawa mcc_mnc, country, dan latency_ms. Itu adalah konfirmasi operator sendiri, bukan kesimpulan dari sisi kami.

Apakah Anda memeriksa operator penerima sebelum mengirim?+

Ya. Kami menjalankan lookup MNP pada setiap pengiriman untuk menentukan operator terkini penerima, sehingga nomor yang telah diporting diroute ke operator yang benar-benar memegangnya. Untuk intelijen nomor mandiri, lihat Lookup.

Bisakah saya memilih biaya terendah dibanding kualitas tertinggi?+

Routing menyeimbangkan biaya dan kualitas pengiriman per tujuan. Trafik transaksional seperti one-time passcode mengutamakan jalur berkualitas tertinggi; trafik massal dapat condong ke biaya terendah. Pemilihan terjadi per pesan, di balik panggilan API yang sama.

Sisanya dari platform SMS

Satu API, satu set key. Jelajahi kemampuan lainnya.

PengirimanAPI pengiriman: segment, keamanan Unicode, batch, dan idempotency.NomorLong codes, short codes, toll-free, dan alphanumeric sender ID.Dua arahSMS inbound dan balasan percakapan sebagai webhook bertanda HMAC.KepatuhanRegistrasi A2P 10DLC, opt-out STOP/HELP, dan aturan sender ID.AnalitikMetrik pengiriman dan keterlibatan dari delivery receipt operator.Ikhtisar SMS APISMS API lengkap: pengiriman, nomor, dua arah, kepatuhan, routing, dan analitik.

Routing yang tak perlu Anda pikirkan.

Cakupan, konektivitas operator, failover, dan delivery receipt adalah salah satu kemampuan Bird SMS API, di atas infrastruktur yang telah kami jalankan selama satu dekade.

Jelajahi platform SMS Mulai sekarang