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.

Página de Projetos dentro do Firebase

​
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.

Submenu do ícone de engrenagem do Firebase, mostrando 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.

Firebase Cloud Messaging API (V1) está desabilitada nesta imagem. Certifique-se de que esteja habilitada para seu projeto.

No Google Cloud Console, clique em Habilitar. Aguarde alguns minutos para que a alteração seja refletida no Firebase.

Habilitar Firebase Cloud Messaging API v1.

​
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.

Seção de Contas de Serviço dentro do Firebase

2

Confirmar e gerar chave

Confirme clicando em Gerar chave no popup.

🔒 Este arquivo contém credenciais sensíveis. Não o compartilhe ou o inclua no controle de versão.

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.

Tela de Plataformas nas configurações do aplicativo OneSignal

2

Carregar suas credenciais

Carregue o arquivo .json em Service Account JSON clicando em Escolher arquivo.

Tela de configuração FCM

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.

Tela de seleção de SDK

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.

Tela de instalação e teste de configuração Android

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 support@onesignal.com 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 support@onesignal.com 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