Como rastrear um SMS SMPP

O Ozeki SMS Gateway fornece vários logs para descobrir o que aconteceu com um determinado SMS que passou pelo sistema. Se você fornece um serviço SMPP, às vezes receberá uma solicitação do seu cliente perguntando sobre um SMS. Este guia fornece informações sobre como descobrir o que aconteceu com um único SMS.

Para encontrar o SMS do cliente, primeiro abra a conta de usuário SMPP do cliente. Em seguida, selecione a aba de log de eventos para ver a comunicação entre seu sistema e o sistema do cliente. Se você não vir a mensagem nos logs, pode abrir o arquivo de log com o bloco de notas. O arquivo de log pode ser encontrado em:

C:\Program Files\Ozeki\Data\Logs\Connections\SMPP_user_smp1_localhost.txt

Esta entrada de log geralmente contém 5 linhas de código. A primeira linha é a solicitação de envio enviada pelo sistema do cliente, depois você vê nossa resposta a essa solicitação, então registramos os eventos de roteamento e entrega correspondentes à mensagem.

INFO smp1: 192.168.112.150:60724 -> 0000003700000004000000000000001C00010130303030303030000101313233
3435363700000001000001000000085465737420736D73

INFO smp1: Mensagem aceita com ID SMPP: 6682891798

INFO smp1: 192.168.112.150:60724 <- 0000001B80000004000000000000001C3636383238393137393800

INFO smp1: Recebido: +0000000->+1234567 'Test sms'

INFO smp1: Enviando. Rota: defout_sms,Any_SMS_Connection@localhost +0000000 -> +1234567 'Test sms' ID da tarefa: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112

INFO smp1: Envio aceito em HTTP_Server_1@localhost. Referência de envio: 701dbf6a-30a4-4bd9-8409-848fd68ce1a3 +0000000 -> +1234567 'Test sms' ID da tarefa: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112

A primeira linha do log acima são os dados que o sistema recebeu do seu cliente. Seu cliente enviou sua mensagem SMS usando a solicitação PDU SMPP SUBMIT_SM. Aqui estão os dados em bytes representados em formato HEX:

INFO smp1: 192.168.112.150:60724 -> 0000003700000004000000000000001C000101303030303030300001
013132333435363700000001000001000000085465737420736D73

As próximas três linhas no log estão relacionadas à resposta. Seu sistema atribui um ID SMPP à mensagem. Este ID é 6682891798 no nosso caso. Este ID será usado para referenciar esta mensagem quando um relatório de entrega chegar. Em seguida, ele envia uma resposta ao seu cliente na forma de um PDU SUBMIT_SM_RESP. Este PDU contém o ID atribuído. Seu cliente pode armazenar este ID para referência futura.

INFO smp1: Mensagem aceita com ID SMPP: 6682891798

INFO smp1: 192.168.112.150:60724 <- 0000001B80000004000000000000001C3636383238393137393800

INFO smp1: Recebido: +0000000->+1234567 'Test sms'

As próximas duas linhas estão relacionadas ao roteamento da mensagem. O sistema fornece informações sobre qual rota foi usada para encaminhar a mensagem para a rede móvel. Após a conclusão do roteamento, o sistema também registrará o que aconteceu com a mensagem na conexão de destino. No nosso caso, você verá que a rota default_sms foi usada e a mensagem foi enviada para a rede móvel através da conexão HTTP_Server_1@localhost.

INFO smp1: Enviando. Rota: defout_sms,Any_SMS_Connection@localhost +0000000 -> +1234567 'Test sms' ID da tarefa: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112

INFO smp1: Envio aceito em HTTP_Server_1@localhost. Referência de envio: 701dbf6a-30a4-4bd9-8409-848fd68ce1a3 +0000000 -> +1234567 'Test sms' ID da tarefa: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112

Se você quiser informações mais detalhadas sobre o que aconteceu com a mensagem, pode abrir o log da conexão da rede móvel e ver os eventos de entrega correspondentes à mensagem nesse arquivo de log. Neste caso, você abriria o log da conexão HTTP_Server_1@localhost.

