Ir para o conteúdo

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

5 minuto de leitura
0

Minhas mensagens de texto móveis (mensagens SMS) não são entregues por meio do Amazon Simple Notification Service (Amazon SNS) ou do AWS End User Messaging. Recebi o erro “Unknown error attempting to reach phone” em meus Amazon CloudWatch Logs para mensagens SMS.

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.

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

Resolução

Verifique se há problemas na operadora e no telefone

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

  • Uma operadora bloqueou o número de telefone como spam.
  • Uma operadora bloqueou o destino.
  • 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.
  • Os telefones estão desligados.
  • O número é de um telefone fixo (não de 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 um 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, poderá haver problemas com agregadores, fornecedores, provedores e operadoras downstream.

Para solucionar possíveis problemas downstream, entre em contato com o AWS Support.

Forneça as seguintes informações no seu caso de suporte relativas ao serviço que você usa para enviar mensagens SMS:

  • A região da AWS que você usa para enviar mensagens SMS.
  • Um carimbo de data/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 para a Índia) Forneça seu ID de entidade registrado no Distributed Ledger Technology (DLT), o ID do modelo e uma amostra do conteúdo usado para enviar as mensagens SMS.

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.

Perguntas frequentes

Como faço para solucionar outros tipos de mensagens de erro de SMS?

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

Por quanto tempo as operadoras de celular armazenam informações?

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

Informações relacionadas

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

Monitorar tópicos do Amazon SNS usando o CloudWatch

AWS OFICIALAtualizada há 2 meses
1 Comentário

This article was reviewed and updated on 2026-09-14.

ESPECIALISTA

respondeu há 17 dias