Bird dociera do ponad 190 krajów przez ponad 240 bezpośrednich połączeń z operatorami. Gdy ścieżka operatora ulega degradacji, zmieniamy trasę w czasie rzeczywistym — zanim kolejna wiadomość zostanie wysłana. Każde wysłanie zwraca potwierdzenie dostarczenia od operatora, więc zawsze wiesz, czy wiadomość dotarła na urządzenie.
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"
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 bezpośrednio z operatorami komórkowymi w ponad 190 krajach. Żadnego łańcucha pośredników między Twoją wiadomością a centrum 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 kod 202; wynik dociera jako podpisany webhook zawierający DLR od operatora. Ładunek wskazuje operatora, który przyjął wiadomość, oraz dokładną sieć komórkową (MCC-MNC), do której została dostarczona.
{
"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 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ł wiadomość lub nie mógł jej dostarczyć — powód jest dołączony do odpowiedzi.
Routing opiera się na analizie numerów.
Wyszukiwanie MNP, które wybiera właściwego operatora, to ta sama analiza numeru, którą możesz wywołać osobno za pomocą Lookup: typ linii, aktualny operator i przenośność numeru — jeszcze przed wysłaniem wiadomości. Gdy wiadomość jest już w drodze, skonfiguruj webhooki, aby otrzymywać potwierdzenia doręczenia, i zapoznaj się z dokumentacją kodów błędów, aby obsłużyć każdy kod awarii, lub sprawdź przewodnik po dostarczalności, aby dowiedzieć się, co mówią potwierdzenia odbioru.
Zastosuj w praktyce.
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Reszta platformy SMS
Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.
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.