Pular para o conteúdo principal
Para enviar notificações push para dispositivos Android através da Google Play Store, o OneSignal requer credenciais do Firebase Cloud Messaging (FCM). Este guia explica como gerar o arquivo JSON de Conta de Serviço necessário e carregá-lo nas configurações do seu aplicativo OneSignal. Para informações técnicas de fundo, veja a documentação de Conta de Serviço do Google.
Este guia é para desenvolvedores integrando o OneSignal com um aplicativo móvel Android distribuído via Google Play Store.

​
Requisitos

​
Configuração

​
1. Criar ou abrir seu Projeto Firebase

Vá para o console do Firebase.
  • Se você ainda não tem um projeto, clique em Adicionar projeto e complete a configuração.
  • Se você já tem um projeto, selecione-o.

​
2. Habilitar Firebase Cloud Messaging API v1

1

Ir para Configurações do Projeto

No Firebase, clique no ícone de engrenagem ao lado de Visão geral do projeto > Configurações do projeto.
2

Ir para Cloud Messaging

Vá para a aba Cloud Messaging.Se Firebase Cloud Messaging API (V1) estiver desabilitada, clique no menu de 3 pontos > Abrir no Cloud Console.
No Google Cloud Console, clique em Habilitar. Aguarde alguns minutos para que a alteração seja refletida no Firebase.

​
3. Gerar um arquivo JSON de Conta de Serviço

1

Retornar para Configurações do Projeto > Contas de Serviço

Na parte inferior, clique em Gerar nova chave privada.
2

Confirmar e gerar chave

Confirme clicando em Gerar chave no popup.
3

Salvar o arquivo

Salve o arquivo .json em um local seguro. Você precisará dele em breve.
Permissões necessárias da Conta de Serviço:
  • cloudmessaging.messages.create
  • firebase.projects.get
Estas estão incluídas por padrão. Se você estiver usando uma Conta de Serviço personalizada, certifique-se de que ela tenha:
  • roles/firebasemessaging.admin
  • roles/firebase.viewer

​
4. Carregar suas credenciais no OneSignal

1

Ir para configurações da plataforma Android

No seu painel OneSignal, vá para: Configurações > Push & No Aplicativo > Plataformas Push > Google Android (FCM).Clique em Ativar.
2

Carregar suas credenciais

Carregue o arquivo .json em Service Account JSON clicando em Escolher arquivo.
Se solicitado, selecione Firebase Cloud Messaging API (V1) no menu suspenso.Para verificar se você está usando o projeto Firebase correto, corresponda o Sender ID no Firebase (Cloud Messaging > Sender ID) com o mostrado em suas configurações do OneSignal.
3

Salvar e continuar

4

Escolher seu SDK

Selecione o SDK que você está usando e clique em Salvar & Continuar.
5

Adicionar o ID do Aplicativo OneSignal ao seu código

Continue seguindo a Configuração do SDK Mobile e adicione este ID do Aplicativo OneSignal ao seu código.
Você conectou com sucesso seu aplicativo OneSignal ao Firebase Cloud Messaging (V1).Em seguida, complete a Configuração do SDK Mobile ou vá para Configuração de push mobile para instruções específicas da plataforma.

​
Perguntas Frequentes

​
Erro: “Esta configuração é para um Projeto Firebase diferente…”

Este erro ocorre quando o arquivo JSON carregado pertence a um projeto Firebase diferente (ou seja, Sender ID diferente). Solução: Use o arquivo JSON do projeto Firebase original. Se não estiver disponível, entre em contato com [email protected] com seu App ID. Trocar de projetos redefine os tokens push—seus usuários devem reabrir o aplicativo para receber push novamente.

​
Posso alterar meu Sender ID?

Não. O Sender ID é bloqueado assim que seu aplicativo ultrapassa 100 usuários Android para evitar invalidação acidental de tokens push. Se necessário, entre em contato com [email protected] com seu App ID para assistência.

​
Preciso atualizar meu código ao mudar para FCM V1?

Não são necessárias alterações no aplicativo ou SDK—esta é uma atualização apenas no painel.

​
Qual é o prazo para mudar para FCM v1?

O Google começou a depreciar APIs FCM legadas em julho de 2024. A migração é fortemente recomendada. Veja o anúncio do Google.

​
Por que não vejo um Sender ID no OneSignal?

Se sua chave de servidor Firebase se parece com AIz..., você provavelmente está usando uma configuração desatualizada do Google Cloud Messaging (GCM). Crie um novo projeto Firebase e carregue um arquivo JSON de Conta de Serviço.

​
Como posso verificar quais aplicativos ainda estão usando a API Legada?

Use a API View apps e verifique por:
  • "gcm_key" → usando Legada, precisa atualizar
  • "fcm_v1_service_account_json" → usando V1 ✅
  • Nenhum → o aplicativo não usa push Android