Risposta breve
Gli stati dei rapporti di consegna SMS indicano al mittente cosa è successo a un messaggio dopo che l’operatore lo ha accettato. Nei rapporti SMPP 3.4, DELIVRD significa consegnato al telefono, UNDELIV non consegnabile, EXPIRED periodo di validità scaduto e REJECTD rifiutato dalla rete. Le API HTTP di solito li riportano a stati come DELIVERED o FAILED.
Cosa significano i valori stat di SMPP?
La specifica SMPP 3.4 fornisce un formato di rapporto di esempio con un campo stat che contiene lo stato finale del messaggio. Il testo esatto del rapporto dipende dall’SMSC, ma questi valori sono molto diffusi.
| stat | Significato | Causa tipica |
|---|---|---|
| DELIVRD | Consegnato al telefono | Successo normale |
| UNDELIV | Non consegnabile | Numero non valido, inattivo o bloccato |
| EXPIRED | Periodo di validità scaduto prima della consegna | Telefono spento o senza copertura troppo a lungo |
| REJECTD | Rifiutato dalla rete | Sender ID non registrato, contenuto o rotta bloccati |
| DELETED | Eliminato prima della consegna | Annullato sull’SMSC |
| ACCEPTD o UNKNOWN | Stato accettato oppure stato non valido o sconosciuto | Dipende dall’SMSC; chiedete al provider |
Come si collegano gli stati dei webhook della piattaforma?
Le API normalizzano i rapporti degli operatori in stati più semplici. Sulla piattaforma OmniChannels.ai ogni canale riporta SUBMITTED, SENT, DELIVERED, READ, FAILED e REJECTED. SUBMITTED e SENT sono provvisori; DELIVERED, FAILED e REJECTED sono finali per gli SMS. Gli stati possono arrivare fuori ordine, quindi non lasciate mai che un SENT tardivo sovrascriva un DELIVERED.
Come si legge un rapporto di consegna grezzo?
- Associate l’id del rapporto al message_id restituito da submit_sm_resp.
- Leggete stat per lo stato finale ed err per il codice di errore dell’operatore.
- Confrontate submit date e done date per vedere quanto è durata la consegna.
- Per i messaggi lunghi, aggregate i rapporti di ogni segmento prima di segnare il messaggio come consegnato.
Quali sono i limiti dei rapporti di consegna?
Alcuni operatori non restituiscono rapporti o li restituiscono in ritardo, e alcuni segnalano la consegna quando il messaggio ha raggiunto la rete e non il telefono. I falsi rapporti DELIVRD sono un segnale noto di rotte grigie. Considerate un rapporto una prova solida, non la certezza che il messaggio sia stato letto.