Routing

Ścieżka od wysyłki do telefonu.

Skonfiguruj w:

Bird dociera do 150+ krajów przez 240 bezpośrednich połączeń do operatorów. Gdy ścieżka operatora ulega pogorszeniu, przebieramy trasę w czasie rzeczywistym, zanim wyjdzie następna wiadomość. A każda wysyłka zwraca potwierdzenie dostarczenia od operatora, więc zawsze wiesz, czy telefon ją otrzymał.

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

Warstwa, na której jedzie Twoja wysyłka.

Routing to warstwa pod API SMS od Bird. Wywołujesz jeden endpoint z polem from, to i tekstem; pod spodem ustalamy operatora odbiorcy, wybieramy połączenie i przekazujemy wiadomość. Gdy ścieżka się psuje, trasa się zmienia, a Twój kod nie.

Co warstwa routingu decyduje za Ciebie.

Ustalane per wiadomość, za jednym wywołaniem API.

01
Bezpośrednie połączenia do operatorów.
240 połączeń łączy nas wprost z operatorami komórkowymi w 150+ krajach. Żadnego łańcucha resellerów siedzącego między Twoją wysyłką a SMSC operatora.
02
Przebieranie trasy w czasie rzeczywistym.
Obserwujemy dostarczalność i opóźnienia na każdej ścieżce. Gdy trasa operatora zaczyna się pogarszać, następna wiadomość obiera zdrowsze połączenie do tego samego operatora. Failover następuje, zanim to zauważysz.
03
Lookup MNP przed wysyłką.
Przy każdej wysyłce ustalamy aktualnego operatora odbiorcy, więc przeniesiony numer jest routowany do operatora, który faktycznie go obsługuje, a nie do tego, u którego został wydany.
04
Potwierdzenie dostarczenia dla każdej wiadomości.
Własny DLR operatora wraca jako webhook sms.delivered lub sms.failed, niosąc sieć, w której wiadomość wylądowała, i czas, jaki to zajęło. Żadnego zgadywania z Twojej strony.
05
Najtańszy lub najwyższej jakości, per trasa.
Routing waży koszt względem jakości dostarczania dla każdego kraju docelowego. Ruch transakcyjny faworyzuje najszybszą, najbardziej niezawodną ścieżkę; ruch masowy może skłaniać się ku najniższemu kosztowi.

Dlaczego direct-to-carrier bije łańcuch agregatorów.

Duża część ruchu SMS przechodzi przez dwóch lub trzech resellerów, zanim dotrze do operatora. Każdy przeskok dodaje miejsce, w którym wiadomość może utknąć, cena może wzrosnąć, a potwierdzenie dostarczenia może zostać zgubione lub sfałszowane. Bezpośrednie połączenie usuwa tych pośredników: wiadomość idzie od Bird do operatora, a potwierdzenie wraca tą samą drogą. Właśnie tak około 40% komercyjnego ruchu SMS na świecie już przebiega przez tę sieć, z 95% wiadomości dostarczonych w czasie poniżej 2.5 sekundy.

Potwierdzenie dostarczenia, prosto od operatora.

Wysyłka zwraca 202; wynik przychodzi jako podpisany webhook niosący DLR operatora. Ładunek mówi Ci, w jakiej sieci wiadomość wylądowała, jaki to kraj docelowy i jakie było opóźnienie w obie strony.

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 identyfikuje dokładną sieć komórkową, która przyjęła wiadomość; wartość różna od macierzystego operatora numeru to Twój sygnał, że odbiorca przeniósł numer.

sms.deliveredOperator potwierdził, że telefon otrzymał wiadomość (DLR).
sms.failedOperator odrzucił lub nie mógł dostarczyć — z dołączonym powodem.

Routing opiera się na analizie numerów.

Lookup MNP, który wybiera właściwego operatora, to ta sama analiza numerów, którą możesz wywołać samodzielnie za pomocą Lookup — typ linii, aktualny operator i przenośność, zanim wyślesz. Gdy wiadomość jest już w drodze, podłącz webhooki po potwierdzenie dostarczenia i przeczytaj opis błędów, aby obsłużyć każdy kod awarii, lub sprawdź przewodnik po dostarczalności, aby dowiedzieć się, co mówią potwierdzenia.

FAQ dotyczące routingu SMS

Co oznacza routing direct-to-carrier?+

Twoja wiadomość trafia bezpośrednio do operatora komórkowego jednym z naszych 240 bezpośrednich połączeń, a nie przez łańcuch resellerów. Mniej przeskoków oznacza mniej miejsc, w których wiadomość może utknąć lub potwierdzenie dostarczenia może zaginąć.

Co się dzieje, gdy trasa operatora ulega pogorszeniu?+

Bird przebiera trasę w czasie rzeczywistym. Jeśli ścieżka zaczyna gubić potwierdzenia lub zwalniać, następna wiadomość obiera zdrowsze połączenie do tego samego operatora, a wysyłka, którą napisałeś, nigdy się nie zmienia.

Skąd mam wiedzieć, że wiadomość faktycznie dotarła do telefonu?+

Każda wiadomość zwraca potwierdzenie dostarczenia od operatora jako webhook sms.delivered lub sms.failed, niosący mcc_mnc, country i latency_ms. To własne potwierdzenie operatora, a nie wnioskowanie z naszej strony.

Czy sprawdzacie operatora odbiorcy przed wysyłką?+

Tak. Przy każdej wysyłce wykonujemy lookup MNP, aby ustalić aktualnego operatora odbiorcy, więc przeniesiony numer jest routowany do operatora, który faktycznie go obsługuje. Po samodzielną analizę numerów zobacz Lookup.

Czy mogę wybrać routing najtańszy zamiast najwyższej jakości?+

Routing równoważy koszt i jakość dostarczania per kraj docelowy. Ruch transakcyjny, taki jak jednorazowe kody dostępu, faworyzuje ścieżkę najwyższej jakości; ruch masowy może skłaniać się ku najniższemu kosztowi. Wybór następuje per wiadomość, za tym samym wywołaniem API.

Reszta platformy SMS

Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.

WysyłanieAPI wysyłki: segmenty, bezpieczeństwo Unicode, wsadowość i idempotencja.NumeryLong codes, short codes, toll-free i alfanumeryczne identyfikatory nadawcy.Komunikacja dwukierunkowaPrzychodzące SMS-y i odpowiedzi konwersacyjne jako webhooki podpisane HMAC.ZgodnośćRejestracja A2P 10DLC, opt-out STOP/HELP i reguły identyfikatora nadawcy.AnalitykaMetryki dostarczalności i zaangażowania z potwierdzeń dostarczenia operatorów.Przegląd API SMSPełne API SMS: wysyłanie, numery, komunikacja dwukierunkowa, zgodność, routing i analityka.

Routing, o którym nigdy nie musisz myśleć.

Zasięg, łączność z operatorami, failover i potwierdzenia dostarczenia to jedna z możliwości API SMS od Bird, na infrastrukturze, którą prowadzimy od dekady.

Poznaj platformę SMS Rozpocznij