Definizione
Un rapporto di consegna (DLR) è un messaggio di stato restituito dalla rete dell’operatore che indica al mittente se un SMS è stato consegnato al telefono, è scaduto o non è riuscito, con data e ora e un codice di errore.
In SMPP v3.4 il mittente richiede un rapporto con il campo registered_delivery di submit_sm. L’SMSC lo restituisce poi come deliver_sm il cui esm_class lo contrassegna come rapporto di consegna.
La specifica SMPP fornisce un testo di rapporto di esempio (Appendice B) con i campi id, sub, dlvrd, submit date, done date, stat, err e text, e stati finali come DELIVRD, EXPIRED, DELETED, UNDELIV, ACCEPTD, UNKNOWN e REJECTD. Il formato esatto dipende dall’SMSC, ed è per questo che i provider lo normalizzano.
Un’API HTTP di solito espone le stesse informazioni come eventi webhook, ad esempio SENT, DELIVERED o FAILED, ricavati dal rapporto dell’operatore.
Limiti: alcuni operatori non restituiscono rapporti o li restituiscono in ritardo, e alcuni restituiscono “consegnato” quando il messaggio ha raggiunto la rete e non il telefono. Considerate i DLR una prova solida, non la certezza dell’avvenuta lettura.
Esempio
id:7f3a91c2 sub:001 dlvrd:001 submit date:2610101030 done date:2610101030 stat:DELIVRD err:000 text:Il codice è