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

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:

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, ripetizione dei 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