Panoramica di SMS
Bird SMS invia messaggi di testo attraverso la stessa piattaforma e le stesse chiavi API di Bird Email. Chiama Bird con una chiave bk_{region}_… verso il tuo host regionale (https://us1.platform.bird.com o https://eu1.platform.bird.com). Bird sceglie un percorso verso l'operatore del destinatario, suddivide il testo in segmenti fatturabili e riporta ogni messaggio tramite la ricevuta di consegna. Gli endpoint SMS iniziano con /v1/sms/.
Puoi inviare testo libero con un mittente e una categoria a tua scelta, oppure usare uno dei template predefiniti di Bird, che fornisce corpo, categoria e mittente. Bird riceve anche le risposte ai tuoi numeri. Archivia ogni messaggio in entrata insieme ai tuoi invii e genera sms.received. Quando una risposta corrisponde a una parola chiave di opt-out supportata come STOP, Bird registra anche una soppressione mittente-destinatario. Consulta Opt-out e parole chiave per copertura e configurazione.
Come funziona l'invio
Invia un SMS con POST /v1/sms/messages: un destinatario e un messaggio, contenente il tuo text con mittente e categoria oppure un riferimento a un template con i relativi valori delle variabili. Bird valida la richiesta e la destinazione, risolve il mittente e restituisce 202 Accepted con un ID messaggio. La consegna avviene poi in modo asincrono. Segui l'esito tramite eventi e webhook o gli endpoint di lettura del messaggio. Per inviare molti messaggi indipendenti in una sola chiamata, usa il batch endpoint.
Tre concetti guidano l'intera API:
- Invio e consegna sono fasi separate. Un 202 significa che Bird ha accettato il messaggio. L'operatore lo elabora dopo l'accettazione e può restituire una ricevuta di consegna in seguito. Anche una ricevuta di errore è un esito terminale: controlla lo stato riportato prima di considerare l'invio come consegnato.
- Il testo viene fatturato in segmenti. Un messaggio più lungo di un segmento viene suddiviso e fatturato per segmento, e la capienza per segmento dipende dai caratteri utilizzati. Limiti di caratteri contiene le regole di codifica, il set completo di caratteri e come mantenere i messaggi in un solo segmento.
- Il motivo dell'invio conta. Ogni messaggio ha una categoria: transactional, marketing, authentication o service. Bird e gli operatori la usano per comprendere lo scopo del messaggio. In un invio tramite template, la categoria proviene dal template.
Prima del primo invio, abilita i paesi di destinazione che servi in SMS > Destinations. L'allowlist deny-by-default parte con il solo paese di origine della tua organizzazione abilitato. Bird rifiuta un invio verso qualsiasi altro paese. Sending SMS tratta questo prerequisito.
Per i codici di verifica monouso, considera Bird Verify invece di comporre il messaggio da solo. Verify genera e consegna il codice tramite SMS o email, verifica la risposta e applica scadenza, limiti di tentativi e tempi di attesa per il reinvio.
L'app SMS nella dashboard
Nella dashboard, SMS è uno dei prodotti nella barra laterale. Le sue pagine e dove si trova la guida di ciascuna:
| Pagina | A cosa serve |
|---|---|
| Messages | Ogni messaggio inviato, con la timeline degli eventi per messaggio e i dettagli di consegna. Guida: Log SMS |
| Templates | I template predefiniti che puoi inviare: nome, categoria, lingue e variabili. Guida: Template SMS |
| Metrics | Tasso di consegna, tasso di errore e volume accettato nel tempo. Guida: Metriche SMS |
| Senders | I sender ID e i numeri da cui puoi inviare, e dove ciascuno è registrato. Guida: Sender ID SMS |
| Destinations | I paesi verso cui il tuo spazio di lavoro può inviare; abilita una destinazione prima di inviare lì. Guida: Sending SMS |
Visibilità
Usa i record dei messaggi e la timeline degli eventi disponibile per verificare accettazione, passaggio all'operatore ed esiti di consegna. I dettagli del messaggio includono i segmenti e le eventuali componenti di costo tariffate. Le letture pubbliche dei messaggi coprono la finestra di conservazione descritta nel log SMS.
- Log SMS: la vista per messaggio nella dashboard. Ogni invio, la sua timeline degli eventi, segmenti, costo e dettagli dell'operatore.
- Metriche SMS: tasso di consegna aggregato, tasso di errore, volume accettato e latenza di consegna su tutto ciò che invii.
- Eventi: il vocabolario degli eventi SMS, il ciclo di vita del messaggio e la consegna dei webhook ai tuoi endpoint.
Prossimi passi
Esplora la piattaforma SMS per campagne, messaggi applicativi e risposte, oppure usa la libreria di risorse SMS per scegliere un flusso di lavoro.
| Pagina | Contenuto |
|---|---|
| Sending SMS | L'invio API: destinazioni, mittenti, corpo, segmenti, categorie, tag |
| Character limits | Codifica GSM-7 e UCS-2, limiti per segmento e il tetto di 12 segmenti |
| Template SMS | Il catalogo di template predefiniti e l'invio tramite riferimento a template |
| Sender ID SMS | Scelta del tipo di mittente e registrazione per paese di destinazione |
| Registrazione 10DLC | Registrazione di brand, campagna e numero per l'invio A2P negli Stati Uniti |
| Log SMS | Ogni messaggio, la sua timeline degli eventi, segmenti e costo |
| Metriche SMS | Tasso di consegna, tasso di errore e latenza |
| Eventi | I tipi di evento SMS e la consegna dei webhook |
| Webhook ed eventi | Configurazione degli endpoint, verifica della firma, ripetizioni e replay |
| Panoramica di Verify | Codici di verifica monouso tramite SMS ed email, inviati e verificati da Bird |
| Controllare dove il tuo account può inviare | Un video: mostra cosa restituisce un invio verso una destinazione disabilitata |
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaSMS pumping explainedComprendi il concettoWhat is SMS pumping, and how do I stop it?Esplora la funzionalitàSMS destinationsSegui il percorso di apprendimentoBuild your first integration
Ottieni un brief di implementazione