HarborOrganizationWorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
Il percorso da
invio a dispositivo.
Raggiungi i clienti tramite un'unica API di invio mentre Bird gestisce la connettività con gli operatori. Scegli le destinazioni supportate e il mittente appropriato, quindi segui l'esito di recapito riportato. Analizza gli errori per paese o operatore quando un percorso, un destinatario o una registrazione richiede attenzione.
Il percorso dietro al tuo messaggio
Flusso di invio
01
La tua applicazione
Scegli destinatario, mittente, categoria e messaggio.
02
Controlli su destinazione e mittente
Usa un mercato abilitato e la registrazione richiesta.
03
Consegna all'operatore
Bird invia il messaggio attraverso le proprie connessioni con gli operatori.
04
Un esito riportato
Segui la ricevuta nei record dei messaggi, nei webhook e nelle analisi.
Un flusso concettuale. Accettazione, consegna all'operatore e ricevuta di recapito descrivono fasi diverse del ciclo di vita del messaggio.
Il layer su cui viaggia il tuo invio.
Il routing si trova sotto la Bird SMS API. Bird verifica destinazione e mittente prima dell'accettazione, quindi invia il messaggio preparato al proprio trasporto operatore. Analizza l'operatore riportato e l'esito per decidere se indagare un problema di mittente, destinazione o destinatario.
Comprendi le decisioni prima della consegna all'operatore.
Idoneità, preparazione del messaggio e invio all'operatore hanno ruoli distinti.
- 01
Connettività con gli operatori.
Bird gestisce le connessioni con gli operatori dietro al tuo invio. Usa il catalogo delle destinazioni per verificare i tipi di mittente supportati e i requisiti di registrazione per i mercati che servi.
- 02
Un mittente e una destinazione preparati.
Tipo di mittente, regole di destinazione e registrazione determinano quale originatore può essere usato. Una configurazione valida viene stabilita prima che il messaggio venga messo in coda per il trasporto.
- 03
Informazioni sull'operatore quando disponibili.
L'elaborazione può risolvere l'operatore del destinatario per la tariffazione. Una ricerca mancante o fallita ricade sulla tariffazione per paese. Anche le informazioni sull'operatore nella ricevuta possono essere assenti; evita di dedurre la rete dal solo prefisso telefonico.
- 04
Ricevute di recapito come evidenza dell'operatore.
Una ricevuta dell'operatore può riportare il recapito o un esito terminale di mancato recapito. Alcuni messaggi restano in attesa di una ricevuta e i campi operatore mancanti sono sconosciuti. Leggi la cronologia degli eventi insieme allo stato attuale.
- 05
Discuti i requisiti di percorso per un lancio.
La richiesta pubblica SMS non offre un selettore di percorso a costo minimo o qualità massima. Discuti mix di destinazioni, requisiti del mittente e throughput con uno specialista SMS quando pianifichi traffico più elevato.
Un esito di recapito che puoi analizzare.
Un percorso SMS riuscito dipende dalla destinazione, dalla registrazione del mittente, dal contenuto del messaggio e dal percorso operatore. Bird riunisce queste decisioni in un unico flusso di invio. Parti dai requisiti della destinazione, quindi usa i record dei messaggi e gli esiti operatore per identificare cosa va modificato.
La ricevuta di consegna, direttamente dal carrier.
Una richiesta riuscita restituisce 202 prima del recapito dall'operatore. Gli eventi successivi possono includere l'operatore riportato e il MCC/MNC. Tratta i campi assenti come sconosciuti e analizza la cronologia del messaggio per le evidenze disponibili.
POST /webhooks/bird
signed
{
"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
}
}
}
I campi operatore e MCC/MNC vengono riportati quando disponibili. Una differenza rispetto alle aspettative basate sul prefisso è un motivo per indagare; non dimostra di per sé la portabilità del 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.
Usa Lookup quando la tua applicazione necessita di intelligence sui numeri di telefono supportata. Iscriviti ai webhook per gli esiti SMS e usa il riferimento errori e la guida alla recapitabilità per interpretare gli errori riportati. Un risultato di lookup non stabilisce l'idoneità del mittente né garantisce il recapito.
Domande prima di iniziare
Come verifico la copertura di destinazione?
Apri il catalogo delle destinazioni e consulta i tipi di mittente e i requisiti di registrazione per ciascun mercato. Anche il tuo spazio di lavoro deve consentire la destinazione prima che un invio venga accettato.
Cosa stabilisce una ricevuta dell'operatore?
Riporta un esito di consegna dall'operatore. Le ricevute possono arrivare dopo l'accettazione e il record del messaggio potrebbe essere ancora in sospeso. La consegna non misura se qualcuno ha letto o ha agito su un messaggio.
Come devo indagare su un percorso fallito?
Parti dallo stato del messaggio e dal motivo dell'errore. Confronta i report per operatore, paese o mittente, poi verifica la registrazione e la configurazione della destinazione. Un tasso di errore aggregato da solo non identifica la causa.
Posso ispezionare un numero di telefono separatamente?
Usa Lookup quando la tua applicazione ha bisogno di informazioni sul numero di telefono prima dell'invio. Esamina i segnali e la disponibilità per quella ricerca anziché trattare un report di consegna SMS come un controllo completo del numero.
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, parole chiave di opt-out e regole sul sender ID.AnalisiEsiti di recapito, cause di errore e latenza dalle ricevute operatore.Panoramica dell'API SMSL'API SMS completa: invio, numeri, bidirezionale, conformità, routing e analisi.Libreria di risorse SMSTrova guide, risposte approfondite e strumenti per il tuo prossimo passo.
Scala senza
perdere il controllo.
Organizza i team in spazi di lavoro, controlla l'accesso alle API e traccia le modifiche tramite log di audit.
HarborOrganizationActive
Audit log
Production- Workspace
- Production
- Resource
- Delivery agent
- ReadRead & write
Team Customer operationsActor role AdminOutcome SucceededTime 22 Sep, 09:42:18 UTC
Succeeded