Como resolvo o erro "Erro desconhecido ao tentar acessar o telefone" no Amazon SNS ou o erro "DESCONHECIDO" no Pinpoint ao enviar SMS?

Breve descrição

Uma mensagem SMS é entregue aos dispositivos móveis por meio de agregadores downstream terceirizados, fornecedores de SMS e operadoras móveis. Ou seja, quando você usa SMS com o Amazon SNS, o Amazon Pinpoint ou qualquer serviço da AWS que se integre ao Amazon SNS ou ao Amazon Pinpoint. Você recebe o erro "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 design. É uma prática recomendada evitar fazer suposições sobre a confiabilidade e a performance da transmissão de mensagens SMS para seus aplicativos. Para obter mais informações, consulte a RFC 5724 da Internet Engineering Task Force (IETF).

Resolução

Siga estas etapas de solução de problemas para seu caso de uso.

Verifique se há problemas comuns

Exclua problemas comuns que não estejam relacionados ao Amazon SNS ou ao Amazon Pinpoint.
Você pode receber o erro 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 (DND).
• O telefone está em uma rede de roaming.
• A operadora de telefonia está bloqueando a mensagem.
• O telefone está bloqueando mensagens 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á um URL não registrado 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 você está usando a identidade de origem correta. Se necessário, a identidade deve ser registrada. Para obter mais informações, consulte Países e regiões com suporte (canal SMS).
Se você envia mensagens SMS aos 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ê envia mensagens SMS para a Índia usando rotas locais, primeiro pré-registre seu ID alfabético de remetente dedicado. Em seguida, use o modelo registrado do DLT. Ao adicionar conteúdo às mensagens SMS, verifique se ele corresponde exatamente ao conteúdo do modelo registrado no DLT. Para mais informações, consulte Requisitos de registro de ID de remetente para a Índia.

Solucionar problemas de entrega em um único dispositivo

Bloqueio de SMS em nível de 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. Usar números de telefone fixo e VoIP pode causar problemas de entrega.
2. Envie uma mensagem SMS de outro dispositivo e verifique se a mensagem foi entregue.

Se essas duas etapas forem bem-sucedidas, considere testar 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 caso de suporte para o serviço que você está usando para enviar mensagens SMS.
Forneça as seguintes informações no seu caso de suporte:

• A região que você está usando 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 Amazon CloudWatch Logs nem sempre fornecem prazos de entrega de SMS precisos. Em alguns casos, as mensagens SMS podem ser entregues antes do recebimento dos logs do CloudWatch. 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 métricas e logs do CloudWatch para entregas de SMS.

Informações relacionadas

Como gerenciar o envio global de SMS com o Amazon Pinpoint
Monitorar tópicos do Amazon SNS usando o CloudWatch