Integração com OneSignal

1Crie uma conta no OneSignal#

Crie uma conta grátis no OneSignal para começar com as notificações push. O OneSignal oferece notificações push ilimitadas de graça.

Ir para OneSignal.com →

2Crie um novo app#

No painel do OneSignal:

• Clique em 'New App/Website'
• Digite o nome do seu app
• Selecione 'Google Android (FCM)' como plataforma
• Clique em 'Next'

3Crie o projeto no Firebase#

Você precisa de um projeto no Firebase para o OneSignal funcionar. Acesse o Firebase Console e crie um novo projeto ou use um existente.

Abrir o Firebase Console →

4Adicione o app Android ao Firebase#

No seu projeto do Firebase:

• Clique em 'Add App' e selecione Android
• Informe o nome do pacote do seu app (DEVE ser igual ao nome do pacote definido no gerador)
• Baixe o arquivo 'google-services.json'
• ⚠️ IMPORTANTE: este é o arquivo que você vai enviar ao gerador Web2APK mais tarde.
• Clique em 'Continue' e conclua a configuração

5Crie a chave da conta de serviço do Firebase#

O OneSignal exige um JSON de conta de serviço do Firebase para enviar notificações a partir do servidor deles.

No Firebase Console:

• Vá em Project Settings > aba Service accounts
• Clique em 'Generate new private key'
• Confirme e baixe o arquivo JSON

⚠️ ATENÇÃO: este arquivo é SOMENTE para o painel do OneSignal. NÃO envie este arquivo para o gerador Web2APK.

Abrir o Firebase Console →

6Configure o OneSignal com a conta de serviço#

De volta à configuração no painel do OneSignal:

• Quando pedirem as credenciais do Firebase, escolha 'Upload Service Account File'
• Envie o JSON da conta de serviço que você baixou do Firebase
• Clique em 'Save & Continue'
• Copie o App ID do seu OneSignal (você vai precisar dele no gerador)

7Configuração no Gerador Web2APK#

No app gerador:

1. Ative 'OneSignal' na Etapa 3
2. Clique no botão 'Upload google-services.json'
3. Selecione o arquivo 'google-services.json' (o da Etapa 4)

⚠️ NÃO envie aqui a chave da conta de serviço da Etapa 5!

1. Cole o App ID do seu OneSignal
2. Gere seu APK

OneSignal App ID format:
12345678-1234-1234-1234-123456789012

8Teste as notificações push#

Depois de instalar seu APK gerado:

• Abra o app no seu dispositivo
• Vá ao painel do OneSignal
• Vá em 'Messages' > 'New Push'
• Escreva e envie uma notificação de teste
• Você deve recebê-la no seu dispositivo em poucos segundos

9Notas importantes#

⚠️ Nome do pacote: o nome do pacote no Firebase DEVE ser exatamente igual ao nome do pacote do seu app

⚠️ Envio de arquivo: sempre envie o google-services.json ao usar o OneSignal; caso contrário, as notificações não vão funcionar

⚠️ Primeira abertura: os usuários precisam abrir o app pelo menos uma vez para receber notificações

✅ Grátis para sempre: o OneSignal é 100% grátis, com notificações ilimitadas