Guia · DLR e estados
Status de entrega de SMS e DLR: o que cada evento prova
Delivery receipt, ou DLR, é uma evidência recebida depois da transmissão. Ele deve ser preservado junto da tentativa e normalizado sem apagar o evento original do provedor.
HTTP 202 não é entrega
Uma resposta 202 informa que o sistema aceitou o comando segundo o contrato da API. Ela não afirma que o provedor reconheceu a transmissão ou que o aparelho recebeu a mensagem.
Acknowledgment não é DLR positivo
O acknowledgment demonstra que o provedor recebeu a tentativa. delivered exige uma evidência posterior e positiva. Manter ambos os horários permite investigar fila, transmissão e confirmação separadamente.
Unknown é um resultado válido
Sistemas reais podem ficar sem conclusão. unknown registra que não há evidência suficiente para afirmar entrega ou falha. Ele evita relatórios falsamente precisos e reenvios potencialmente duplicados.
Preserve a linha do tempo
Registre event_id, attempt_id, horário de ocorrência, horário de ingestão, código normalizado e referência segura ao evento original. Webhooks duplicados devem ser processados idempotentemente.