Voltar ao blog Conectividade

Integridade da codificação em SMS A2P: guia de testes e diagnóstico

Saiba como organizar verificações controladas do texto em SMS A2P, comparar as evidências disponíveis e comunicar com clareza o que não é possível verificar.

Diagrama de um fluxo de SMS A2P com pontos de controlo para comparar o texto e os registos disponíveis

O que significa preservar a codificação

Neste guia, a integridade do texto refere-se à comparação entre o conteúdo previsto e as cópias e os registos disponíveis durante o envio. Isto não significa que todos os segmentos do percurso sejam visíveis nem que o texto apresentado num registo seja necessariamente uma cópia exata do que foi recebido pelo terminal.

Convém separar três perguntas: que texto foi criado pela aplicação? Que conteúdo foi enviado para a interface? E que evidências existem sobre o respetivo processamento ou estado? Uma diferença entre duas observações ajuda a delimitar o que deve ser investigado; por si só, não demonstra que componente a causou.

  • Registe separadamente o texto de entrada e cada observação disponível.
  • Distinga uma discrepância observável de uma causa confirmada.
  • Trate a comparação do conteúdo e o estado comunicado como verificações distintas.
O que significa preservar a codificação

Pontos de observação: da aplicação ao destino

Desenhe o percurso real da sua integração antes de fazer verificações. Inclua a aplicação e os respetivos modelos, a interface utilizada, os componentes sob o seu controlo e os pontos de observação que o fornecedor possa disponibilizar. Inclua o destino como etapa do percurso, sem presumir que terá acesso ao conteúdo interno de outros sistemas.

Guarde uma cópia do texto antes do envio e registe as informações devolvidas por cada componente. As implementações e os campos disponíveis podem variar; não presuma que um registo simplificado descreve todas as transformações ou permite reconstruir o percurso completo.

  • Registe a versão da aplicação, os componentes e a configuração usados em cada verificação.
  • Guarde o identificador devolvido pela interface e associe-o a registos posteriores, quando disponíveis.
  • Pergunte ao fornecedor o que representa cada registo e quais são as respetivas limitações.
Pontos de observação: da aplicação ao destino

Caracteres e representações: o que registar

O texto pode ser representado ou tratado de formas diferentes pelos componentes de uma integração. As evidências disponíveis aqui não permitem especificar que representação é utilizada num percurso concreto nem que tratamento é aplicado por cada componente. Por isso, não deduza esses detalhes apenas pela aparência do texto numa consola.

Prepare uma lista de caracteres baseada no conteúdo que realmente precisa de enviar. Registe o texto exato antes do envio e quaisquer dados sobre o processamento que a interface disponibilize e documente. Não presuma que dois sistemas calculam o comprimento ou descrevem o conteúdo da mesma forma.

  • Guarde uma cópia do texto previsto antes do envio.
  • Registe quaisquer alterações feitas pela aplicação antes da chamada à interface.
  • Registe dados adicionais apenas quando estiverem disponíveis e documentados para essa integração.
  • Não interprete um contador apresentado por um sistema como prova da forma como o texto foi representado noutro.

Conceba verificações autorizadas e controladas

Utilize apenas destinos e remetentes de teste para os quais tenha autorização. Mantenha a configuração e o texto constantes enquanto compara os resultados. Altere uma variável de cada vez para facilitar a delimitação das discrepâncias.

Prepare casos pequenos e reproduzíveis com caracteres do conteúdo que realmente utilizará. Repita uma verificação se o resultado variar e registe a hora, o destino de teste, o remetente, o identificador e a configuração. As informações disponíveis não permitem estabelecer critérios técnicos específicos para uma determinada representação ou comprimento.

  • Confirme antecipadamente que tem autorização para utilizar o destino e o remetente de teste.
  • Envie cada caso separadamente e use uma etiqueta de teste que não contenha dados pessoais.
  • Compare as configurações apenas depois de obter uma referência estável.
  • Não utilize as verificações para contactar destinatários sem autorização nem para contornar controlos.

Compare evidências sem recolher dados desnecessários

Compare o texto previsto com cada cópia disponível no seu sistema e nos registos do fornecedor. Se o fornecedor não disponibilizar o conteúdo processado, registe essa limitação e solicite as informações mínimas necessárias para delimitar o problema. Não deduza o conteúdo com base numa confirmação ou num estado comunicado.

Para reduzir a exposição, utilize mensagens sintéticas e destinos de teste autorizados. Limite o acesso aos registos e evite guardar o corpo completo da mensagem quando bastar uma referência do caso ou uma comparação controlada. Se precisar de conservar o texto para reproduzir uma discrepância, defina o acesso e o período de conservação de acordo com as suas políticas e obrigações aplicáveis.

  • Mantenha uma tabela com a etapa, o valor observado, a fonte, a hora e as limitações.
  • Distinga os dados do seu sistema dos dados comunicados pelo fornecedor.
  • Não inclua códigos de utilização única reais, informações sensíveis nem dados pessoais nas verificações.
  • Conserve evidências suficientes para reproduzir o caso, não uma cópia indiscriminada do tráfego.

