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.
Per le risposte automatiche senza codice personalizzato, usa Automations con un trigger Incoming SMS e un passaggio Send SMS. Configurare le risposte SMS automatiche spiega la mappatura dei destinatari, i requisiti per ricevere e inviare, i filtri per parola chiave e l'anteprima prima della pubblicazione. Automations è in accesso anticipato e le sue azioni sono regolate dalle autorizzazioni dello spazio di lavoro.
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 l'endpoint batch.
Tre concetti guidano l'intera API:
- Invio e consegna sono fasi separate. Un
202significa 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,authenticationoservice. 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 rifiuta tutto per impostazione predefinita: Bird rifiuta un invio verso qualsiasi paese non abilitato nel tuo spazio di lavoro. Invio SMS tratta questo prerequisito e Invia il tuo primo SMS guida passo per passo il primo invio. Controlli per gli agenti mette questo elenco SMS accanto ai limiti di spesa SMS giornalieri, alle chiavi con ambito limitato e al portafoglio prepagato, e indica quali di questi una chiave che può solo inviare non è in grado di modificare.
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: Invio 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.
- Invia il tuo primo SMS: una chiave API, una destinazione, un invio con template predefinito e il relativo stato di consegna
- Invio SMS: il API di invio: destinazioni, mittenti, corpo, segmenti, categorie, tag
- Limiti di caratteri: 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 al template
- Sender ID SMS: scegliere un tipo di mittente e registrarlo per paese di destinazione
- Registrazione 10DLC: registrare un brand, una campagna e un 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, nuovi tentativi e replay
- Panoramica di Verify: codici di verifica monouso via SMS ed email, inviati e controllati da Bird
- Controllare dove il tuo account può inviare: un video che mostra cosa restituisce un invio verso una destinazione disabilitata
Risorse correlate
Continua con la documentazione, le guide e gli esempi per questo argomento.