Pular para o conteúdo principal
O SDK mobile do OneSignal habilita notificações push, mensagens in-app e Live Activities nos seus apps iOS, Android, Huawei e Amazon. A configuração tem duas etapas:
  1. Configurar credenciais da plataforma — conecte suas credenciais FCM, APNs, HMS ou ADM ao OneSignal
  2. Integrar o SDK — instale o SDK do OneSignal para sua plataforma e inicialize-o no seu app
Para websites, consulte Configuração do Web SDK.

​
Configurar credenciais da plataforma

Cada plataforma requer suas próprias credenciais push. Configure as credenciais para cada plataforma que seu app suporta antes de integrar o SDK.

​
Configure seu app e plataforma OneSignal

Configure seu app OneSignal com as plataformas que você suporta — Apple (APNs), Google (FCM), Huawei (HMS) e/ou Amazon (ADM).
Se sua organização já tem uma conta OneSignal, peça para ser convidado à Organização. Caso contrário, cadastre-se para uma conta gratuita para começar.
1

Crie ou selecione seu app

Crie um novo app clicando em New App/Website, ou adicione uma plataforma a um app existente em Settings > Push & In-App. Selecione a(s) plataforma(s) que você quer configurar e clique em Next: Configure Your Platform.
Dashboard do OneSignal mostrando o fluxo de configuração de novo app com nome da organização, nome do app e seleção de canal
2

Configure credenciais da plataforma

Insira as credenciais para sua plataforma:Clique em Save & Continue após inserir suas credenciais.
3

Salve seu App ID e instale o SDK

Seu App ID é exibido na tela final. Copie e salve-o — você precisa dele ao inicializar o SDK. Selecione sua plataforma de SDK e siga o guia de configuração.
Dashboard do OneSignal mostrando o App ID e a opção de convite de equipe após a configuração

​
Integrar o SDK

Android nativo

Integre o SDK do OneSignal em apps Android nativos usando FCM.

iOS nativo

Integre o SDK do OneSignal em apps iOS nativos usando APNs.

React Native e Expo

Configuração para ambientes React Native e Expo.

Flutter

Configuração do SDK para apps Flutter usando Dart.

Unity

Configuração do SDK multiplataforma para apps mobile baseados em Unity.

.NET MAUI

Integre o SDK do OneSignal com apps .NET MAUI.

Huawei Android nativo

Configuração do SDK para dispositivos Huawei usando serviços push HMS.

Cordova, Ionic e Capacitor

Configuração para apps mobile híbridos Cordova, Ionic e Capacitor.

​
Outras integrações

FlutterFlow

Configuração do SDK low-code para apps FlutterFlow.

Median.co

Guia de integração para apps Median.co (anteriormente GoNative.io).

​
Versões do SDK

​
FAQ

​
Os SDKs são necessários?

Não, mas são altamente recomendados e open source no GitHub. Você pode integrar o OneSignal usando apenas a REST API, mas os SDKs simplificam significativamente o processo, especialmente para lidar com notificações push entre plataformas.

​
O que posso fazer sem o SDK?

Você pode usar as seguintes APIs diretamente:
Mensagens in-app e Live Activities requerem o SDK — elas não podem ser entregues apenas via API.

​
Por que vocês recomendam usar os SDKs?

Notificações push têm requisitos específicos de plataforma que os SDKs lidam para você, incluindo:
  • Obter push tokens em Android, iOS, Huawei e web
  • Gerenciar status de assinatura e prompts de opt-in do usuário
  • Exibir e processar notificações push no cliente
Os APNs da Apple e o FCM do Google usam formatos de payload diferentes. O SDK do OneSignal analisa payloads personalizados para exibir e rastrear mensagens com precisão. Manter isso manualmente adiciona complexidade significativa. Saiba mais: Build vs. Buy: What Goes Into Building a Push Notification Platform

​
Preciso de apps OneSignal separados para iOS e Android?

Não. Um único app OneSignal suporta múltiplas plataformas — iOS, Android, Huawei, Amazon e web. Configure as credenciais de cada plataforma em Settings > Push & In-App e todas compartilham o mesmo app, usuários e segmentos.

​
Dispositivos na China ou na Huawei podem receber notificações push?

Se o dispositivo tem Google Play Services, recebe push via FCM. Se o app foi baixado da Huawei AppGallery (incluindo dispositivos Huawei não-HarmonyOS rodando Android), recebe push via HMS — configure o SDK Huawei para habilitar isso. O OneSignal usa FCM por padrão para dispositivos que suportam tanto HMS quanto FCM. Você pode preferir HMS sobre FCM se necessário.