Correspondência de Relatórios de Entrega de SMS

Este guia mostra como funciona a correspondência de relatórios de entrega no Ozeki SMS Gateway. Os relatórios de entrega são mensagens SMS retornadas pela rede móvel quando o texto originalmente enviado chega ao aparelho do destinatário. Quando você envia uma mensagem SMS, a rede retorna um ID de referência de envio e, posteriormente, quando o SMS é entregue ao aparelho do destinatário, você recebe um relatório de entrega com a data de entrega e o mesmo ID de referência de envio. Nesta interface gráfica, você verá como o ID de referência de envio é registrado e como você pode rastrear o algoritmo de correspondência de relatórios de entrega do Ozeki SMS Gateway.

No vídeo abaixo, você vê como funciona a correspondência de relatórios de entrega. Primeiro, o registro é ativado para os relatórios de entrega. Em seguida, um SMS é enviado através de um link SMPP. Você pode ver no vídeo o ID de referência de envio retornado. Este ID é retornado pelo operador da rede móvel. Em seguida, você pode ver a entrada no registro de relatórios de entrega.

A segunda parte do vídeo mostra o que acontece quando o relatório de entrega chega ao sistema. Um relatório de entrega sempre chega em um momento posterior. Você pode ver o relatório de entrega recebido no log de eventos do link SMPP. Observe que o ID de referência de envio para este relatório de entrega corresponde ao ID de referência de envio salvo anteriormente. Quando o relatório de entrega chega, você pode ver os eventos de correspondência no log pertencente ao mecanismo de correspondência de relatórios de entrega.

Para poder rastrear o que acontece, você precisa ativar o registro no menu Editar/Preferências/Relatórios de entrega. Certifique-se de que o mecanismo de correspondência de relatórios de entrega "Baseado em arquivo" está selecionado e que a caixa de seleção "Registrar eventos de correspondência de relatórios de entrega" está marcada. (Figura 1)

No formulário de preferências do servidor, você encontrará uma lista de configurações. Selecione o item "Relatórios de Entrega" na lista. (Figura 2)

Uma vez que o recurso de registro do mecanismo de correspondência de relatórios de entrega é ativado, envie um SMS de teste. Após o envio do SMS, você verá o ID de referência de envio correspondente no log de eventos da conexão com a rede móvel. No nosso caso, este é 2127518572. (Figura 3)

Em seguida, abra o log de relatórios de entrega. Você pode encontrar o log se clicar em "Referências de Envio" no menu "Visualizar" (Figura 4).

Neste log, você pode ver a entrada: "Referência de envio adicionada: 2127518572". Esta entrada é importante, porque após ser registrada no sistema, relatórios de entrega recebidos com este ID podem ser registrados para o SMS correspondente. Precisamos desse mecanismo de correspondência para que possamos definir o status do SMS correspondente como entregue. (Figura 5)

Na parte final, verifique o relatório de entrega recebido. Se você olhar para o log da conexão com a rede móvel, verá uma linha começando com as palavras "Relatório de entrega de...". Nesta linha, você verá o ID de referência de envio original e o horário da entrega. (Figura 6)

Após o recebimento do relatório de entrega, vá para o log do mecanismo de relatórios de entrega no menu "Visualizar"/"Referências de Envio" e dê uma olhada no evento de correspondência. (Figura 7)

Por que meus relatórios de entrega são descartados?

Ao gerenciar um gateway de SMS, é essencial garantir que os relatórios de entrega reflitam com precisão as mensagens enviadas. No entanto, às vezes você pode encontrar relatórios sem uma mensagem correspondente em seu sistema. Aqui está uma análise das possíveis causas:

1. Incompatibilidade de ID de Referência:

• O SMSC pode retornar um ID de referência diferente no relatório de entrega em comparação com o relatório de envio. Mesmo uma única diferença de caractere pode fazer com que o software Ozeki não consiga corresponder o relatório à mensagem original.
• Solução: Verifique o log de eventos do provedor de serviços no Ozeki para encontrar a mensagem original e confirme seu ID de referência.

2. IDs de Referência Não Únicos:

• Alguns provedores de serviços podem atribuir o mesmo ID de referência a várias mensagens. Isso cria um conflito ao registrar mensagens na tabela de referência do Ozeki. Consequentemente, os relatórios de entrega para a segunda mensagem (com o ID duplicado) serão descartados.
• Solução: Esse problema está relacionado ao provedor de serviços. Entre em contato com eles para investigar suas práticas de atribuição de IDs de referência.

3. Tempo de Armazenamento da Mensagem Excedido:

• O software Ozeki armazena IDs de referência por um período definido (geralmente uma semana). Relatórios de entrega para mensagens mais antigas que esse limite serão descartados devido a restrições de tamanho do banco de dados.
• Solução: Essa é uma configuração do sistema para equilibrar funcionalidade com demandas de armazenamento. Aumentar o período de armazenamento do ID de referência pode não ser ideal, então considere soluções alternativas, como arquivar mensagens mais antigas.

4. Exclusão Prematura da Mensagem:

• Excluir a mensagem original da pasta de enviados ou ativar a exclusão automática pode fazer com que a mensagem esteja ausente quando o relatório de entrega chegar.
• Solução: Revise suas configurações de exclusão de mensagens. Evite excluir mensagens enviadas antes de receber os relatórios de entrega, especialmente para comunicações críticas.

Esta tabela funciona como um repositório para mensagens pendentes. Estas são mensagens que foram enviadas para entrega, mas para as quais uma confirmação de entrega (relatório) ainda não foi recebida. A mensagem permanece listada nesta tabela até que um relatório de entrega seja obtido. Na ausência de uma confirmação de entrega dentro de um período pré-definido (normalmente uma semana), a mensagem é removida da tabela. Esse processo garante o gerenciamento eficiente dos dados de mensagens e evita o acúmulo de entradas desatualizadas.