Como resolvo o erro “Unknown error attempting to reach phone” de SMS por meio do Amazon SNS ou do AWS End User Messaging?

Breve descrição

Você pode receber o erro “Unknown error attempting to reach phone” no seu CloudWatch Logs para mensagens SMS por vários motivos. Para ativar e visualizar o CloudWatch Logs para suas mensagens SMS, consulte Visualizar o CloudWatch Logs.

Para solucionar outros tipos de mensagens de erro de SMS, consulte Como soluciono falhas de mensagens de texto móveis (SMS) no Amazon SNS?

Importante: a arquitetura do SMS é distribuída por design. É uma prática recomendada evitar fazer suposições sobre a confiabilidade e o desempenho da transmissão de mensagens SMS para suas aplicações. Para obter mais informações, consulte RFC 5724 da Internet Engineering Task Force (IETF).

Resolução

Verifique se há problemas comuns

Verifique se o problema não ocorreu pelos seguintes motivos:

• O número de telefone está bloqueado por uma operadora como spam.
• O destino está bloqueado.
• O corpo da mensagem não é válido.
• O número de telefone está em uma lista Não perturbe (Do Not Disturb, DND).
• O telefone está em uma rede de roaming.
• A operadora de telefonia bloqueou a mensagem.
• O telefone bloqueou o SMS.
• O telefone está temporariamente fora da área de cobertura.
• O telefone está desligado.
• O telefone é um número fixo (não um celular).
• Há uma URL não registrada no corpo da mensagem.
• O número do celular não é válido.
• Os parceiros downstream têm configurações de rede incorretas para um determinado número ou conjunto de números regionais.

Analisar práticas recomendadas para SMS

Confirme se você está seguindo as práticas recomendadas, regras e regulamentações de SMS para o país de destino ou Região da AWS para a qual você envia suas mensagens SMS.

Confirme se a identidade de origem usada está correta. Se necessário, registre a identidade. Para obter mais informações, consulte Países e regiões compatíveis com mensagens SMS com o AWS End User Messaging SMS.

Se você envia mensagens SMS para os EUA, verifique se está usando um número de origem compatível para os EUA.

Se você usa um número gratuito para os EUA, verifique se ele está registrado.

Se você enviar mensagens SMS para a Índia por rotas locais, especifique os valores ID da entidade e ID do modelo depois de concluir o processo de registro. Certifique-se de que o ID do modelo que você especificou corresponde exatamente ao seu modelo de mensagem.

Solucionar problemas de entrega em um único dispositivo

Bloqueio de SMS, roaming, lacunas de cobertura e outros fatores em nível de dispositivo podem causar problemas de entrega.

Conclua as seguintes etapas:

1. Use a API do Amazon Pinpoint para validar o número de telefone. Números de telefone fixo e VoIP podem causar problemas de entrega.
2. Envie uma mensagem SMS de outro dispositivo e verifique a entrega da mensagem.

Se ambas as etapas forem bem-sucedidas, teste em outros dispositivos.

Se o problema persistir, o proprietário do dispositivo deverá entrar em contato com a operadora de celular para obter suporte.

Solucionar problemas de entrega de vários dispositivos

Se o atraso na entrega de SMS afetar vários dispositivos, pode haver problemas com agregadores, fornecedores, provedores e operadoras downstream.

Para solucionar possíveis problemas downstream, crie um processo de suporte para o serviço que você está usando para enviar mensagens SMS.

Forneça as seguintes informações no seu processo de suporte:

• A Região que você usa para enviar mensagens SMS.
• Um registro de data e hora de quando o problema começou.
• Três amostras de logs de SMS com os IDs de mensagens SMS com falha em números de telefone diferentes com menos de três dias.
• (Somente na Índia) Forneça seu ID de entidade registrado no DLT, ID do modelo e uma amostra do conteúdo usado para enviar as mensagens SMS.

Observação: as operadoras de celular podem não armazenar informações de SMS por mais de três dias.

Importante: as entregas de SMS do CloudWatch Logs podem não fornecer prazos de entrega de SMS precisos. As mensagens SMS podem ser entregues antes de você receber os CloudWatch Logs. O valor dwellTimeMsUntilDeviceAck nos logs de entrega mostra quando a operadora aceitou a mensagem, mas não fornece informações sobre mensagens SMS atrasadas. Para obter mais informações, consulte Visualizar o CloudWatch Logs.

Informações relacionadas

Como gerenciar o envio global de SMS com o AWS End User Messaging

Monitoramento de tópicos do Amazon SNS usando o CloudWatch

Quais são as práticas recomendadas para enviar mensagens SMS?