Routing
Il percorso dall'invio al dispositivo.
Bird raggiunge oltre 150 paesi tramite 240 connessioni direct-to-carrier. Quando un percorso carrier si degrada, riselezioniamo la rotta in tempo reale, prima che il messaggio successivo parta. E ogni invio restituisce una ricevuta di consegna del carrier, così sai sempre se il dispositivo l'ha ricevuto.
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
Il layer su cui viaggia il tuo invio.
Il routing è il layer sotto l'API SMS di Bird. Chiami un unico endpoint con un from, un to e un text; sotto, risolviamo il carrier del destinatario, scegliamo una connessione e consegniamo il messaggio. Quando un percorso peggiora, la rotta cambia e il tuo codice no.
Cosa decide per te il layer di routing.
Risolto per messaggio, dietro un'unica chiamata API.
- 01
Connessioni direct-to-carrier.
240 connessioni ci collegano direttamente agli operatori mobili in oltre 150 paesi. Nessuna catena di rivenditori tra il tuo invio e l'SMSC del carrier.
- 02
Riselezione della rotta in tempo reale.
Monitoriamo consegna e latenza su ogni percorso. Quando una rotta carrier inizia a degradarsi, il messaggio successivo prende una connessione più sana verso lo stesso operatore. Il failover avviene prima che tu te ne accorga.
- 03
MNP lookup prima dell'invio.
Risolviamo il carrier attuale del destinatario a ogni invio, così un numero portato viene instradato verso l'operatore che lo detiene effettivamente anziché verso quello con cui è stato emesso.
- 04
Una ricevuta di consegna per ogni messaggio.
Il DLR stesso del carrier torna come webhook sms.delivered o sms.failed, che trasporta la rete su cui è arrivato e quanto ci ha messo. Nessuna congettura dal tuo lato.
- 05
Least-cost o highest-quality, per rotta.
Il routing soppesa il costo rispetto alla qualità di consegna per ogni destinazione. Il traffico transazionale predilige il percorso più veloce e affidabile; il traffico bulk può orientarsi verso il costo minore.
Perché il direct-to-carrier batte una catena di aggregatori.
Gran parte del traffico SMS passa attraverso due o tre rivenditori prima di raggiungere un operatore. Ogni passaggio aggiunge un punto in cui il messaggio può bloccarsi, il prezzo può salire e la ricevuta di consegna può essere persa o falsificata. Una connessione diretta elimina questi intermediari: il messaggio va da Bird al carrier e la ricevuta torna nello stesso modo. È così che circa il 40% degli SMS commerciali del mondo passa già attraverso questa rete, con il 95% dei messaggi consegnato in meno di 2,5 secondi.
La ricevuta di consegna, direttamente dal carrier.
Un invio restituisce 202; l'esito arriva come webhook firmato contenente il DLR del carrier. Il payload indica il carrier che ha preso in carico il messaggio e l'esatta rete mobile (MCC-MNC) su cui è stato recapitato.
{
"type": "sms.delivered",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"sms_id": "sms_4kT01Lq2m",
"workspace_id": "ws_8KQ2",
"to": "+15005550006",
"from": "Bird",
"tags": null,
"metadata": null,
"carrier": "Verizon",
"mcc_mnc": "311480"
}
}
mcc_mnc identifica l'esatta rete mobile che ha preso in carico il messaggio; un valore diverso dal carrier d'origine del numero è il tuo segnale che il destinatario ha portato il numero.
sms.deliveredIl carrier ha confermato che il dispositivo ha ricevuto il messaggio (DLR).sms.failedL'operatore ha rifiutato o non è riuscito a consegnare il messaggio, con il motivo allegato.
Il routing si appoggia alla number intelligence.
La ricerca MNP che seleziona l'operatore corretto è la stessa number intelligence che puoi richiamare autonomamente con Lookup: tipo di linea, operatore attuale e portabilità, prima dell'invio. Una volta che il messaggio è in transito, configura i webhook per la ricevuta di consegna e consulta il riferimento errori per gestire ogni codice di errore, oppure controlla la guida alla deliverability per capire cosa indicano le ricevute.
FAQ sul routing SMS
Cosa significa routing direct-to-carrier?
Cosa succede quando una rotta carrier si degrada?
Come faccio a sapere che un messaggio ha davvero raggiunto il dispositivo?
Controllate il carrier del destinatario prima di inviare?
Posso scegliere il routing least-cost rispetto a quello highest-quality?
Il resto della piattaforma SMS
Un'unica API, un unico set di chiavi. Esplora le altre funzionalità.
Un routing a cui non devi mai pensare.
Copertura, connettività con i carrier, failover e ricevute di consegna sono una delle funzionalità dell'API SMS di Bird, su un'infrastruttura che gestiamo da un decennio.