Após alguns minutos, quando a rede móvel entregar o SMS para o telefone do destinatário, um relatório de entrega será retornado ao seu sistema. Seu sistema encaminhará este relatório de entrega ao cliente usando uma solicitação SMPP_DELIVER_SM. Este relatório de entrega conterá o ID SMPP original da mensagem. No nosso caso, será: 6682891798. Para encontrar o log de relatório de entrega correspondente no seu arquivo de log, procure por este ID.

Registro de relatório de entrega

O registro de entrega correspondente neste caso contém 5 entradas. A primeira entrada imprime informações para você que afirmam que a mensagem foi entregue. A próxima linha fornece informações sobre qual rota de entrada foi usada para encaminhar o relatório de entrega recebido para a conta deste usuário. As duas linhas seguintes contêm a comunicação entre o seu sistema e o sistema do cliente. Você verá que o seu sistema envia o PDU SMPP Deliver_SM para o cliente, e o cliente retorna uma resposta para confirmar esta solicitação.

2020-07-30 10:05:36.674 INFO smp1: Entregue. 'Entregue; Para: +1234567; Em: 2020-07-30 10:05:36; Ref: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112; Entrega bem-sucedida em 30/07/2020 10:05:36' +0000000 -> +1234567 'Test sms' ID da Tarefa: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112
2020-07-30 10:05:36.674 INFO smp1: A mensagem foi processada com sucesso. Nenhum trabalho adicional é necessário. Removendo-a da fila de Enviados. Rota: smp1@localhost->HTTP_Server_1@localhost (Mover). Mensagem: +0000000->+1234567 'Test sms' ID da Tarefa: 1326c0f0-e8fd-4ddd-97d2-68ff9401b112
2020-07-30 10:05:36.674 INFO smp1: 192.168.112.150:60724 <- 000000A6000000050000000000000001000101303030303030300001013132333435363700040000000000000 3007769643A36363832383931373938207375623A30303120646C7672643A303031207375626D697420646174 653A3230303733303130303020646F6E6520646174653A3230303733303130303520737461743A44454C49565 244206572723A30303020746578743A44656C697665727920737563636573732E
2020-07-30 10:05:36.674 INFO smp1: 192.168.112.150:60724 -> 0000001180000005000000000000000100
2020-07-30 10:05:36.674 INFO smp1: Relatório de entrega enviado. UD: id:6682891798 sub:001 dlvrd:001 submit date:2007301000 done date:2007301005 stat:DELIVRD err:000 text:Entrega bem-sucedida.

Perguntas frequentes

A correspondência tradicional de relatórios de entrega de SMS depende de um ID de referência retornado pela rede móvel no momento do envio da mensagem. Este ID, normalmente um número entre 0 e 255, serve como ponto de referência para associar relatórios de entrega às suas mensagens correspondentes. No entanto, esta abordagem tem uma limitação: com mais de 256 mensagens enviadas, podem ocorrer colisões de IDs, levando a atualizações imprecisas do status de entrega.

O software Ozeki SMS aborda este desafio empregando um mecanismo de correspondência mais robusto. Ele combina o número de telefone do destinatário com o ID de referência retornado. Isso cria um "ID de retorno" único que reduz significativamente o risco de colisões.

Em vez de depender apenas do ID "0" (potencialmente atribuído a várias mensagens), o Ozeki usa um ID de retorno como "+36201234567:0." Este identificador combinado permite um mapeamento mais preciso dos relatórios de entrega para as mensagens originais enviadas para o número de telefone específico "+36201234567" com ID "0." Como resultado, o software pode atualizar com confiança o status da mensagem para "entregue no aparelho."

As conexões de SMS IP oferecem uma vantagem adicional. Elas utilizam IDs de retorno muito mais longos e únicos, frequentemente na forma de Identificadores Únicos Globais (GUIDs). Isso elimina completamente a possibilidade de colisões, garantindo uma correspondência de relatórios de entrega ainda mais confiável.