Como resolver o erro "Unknown error attempting to reach phone" (Erro desconhecido ao tentar acessar o telefone) do SMS no Amazon SNS?

Breve descrição

Uma mensagem SMS é entregue a dispositivos móveis por meio de agregadores downstream terceirizados, fornecedores de SMS e operadoras de telefonia celular. Ou seja, quando você usa o SMS com o Amazon SNS, o Amazon Pinpoint ou qualquer serviço da AWS que se integra ao Amazon SNS ou ao Amazon Pinpoint. Você recebe o erro “Unknown error attempting to reach phone” (Erro desconhecido ao tentar acessar o telefone) quando esses parceiros downstream não conseguem acessar o dispositivo móvel.

Importante: a arquitetura do SMS é distribuída, por projeto. É 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 da Internet Engineering Task Force (IETF).

Resolução

Confira os problemas comuns

Elimine os problemas comuns que não são relacionados ao Amazon SNS ou ao Amazon Pinpoint.

Você pode receber o erro pelos seguintes motivos:

• O número de telefone é bloqueado por uma operadora como spam.
• O destino está bloqueado.
• O corpo da mensagem não é válido.
• O número de telefone está na lista “Não perturbe”.
• O telefone está em uma rede de roaming.
• A operadora de telefonia está bloqueando a mensagem.
• O telefone está bloqueando 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.

Revise as práticas recomendadas de SMS

Confirme se você está seguindo as práticas recomendadas, as regras e os regulamentos de SMS para o país de destino ou a região da AWS para onde envia suas mensagens SMS.

Confirme se você está usando a identidade de origem correta. Se necessário, a identidade deve ser registrada. Para obter mais informações, consulte Supported countries and regions (SMS channel) (Países e regiões com suporte (canal de SMS)).

Se você envia mensagens SMS para os EUA, consulte Special requirements for sending SMS messages to US destinations (Requisitos especiais para enviar mensagens SMS para destinos nos EUA).

Se você envia mensagens SMS para a Índia usando rotas locais, primeiro registre seu ID do remetente alfabético dedicado. Em seguida, use o modelo registrado de DLT. Para obter mais informações, consulte Special requirements for sending SMS messages to recipients in India (Requisitos especiais para enviar mensagens SMS para destinatários na Índia).

Solucionar problemas de entrega de um único dispositivo

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

Para solucionar esses problemas:

1. Use a API do Amazon Pinpoint para validar o número de telefone.
2. Envie uma mensagem SMS de outro dispositivo e confira se a mensagem foi entregue.

Se as duas etapas acima forem bem-sucedidas, considere testar em outros dispositivos.

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

Solucionar problemas de entrega de vários dispositivos

Se a entrega de SMS estiver afetando vários dispositivos, pode haver problemas com os agregadores, os fornecedores e as operadoras downstream

Para solucionar potenciais problemas downstream, crie um caso de suporte para o serviço que você está usando para enviar mensagens SMS.

Forneça as seguintes informações em seu caso de suporte:

• A região que você está usando para enviar mensagens de SMS
• Um carimbo de data/hora de quando o problema começou
• Amostras de logs de SMS com os IDs das mensagens de SMS com falha para diferentes números, de até três dias antes

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