Interprete discrepâncias sem atribuir causas prematuramente

Um caráter que aparece diferente, desaparece ou é substituído é um sinal para investigar, não uma atribuição automática de causa. Comece por verificar o texto gerado pela aplicação; em seguida, compare as observações sucessivas disponíveis. Se conhecer apenas o texto de entrada e um estado final, pode não ser possível determinar a etapa responsável.

Se a discrepância coincidir com outras alterações observadas, registe-as sem presumir uma relação causal. As diferenças entre os dados de dois sistemas não demonstram, por si só, o que aconteceu nos segmentos intermédios nem o que foi apresentado no terminal.

  • Reproduza o caso com uma mensagem mínima que contenha o texto problemático.
  • Compare uma versão de controlo e documente as observações de cada uma.
  • Verifique se a aplicação alterou o texto antes de atribuir o problema a outra etapa.
  • Assinale como não confirmado qualquer segmento para o qual não haja evidência direta.

O que as confirmações, os registos e os DLR provam — e o que não provam

Uma confirmação ou um DLR deve ser interpretado de acordo com a definição da fonte que o emite. As evidências disponíveis não permitem atribuir um significado concreto a um estado de uma interface ou de um fornecedor. Não apresente automaticamente um estado comunicado como prova de que o utilizador leu a mensagem ou de que o texto chegou íntegro ao ecrã do terminal.

Antes de utilizar um estado como critério operacional, peça a definição do código e as limitações conhecidas. Se não existir uma verificação independente do terminal, descreva o resultado como um estado comunicado, não como receção verificada no dispositivo.

  • Documente o significado dos estados de acordo com a fonte que os emite.
  • Distinga a confirmação de um pedido, um estado comunicado e uma verificação independente do terminal.
  • Não utilize um DLR como prova de leitura nem como confirmação da integridade do texto.

Procedimento de diagnóstico e critérios de aceitação

Quando detetar uma diferença, guarde o caso mínimo reproduzível e registe a configuração. Comece por verificar o texto gerado pela aplicação; em seguida, compare o que foi enviado para a interface com a resposta recebida; por fim, solicite ao fornecedor os registos disponíveis para o identificador correspondente. Ao escalar o problema, inclua a hora, o destino autorizado, o remetente, o texto de teste e as observações exatas. Peça esclarecimentos sobre a etapa representada por cada registo.

Defina critérios com base apenas no que pode observar e comparar. Por exemplo, pode exigir que o texto coincida nos pontos acessíveis e que as discrepâncias possam ser reproduzidas ou delimitadas. Se não puder verificar o conteúdo numa etapa, declare essa limitação e acorde como serão geridos os incidentes, sem transformar uma suposição num critério de aceitação.

  • Estabeleça uma referência com mensagens sintéticas e remetentes e destinos autorizados.
  • Avalie o percurso face a requisitos verificáveis, não a pressupostos sobre etapas invisíveis.
  • Peça ao fornecedor definições dos registos e dos estados, bem como quaisquer informações documentadas que afetem a sua integração.
  • Repita as verificações após alterações que possam modificar o texto ou os registos disponíveis.
FAQ

Perguntas frequentes

Um DLR confirma que o texto foi recebido integralmente no telemóvel?

Não é possível concluir isso apenas com base num DLR. Interprete-o de acordo com a definição da fonte que o emite; por si só, não demonstra que texto foi apresentado no terminal nem que o utilizador o leu.

Como posso saber como o texto foi tratado na minha integração?

Compare o texto previsto com as observações disponíveis em cada etapa e consulte a documentação do fornecedor. A aparência numa consola não é suficiente para confirmar o tratamento interno.

Que casos devo incluir nas verificações?

Comece pelo conteúdo real que precisa de enviar e teste pequenas variações reproduzíveis. Utilize apenas destinos e remetentes autorizados.

Uma diferença entre o texto original e um registo prova que o fornecedor o alterou?

Não. Demonstra uma discrepância entre duas observações. Para a delimitar, compare as evidências sucessivas e confirme o que cada registo representa e que informações não estão disponíveis.

O que devo enviar ao fornecedor ao escalar um problema?

Um caso mínimo reproduzível com a hora, o identificador, a configuração, o destino autorizado, o remetente e a comparação exata entre o texto previsto e as observações disponíveis. Evite incluir dados pessoais ou mensagens reais sensíveis.

Fontes consultadas

  1. 3GPP specifications3GPP
  2. ITU-T E.164International Telecommunication Union
  3. GSMA resourcesGSMA
  4. SMPP specificationSMPP Developers Forum
  5. HTTP semanticsIETF