Pular para o conteúdo principal

​
Visão geral

Os guias a seguir ajudarão você a configurar o OneSignal SDK em seus apps mobile. Para websites, veja Configuração Web. Para cada plataforma que seu app mobile suporta, você precisará estabelecer uma conexão com FCM (Android), APNS (iOS), HMS (Huawei), e/ou ADM (Amazon). Use as opções abaixo para configurar seu App e Plataforma OneSignal.

​
Configure seu app e plataforma OneSignal

Configuração obrigatória para notificações push Para começar a enviar notificações push com OneSignal, você deve primeiro configurar seu app OneSignal com todas 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 como função admin para configurar o app. Caso contrário, cadastre-se para uma conta gratuita para começar.
Você pode gerenciar múltiplas plataformas (iOS, Android, Huawei, Amazon, Web) sob um único app OneSignal.
1

Crie ou selecione seu app

  • Para adicionar plataformas a um app existente, vá para Settings > Push & In-App no dashboard OneSignal.
  • Para começar do zero, clique em New App/Website e siga as instruções.

Exemplo mostrando criação de um novo app.

2

Configure e ative uma plataforma

  • Escolha um nome claro e reconhecível para seu app e organização.
  • Selecione a(s) plataforma(s) que você quer configurar (iOS, Android, etc.).
  • Clique em Next: Configure Your Platform.

Exemplo configurando seu primeiro app OneSignal, org e canal.

3

Configure credenciais da plataforma

Siga as instruções baseadas nas suas plataformas:Clique em Save & Continue após inserir suas credenciais.
4

Escolha o SDK alvo

Selecione o SDK que corresponde à sua plataforma de desenvolvimento (por exemplo, iOS, Android, React Native, Unity), depois clique em Save & Continue.

Selecione qual SDK você está usando para navegar à documentação.

5

Instale o SDK e salve seu App ID

Uma vez que sua plataforma está configurada, seu OneSignal App ID será exibido. Copie e salve este ID—você precisará dele ao instalar e inicializar o SDK.Se estiver colaborando com outros, use o botão Invite para adicionar desenvolvedores ou membros da equipe, depois clique em Done para completar a configuração.

Salve seu App ID e convide membros adicionais da equipe.

Uma vez completo, siga o guia de instalação do SDK para sua plataforma selecionada para finalizar a integração OneSignal.

​
Guias de configuração do SDK

Google Android Nativo
Guia para integrar OneSignal em apps Android nativos usando FCM.

iOS Nativo
Configuração de SDK iOS nativo usando o serviço APNS da Apple.

Huawei Android Nativo
Configuração de SDK para dispositivos Huawei usando serviços push HMS.

Unity
Guia de SDK cross-platform para apps mobile baseados em Unity.

React Native & Expo
Instruções de configuração para ambientes React Native e Expo.

Cordova
Guia de SDK legado para apps Cordova usando frameworks mais antigos.

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

Flutter
Guia de SDK para apps Flutter usando Dart.

.NET MAUI
Guia para integração com apps .NET MAUI.

​
Integrações

​
FAQ

​
Os SDKs são necessários?

Não, mas são altamente recomendados — e open source no GitHub. Você pode integrar OneSignal usando apenas nossas APIs server-side, mas usar nossos SDKs simplifica e agiliza o processo, especialmente para lidar com notificações push entre plataformas.

​
O que você pode fazer sem o SDK:

Você pode usar as seguintes APIs diretamente:
Se você planeja usar Mensagens in-app, nosso SDK é necessário.

​
Por que recomendamos usar os SDKs:

Notificações push têm requisitos específicos de plataforma que nossos SDKs lidam para você, incluindo:
  • Obter push tokens entre Android, iOS, Huawei e Web
  • Gerenciar status de inscrição e prompts de usuário para opt-in
  • Exibir e processar notificações push no cliente
APNS da Apple e FCM do Google usam formatos de payload diferentes. Notificações OneSignal incluem um payload personalizado que nosso SDK analisa para exibir e rastrear mensagens com precisão. Manter isto manualmente adiciona complexidade. Saiba mais: Build vs. Buy: What Goes Into Building a Push Notification Platform

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

Se o dispositivo tem Google Play Services/Store, ele receberá notificações push através do FCM (Firebase Cloud Messaging). Se o app foi baixado da Huawei AppGallery, ele receberá notificações push através do HMS (Huawei Messaging Service). Você precisará configurar nosso Huawei SDK. OneSignal usa FCM por padrão para dispositivos que suportam tanto HMS quanto FCM. Você pode configurar o Huawei SDK para preferir HMS sobre FCM.

​
Dispositivos Huawei não-HarmonyOS rodando Android podem receber push do OneSignal?

Sim, dispositivos Huawei não-HarmonyOS rodando Android ainda podem usar nosso Huawei SDK.