Solução de problemas do canal de push - Amazon Pinpoint

Aviso de fim do suporte: em 30 de outubro de 2026, a AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para acessar mais informações, consulte Amazon Pinpoint end of support. Observação: as APIs relacionadas a SMS, voz, notificações push para dispositivos móveis, OTP e validação de número de telefone não são afetadas por essa alteração e são compatíveis com o AWS End User Messaging.

Solução de problemas do canal de push

Verifique se o registro em log está ativado para ajudar a identificar a causa da falha. Para obter mais informações, consulte Monitorar e registrar em log. Para notificações por push transacionais que não são enviadas por meio de uma campanha ou jornada, registre a resposta da API para saber o status da entrega.

Monitorar problemas de entrega

  • Para mensagens diretas de notificação por push enviadas pela API SendMessages, verifique se você captura a resposta da API para obter informações sobre a entrega. Para fazer isso, revise o atributo StatusMessage dentro do objeto EndpointResult na resposta. Esse atributo contém os Códigos de resposta da plataforma recebidos do Downstream Push Notification Service.

  • Para campanhas, verifique se o registro em log por meio do Kinesis Data Streams está ativado. Analise os Códigos de resposta da plataforma no evento _campaign.send para ver o resultado da entrega recebido pelo Amazon Pinpoint do Downstream Push Notification Service.

Mensagem não recebida

Problemas e soluções
  • Problemas de conectividade do dispositivo: se o problema estiver ocorrendo apenas em determinados dispositivos, verifique se esses dispositivos não estão impedidos de se conectar aos endpoints do serviço de notificações por push. Consulte Portas do FCM e seu firewall e Se seus dispositivos Apple não estão recebendo notificações por push da Apple.

  • Valor do atributo de endpoint OptOut: se um valor de OptOut do endpoint estiver definido como ALL, o endpoint não receberá notificações. Use a CLI get-endpoint para confirmar se o valor de OptOut do endpoint está definido como NONE. Se o endpoint estiver como cancelou o recebimento, as mensagens enviadas por meio de campanhas ou jornadas não serão entregues ao endpoint e nenhum log será gerado.

  • Ambiente de token: verifique se o tipo de canal do seu endpoint do Amazon Pinpoint corresponde ao token gerado para o dispositivo. Por exemplo, use o GCM como canal para um endereço de token de aplicativo com integração com o FCM e para APNs, APNS_Sandbox para o aplicativo em sandbox ou APNS para aplicativo em produção.

    Para obter informações sobre tentativas de entrega com status de falha, consulte os Códigos de resposta de notificação por push para o respectivo canal de push usado na tentativa de entrega.

As mensagens não são exibidas

  • Se os logs mostrarem uma entrega bem-sucedida e se as mensagens não forem exibidas na bandeja de notificação do sistema, isso indica um problema com a notificação sendo entregue ao dispositivo, mas não sendo tratada adequadamente na aplicação cliente.

  • Você pode ver que os logs de eventos do Kinesis mostram um status de Entrega bem-sucedida ou que um problema ocorre apenas com uma carga útil ou tipo de mensagem específico. Esse problema pode indicar que a notificação está sendo entregue ao dispositivo, mas não está sendo exibida na bandeja de notificação do sistema.

    Isso pode ocorrer com uma carga útil de solicitação ou tipo de mensagem específico (por exemplo, dados para FCM, silencioso para APNs). Por exemplo, se as mensagens forem recebidas como carga útil de alerta/notificação, mas não como carga útil de dados/silenciosa, verifique qual é a ação pretendida quando um tipo de mensagem de dados, notificação, alerta ou plano de fundo é recebido na aplicação e se ela pode lidar com os diferentes tipos de mensagem.

  • Para solucionar problemas, incorpore declarações de log no manipulador de mensagem do aplicativo. Para ver um exemplo, consulte FCM e APNs. Isso ajuda a determinar se a notificação é recebida pelo dispositivo, mas não exibida na bandeja de notificações do sistema.