Log SMS
Il log SMS, visibile nella pagina Messages, è il registro dei messaggi del tuo spazio di lavoro. Gli invii in uscita e le risposte in entrata compaiono in ordine cronologico inverso. Usalo per confermare un invio, seguire il ciclo di vita della consegna e ispezionare il conteggio dei segmenti, il costo e i dettagli dell'operatore. La pagina aggregata Metrics mostra le percentuali su tutti i messaggi; il log SMS ti permette di ispezionare un singolo messaggio. La pagina include anche Send SMS per invii singoli dalla dashboard.
L'elenco dei messaggi
Ogni riga corrisponde a un messaggio. Le colonne sono:
| Colonna | Contenuto |
|---|---|
| Status | Lo stato di consegna attuale del messaggio (vedi Stati) |
| From | Il mittente: il numero, il sender ID o lo short code da cui è stato inviato il messaggio |
| To | Il numero del destinatario |
| Message | L'inizio del corpo del messaggio (fai clic su di esso, o su un punto qualsiasi della riga, per aprire il messaggio) |
| Category | La categoria del messaggio, mostrata come badge breve (TXN, MKTG, AUTH, SVC) |
| Sent | Quando l'invio è stato accettato, come tempo relativo (passa il mouse sopra per il timestamp esatto) |
L'elenco è paginato, 25 messaggi per pagina; usa Prev e Next per spostarti tra le pagine.
Ricerca e filtri
Un log di messaggi si riempie in fretta, perciò la pagina apre con una ricerca per destinatario e quattro filtri. Sono combinabili: un filtro sullo stato più un intervallo di date restringe i risultati ai messaggi che soddisfano entrambi i criteri.
Ricerca per destinatario. La casella di ricerca corrisponde a un numero destinatario esatto in formato E.164. Digita il numero completo, ad esempio +31612345678, per trovare tutti i messaggi indirizzati a quel numero. La ricerca non corrisponde a sottostringhe.
Status. Filtra per uno o più stati di consegna. Lo stato è a selezione multipla, quindi puoi ad esempio mostrare tutto ciò che non è arrivato selezionando insieme Undelivered, Failed e Expired. Le opzioni sono gli stati elencati in Stati.
Category. Filtra per categoria del messaggio: Transactional, Marketing, Authentication o Service.
Direction. Filtra per Outbound o Inbound. Le risposte ai tuoi numeri vengono archiviate insieme ai tuoi invii, quindi Inbound mostra ciò che hai ricevuto.
Date. Filtra in base a quando il messaggio è stato inviato; scegli un intervallo predefinito o seleziona un intervallo personalizzato dal calendario.
Quando una combinazione di filtri non produce risultati, la pagina mostra uno stato senza risultati con un'azione Clear filters per tornare all'elenco completo.
Stati
Lo stato di un messaggio indica a che punto si trova nel ciclo di vita della consegna. Un messaggio procede da accepted verso una ricevuta terminale.
| Stato | Significato |
|---|---|
| Accepted | Bird ha accettato il messaggio e si prepara a consegnarlo a un operatore |
| Sent | Consegnato all'operatore; in attesa di una ricevuta di consegna |
| Delivered | L'operatore ha confermato la consegna al dispositivo |
| Undelivered | Mancata consegna non permanente: il dispositivo era spento, irraggiungibile o il contenuto è stato bloccato |
| Failed | Errore permanente; il messaggio non può essere consegnato |
| Rejected | Il messaggio è stato rifiutato (un controllo di policy, un addebito non riuscito o un operatore che lo ha respinto) |
| Expired | L'operatore ha cessato i tentativi e ha segnalato il messaggio come scaduto |
| Received | Un messaggio in entrata |
L'etichetta di stato indica se un messaggio è in transito, consegnato, ricevuto o non riuscito. Non basarti solo sul colore quando scorri i risultati.
Ispezionare un messaggio
Fai clic su una riga qualsiasi per aprire il messaggio in un pannello laterale. Ha due schede, Events e Details, e l'intestazione mostra il corpo del messaggio, lo stato attuale, il destinatario e la categoria. Mentre un messaggio è ancora in transito, il pannello si aggiorna automaticamente ogni pochi secondi, così un cambio di stato o una ricevuta di consegna compare senza dover ricaricare manualmente.
Events
La scheda predefinita è una timeline con timestamp per un singolo messaggio. Visualizza il flusso descritto in eventi SMS: Accepted, poi Sent, poi Delivered, oppure un evento di errore (Undelivered, Failed, Rejected, Expired). Gli eventi di consegna identificano l'operatore e l'MCC/MNC (la rete mobile). Gli eventi di errore mostrano la descrizione dell'errore; la scheda Details contiene il codice di errore.
Details
La scheda Details contiene i metadati del messaggio:
- Message ID, Direction, From, To e Category
- Segments: il conteggio dei segmenti fatturabili, la codifica (GSM_7BIT o UCS2) e il conteggio dei caratteri (vedi segmenti e codifica)
- Cost: l'importo e la valuta, una volta che il messaggio è stato tariffato
- Carrier e MCC/MNC: la rete di consegna, quando nota
- Sent, Handed to carrier e Delivered: i timestamp
- Error: la descrizione e il codice, per un messaggio che non è arrivato
- Eventuali Tags e Metadata impostati sull'invio
La maggior parte dei campi può essere copiata con un solo clic.
Le letture pubbliche di messaggi ed eventi coprono gli ultimi 30 giorni. Un ID messaggio più vecchio è fuori da quella finestra di lettura; conserva i record necessari alla tua applicazione rispettando le tue policy di conservazione e consenso.
Lo stesso log tramite API
L'elenco alla base di questa pagina è GET /v1/sms/messages, i cui filtri coprono stato, categoria, tag, destinatario esatto e finestra temporale. Recupera la timeline di un messaggio con GET /v1/sms/messages/{message_id}/events. Leggi il suo stato più recente con GET /v1/sms/messages/{message_id}, oppure consuma gli eventi webhook in tempo reale.
Passaggi successivi
Esplora le analitiche SMS per il flusso di reportistica completo e la messaggistica bidirezionale SMS per la gestione dei messaggi in entrata.
- Metriche SMS: monitora la percentuale di consegna aggregata, la percentuale di errore e il volume accettato.
- Eventi SMS: consulta il vocabolario degli eventi alla base della timeline.
- Invio SMS: costruisci un payload di invio con categorie, tag e metadati.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Comprendi il concettoWhat does a delivery receipt tell you?Segui il percorso di apprendimentoOperate messaging reliably
Ottieni un brief di implementazione