Saltar al contenido principal

​
Resumen

Las siguientes guías te ayudarán a configurar el SDK de OneSignal en tus apps móviles. Para sitios web, consulta Configuración web. Para cada plataforma que tu app móvil soporta, necesitarás establecer una conexión con FCM (Android), APNS (iOS), HMS (Huawei) y/o ADM (Amazon). Usa las opciones a continuación para configurar tu app y plataforma de OneSignal.

​
Configure your OneSignal app and platform

Required setup for push notifications To start sending push notifications with OneSignal, you must first configure your OneSignal app with all the platforms your support—Apple (APNs), Google (FCM), Huawei (HMS), and/or Amazon (ADM).
If your organization already has a OneSignal account, ask to be invited as an admin role to configure the app. Otherwise, sign up for a free account to get started.
You can manage multiple platforms (iOS, Android, Huawei, Amazon, Web) under a single OneSignal app.
1

Create or select your app

  • To add platforms to an existing app, go to Settings > Push & In-App in the OneSignal dashboard.
  • To start fresh, click New App/Website and follow the prompts.

Example shows creating a new app.

2

Set up and activate a platform

  • Choose a clear and recognizable name for your app and organization.
  • Select the platform(s) you want to configure (iOS, Android, etc.).
  • Click Next: Configure Your Platform.

Example setting up your first OneSignal app, org, and channel.

3

Configure platform credentials

Follow the prompts based on your platforms:Click Save & Continue after entering your credentials.
4

Choose target SDK

Select the SDK that matches your development platform (e.g., iOS, Android, React Native, Unity), then click Save & Continue.

Select which SDK you are using to be navigated to the docs.

5

Install SDK and save your App ID

Once your platform is configured, your OneSignal App ID will be displayed. Copy and save this ID—you’ll need it when installing and initializing the SDK.If collaborating with others, use the Invite button to add developers or teammates, then click Done to complete setup.

Save your App ID and invite additional team members.

Once complete, follow the SDK installation guide for your selected platform to finish integrating OneSignal.

​
Guías de configuración del SDK

Google Android nativo
Guía para integrar OneSignal en apps Android nativas usando FCM.

iOS nativo
Configuración del SDK nativo de iOS usando el servicio APNS de Apple.

Huawei Android nativo
Configuración del SDK para dispositivos Huawei usando servicios push de HMS.

Unity
Guía del SDK multiplataforma para apps móviles basadas en Unity.

React Native y Expo
Instrucciones de configuración para entornos React Native y Expo.

Cordova
Guía del SDK legacy para apps Cordova usando frameworks antiguos.

Ionic e Ionic Capacitor
Configuración para apps móviles híbridas de Ionic y Capacitor.

Flutter
Guía del SDK para apps Flutter usando Dart.

.NET MAUI
Guía para integrar con apps .NET MAUI.

​
Integraciones

​
Preguntas frecuentes

​
¿Son requeridos los SDKs?

No, pero son altamente recomendados — y de código abierto en GitHub. Puedes integrar OneSignal usando solo nuestras APIs del lado del servidor, pero usar nuestros SDKs simplifica y agiliza el proceso, especialmente para manejar notificaciones push en todas las plataformas.

​
Qué puedes hacer sin el SDK:

Puedes usar las siguientes APIs directamente:
Si planeas usar Mensajes en la app, nuestro SDK es requerido.

​
Por qué recomendamos usar los SDKs:

Las notificaciones push tienen requisitos específicos de la plataforma que nuestros SDKs manejan por ti, incluyendo:
  • Obtener tokens push en Android, iOS, Huawei y Web
  • Administrar el estado de suscripción y los prompts de usuario para opt-in
  • Mostrar y procesar notificaciones push en el cliente
APNS de Apple y FCM de Google usan diferentes formatos de carga. Las notificaciones de OneSignal incluyen una carga personalizada que nuestro SDK analiza para mostrar y rastrear mensajes con precisión. Mantener esto manualmente agrega complejidad. Aprende más: Construir vs. Comprar: Qué implica construir una plataforma de notificaciones push

​
¿Pueden los dispositivos en China recibir notificaciones push?

Si el dispositivo tiene Google Play Services/Store, recibirá notificaciones push a través de FCM (Firebase Cloud Messaging). Si la app fue descargada desde Huawei AppGallery, recibirá notificaciones push a través de HMS (Huawei Messaging Service). Necesitarás configurar nuestro SDK de Huawei. OneSignal usa FCM de forma predeterminada para dispositivos que soportan tanto HMS como FCM. Puedes configurar el SDK de Huawei para preferir HMS sobre FCM.

​
¿Pueden los dispositivos Huawei no-HarmonyOS ejecutando Android recibir push desde OneSignal?

Sí, los dispositivos Huawei no-HarmonyOS ejecutando Android aún pueden usar nuestro SDK de Huawei.