Partilhar via

Migrar notificações por push do SDK do Android para o Firebase Cloud Messaging HTTP v1

  • Artigo

Este artigo se aplica a aplicativos de chamada e bate-papo que usam o SDK do Android com notificação por push do Firebase Cloud Messaging (FCM). O FCM era anteriormente conhecido como Google Cloud Messaging (GCM/FCM).

Em 20 de junho de 2023, o Google anunciou que desativou o envio de mensagens usando as APIs herdadas do FCM. O Google está removendo o FCM legado do serviço em junho de 2024. O Google recomenda a migração de APIs herdadas do FCM para o FCM HTTP v1.

Se você tiver um novo aplicativo Android ou nunca tiver usado o Google FCM, consulte o artigo Registrar para notificações por push do SDK do Android usando o FCM v1 .

Se seu aplicativo Android usa o recurso de notificação por push, conclua as etapas a seguir para migrar sua notificação por push para o FCM HTTP v1.

1. Gere uma chave privada no console do Firebase

  1. Abra seu projeto no console do Firebase.

  2. Abra as configurações do Project Contas> de serviço.

  3. Selecione qualquer linguagem de programação.

  4. Clique em Gerar nova chave privada para baixar um arquivo JSON contendo sua nova chave privada.

    Captura de tela de como gerar nova chave privada para FMC v1 no console Firebase.

  5. Localize e abra o arquivo JSON baixado. Você precisa de valores desse arquivo para a próxima etapa.

2. Forneça as credenciais de chave privada para o Google (FCM v1)

  1. Abra o Hub de Notificação dos Serviços de Comunicação do Azure no portal do Azure.

  2. Abra Configurações>do Google (FCM v1).

  3. Insira os valores do arquivo JSON baixado nas caixas de texto para Chave Privada, Email do Cliente e ID do Projeto.

    Captura de tela de como fornecer uma nova credencial de chave privada para o FCM v1 nas configurações do portal do Azure.

  4. Clique em Guardar.

3. Remova as credenciais herdadas do Google (GCM/FCM)

  1. Abra o Hub de Notificação dos Serviços de Comunicação do Azure no portal do Azure.

  2. Abra Configurações>do Google (GCM/FCM).

  3. Desmarque a caixa de texto Chave da API.

    Captura de tela de como remover credenciais herdadas para GCM/FCM das configurações do portal do Azure.

  4. Clique em Guardar.

4. Verifique se seu aplicativo recebe notificações por push

  1. Aguarde alguns minutos até que as alterações feitas no Hub de Notificação entrem em vigor. Seu aplicativo pode enfrentar notificações por push duplicadas ou notificações perdidas durante esse período.

  2. Certifique-se de que seu aplicativo recebe notificações por push sem erros.

Resolução de Problemas

Se seu aplicativo não puder receber notificações por push, verifique se as novas credenciais do FCM v1 estão corretas. Repita as etapas neste documento conforme necessário para Gerar uma chave privada no console do Firebase ou Fornecer as credenciais da chave privada para o Google (FCM v1).

Se o seu aplicativo ainda não puder receber notificações por push, entre em contato com os Serviços de Comunicação do Azure no suporte do Microsoft Azure Help+.

Ativar notificações push na sua aplicaçãode chat Android Ativar notificações push para chamadas