Routing

Il percorso dall'invio al dispositivo.

Configurazione in:

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.

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

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 che trasporta il DLR del carrier. Il payload ti dice la rete su cui è arrivato, il paese di destinazione e la latenza di andata e ritorno.

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 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.failedIl carrier ha rifiutato o non è riuscito a consegnare — con il motivo allegato.

Il routing si appoggia alla number intelligence.

L'MNP lookup che sceglie il carrier giusto è la stessa number intelligence che puoi richiamare a sé stante con Lookup — line type, operatore attuale e portabilità prima di inviare. Una volta che un messaggio è sul filo, configura i webhook per la ricevuta di consegna e leggi il riferimento agli errori per gestire ogni codice di fallimento, oppure consulta la guida alla deliverability per capire cosa ti dicono le ricevute.

FAQ sul routing SMS

Cosa significa routing direct-to-carrier?+

Il tuo messaggio passa direttamente all'operatore mobile attraverso una delle nostre 240 connessioni dirette, non attraverso una catena di rivenditori. Meno passaggi significa meno punti in cui un messaggio può bloccarsi o una ricevuta di consegna andare persa.

Cosa succede quando una rotta carrier si degrada?+

Bird riseleziona la rotta in tempo reale. Se un percorso inizia a perdere ricevute o a rallentare, il messaggio successivo prende una connessione più sana verso lo stesso operatore e l'invio che hai scritto non cambia mai.

Come faccio a sapere che un messaggio ha davvero raggiunto il dispositivo?+

Ogni messaggio restituisce una ricevuta di consegna del carrier come webhook sms.delivered o sms.failed, che trasporta mcc_mnc, paese e latency_ms. È la conferma dell'operatore stesso, non una deduzione dal nostro lato.

Controllate il carrier del destinatario prima di inviare?+

Sì. Eseguiamo un MNP lookup a ogni invio per risolvere l'operatore attuale del destinatario, così un numero portato viene instradato verso il carrier che lo detiene effettivamente. Per la number intelligence a sé stante, vedi Lookup.

Posso scegliere il routing least-cost rispetto a quello highest-quality?+

Il routing bilancia costo e qualità di consegna per destinazione. Il traffico transazionale come i codici monouso predilige il percorso di qualità più alta; il traffico bulk può orientarsi verso il costo minore. La selezione avviene per messaggio, dietro la stessa chiamata API.

Il resto della piattaforma SMS

Un'unica API, un unico set di chiavi. Esplora le altre funzionalità.

InvioL'API di invio: segmenti, sicurezza Unicode, batch e idempotency.NumeriLong code, short code, toll-free e alpha sender ID.BidirezionaleSMS in entrata e risposte conversazionali come webhook firmati con HMAC.ConformitàRegistrazione A2P 10DLC, opt-out STOP/HELP e regole sui sender ID.AnalisiMetriche di consegna ed engagement dalle ricevute di consegna dei carrier.Panoramica dell'API SMSL'API SMS completa: invio, numeri, bidirezionale, conformità, routing e analisi.

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.

Esplora la piattaforma SMS Inizia ora