Como soluciono falhas de notificação push para dispositivos móveis do FCM no Amazon SNS?

Resolução

Configure e visualize os atributos de status de entrega de notificações push para o Amazon CloudWatch Logs

Siga as instruções em How do I access Amazon SNS topic delivery logs for push notifications? (Como posso acessar os logs de entrega de tópicos do Amazon SNS para notificações push?)

Confirme se o dispositivo pode se conectar aos servidores de notificação push

Se o problema estiver ocorrendo somente em um dispositivo específico, verifique se o dispositivo pode se conectar aos servidores de notificação push. Por exemplo, seu firewall pode restringir o tráfego que permite que dispositivos móveis se conectem ao FCM na sua rede. Para obter mais informações, consulte Portas do FCM e seu firewall no site do Firebase.

Verifique se o endpoint da plataforma associado ao dispositivo está ativado

Verifique os logs de entrega das notificações push com falha para o valor “providerResponse”: “O endpoint está desativado”.

Exemplo:

{  "notification": {
    "messageMD5Sum": "c8c339cf07dc39c9388253dgc81f257",
    "messageId": "fg207f98-0244-6767-96e2-45b1fg451gg8",
    "timestamp": "2023-06-23 16:27:51.889"
  },
  "delivery": {
    "deliveryId": "76ab7dcd-f444-5b4f-9d1b-24ea8863d9bc",
    "destination": "arn:aws:sns:us-east-1:123456789101:endpoint/GCM/MyAndroidApp/682dc992-a47f-45f7-b980-97727cce0a9c",
    "providerResponse": "Endpoint is disabled",
    "dwellTimeMs": 28,
    "attempts": 1,
    "token": "ojnco9nc9weucn9encx9ewunc9nu9w9euncec9necn9xexnexex9encewcerve0f0o0dmco9j",
    "statusCode": 400
  },
  "status": "FAILURE"
}

Se você vir o valor “providerResponse”: “O endpoint está desativado” nos logs de entrega com falha, o endpoint da plataforma associado ao dispositivo está desativado. Para solucionar esse problema, consulte Why is my push notification endpoint not active? (Por que meu endpoint de notificação push não está ativo?)

Para obter mais informações, consulte Habilitar novamente um endpoint de plataforma associado a um token de dispositivo inválido.

Verifique se você pode receber notificações diretamente do FCM

Para determinar se o problema está no endpoint do Amazon SNS ou no lado do aplicativo cliente, envie uma mensagem de teste no console do FCM. Para obter instruções, consulte Enviar uma mensagem de notificação de teste no site do Firebase.

Confirme se você está usando o tipo correto de mensagem do FCM

O FCM é compatível com mensagens de notificação e mensagens de dados. O SDK do FCM processa automaticamente as mensagens de notificação. O aplicativo cliente processa mensagens de dados. Para obter mais informações, consulte Tipos de mensagens no site do Firebase. Além disso, consulte Enviar mensagens específicas à plataforma.

Defina a chave de dados para processar dados de mensagens em seu aplicativo cliente

Certifique-se de definir a chave de dados com seus pares de valores-chave personalizados para enviar uma workload para o aplicativo cliente. Para obter mais informações, consulte Mensagens de dados no site do Firebase.

Use o SDK do FCM para exibir notificações para seu aplicativo cliente

Certifique-se de usar a chave de notificação com o conjunto predefinido de opções de valor-chave para a mensagem de notificação. Para obter mais informações, consulte Mensagens de notificação no site do Firebase.

Identifique e solucione problemas com códigos de resposta de erro de notificação push

Execute as etapas a seguir:

1. Examine seus logs de status de entrega para verificar se houve falha nas entregas de notificações push (“status”: “FALHA”).
2. Verifique os logs de entrega de notificações push com falha para ver se há outros códigos de resposta da plataforma.
3. Siga a Ação recomendada listada para os códigos na seção Códigos de resposta de erro de mensagens downstream no site do Firebase.

Para obter mais informações sobre os códigos de erro do FCM e as melhores práticas de solução de problemas, consulte ErrorCode no site do Firebase.

Solucione problemas de mensagens com entrega bem-sucedida, mas que não são exibidas no dispositivo

O dispositivo não recebeu a notificação ou a notificação não é exibida na bandeja de notificação do sistema. Para determinar a causa, inclua instruções de log no manipulador de mensagens do aplicativo.

Se as mensagens forem recebidas como carga de notificação, mas não como carga de dados, examine o manipulador de mensagens no código do aplicativo cliente. Somente o código do aplicativo cliente processa as notificações de dados. Certifique-se de que a notificação seja enviada para a bandeja de notificação do sistema.

Para obter mais informações, consulte Como processar mensagens no site do Firebase.

Solucione problemas em dispositivos Android

Para dispositivos Android, use a página de diagnóstico do FCM para Android para verificar o status da entrega e solucionar o problema. Para abrir a página de diagnóstico do FCM, disque***#*#426#*#*** no discador do Google. Para obter mais informações, consulte FCM Android diagnostics (Diagnóstico do FCM para Android) no site do Firebase.

Informações relacionadas

How do I create an Android platform application in Amazon SNS for push notifications? (Como faço para criar um aplicativo da plataforma Android no Amazon SNS para notificações push?)

Monitorar tópicos do Amazon SNS usando o CloudWatch

Notificações por push para dispositivos móveis

Como faço para criar uma aplicação de plataforma do APNs para enviar notificações por push no Amazon SNS usando a AWS CLI?