Skip to main content
A única direção em que você é o servidor. Peça com "dlr": "yes" e um dlr_url no envio.

​
json — o padrão

Um POST com Content-Type: application/json:

​
Campos

Campos nulos são omitidos em vez de enviados como null, então um recibo para uma mensagem que nunca chegou a um fornecedor não chega cheio de chaves vazias. Toda chamada traz User-Agent: FireFlo/<version>.
Não existe campo err. O Jasmin envia um; o resolver do FireFlo recebe apenas o estado de entrega, nunca um código de erro, então emitir um seria inventá-lo.vendor está ausente até seu provedor habilitar. Ele nomeia qual fornecedor transporta seu tráfego, o que é omitido dos clientes por construção em outros lugares.

​
kannel — substituição de placeholders

Um GET cru contra a URL registrada, com dois placeholders substituídos. Nada é anexado.
Uma URL sem placeholders recebe uma requisição carregando absolutamente nada. Nenhum corpo, nenhuma query, nenhum identificador. O endpoint é chamado no horário, retorna 200, e a integração parece “funcionando mas vazia”.Nada no sistema sinaliza isso, porque um callback vazio é indistinguível de um configurado corretamente que por acaso não carrega dados.
O formato é escolhido pelo seu provedor com smsg.dlr.forward.format, não por você. dlr-method é aceito em um envio, mas não o seleciona.

​
Entrega e retries

Um 302 para uma página de login conta como sucesso e engole o recibo. Assim como qualquer 2xx de um proxy que nunca chegou à sua aplicação. Se os recibos “chegam” mas seu handler nunca roda, veja o que está na frente dele.
A entrega é at-least-once. Faça seu handler idempotente em id mais level, não em id sozinho, já que uma mensagem legitimamente pode produzir um nível 1 e depois um nível 2.

​
Quais recibos você recebe

dlr_level no envio: 1 só progresso, 2 o desfecho (padrão), 3 os dois. Via SMPP, a mesma escolha é o octeto registered_delivery. 0x11 é a forma SMPP de dlr_level: 3.

​
Todo recibo é registrado

Seja ele encaminhado ou não. Suprimir um recibo é uma decisão sobre o que te contar, nunca sobre o que registrar. Então “eu nunca recebi um recibo” é sempre respondível pelo seu provedor.

​
Relacionados

Recibos de entrega

Construindo contra isso, com a armadilha do nível explicada.

Callbacks não chegando

Diagnosticando o silêncio.