Definição
Uma confirmação de entrega (DLR, delivery receipt) é uma mensagem de status devolvida pela rede da operadora que informa ao remetente se um SMS foi entregue no aparelho, expirou ou falhou, junto com os registros de data e hora e um código de erro.
No SMPP v3.4, o remetente solicita uma confirmação pelo campo registered_delivery do submit_sm. Depois, o SMSC a devolve como um deliver_sm cujo esm_class a identifica como confirmação de entrega.
A especificação SMPP traz um exemplo de texto de confirmação (Apêndice B) com os campos id, sub, dlvrd, submit date, done date, stat, err e text, e estados finais como DELIVRD, EXPIRED, DELETED, UNDELIV, ACCEPTD, UNKNOWN e REJECTD. O formato exato varia conforme o SMSC, e é por isso que os provedores o normalizam.
Uma API HTTP normalmente expõe a mesma informação como eventos de webhook, por exemplo SENT, DELIVERED ou FAILED, mapeados a partir da confirmação da operadora.
Limitações: algumas operadoras não devolvem confirmações ou as devolvem com atraso, e algumas informam “entregue” quando a mensagem chegou à rede, e não ao celular. Trate os DLRs como um forte indício, não como prova de leitura.
Exemplo
id:7f3a91c2 sub:001 dlvrd:001 submit date:2610101030 done date:2610101030 stat:DELIVRD err:000 text:Your code is