Saltar al contenido principal
El SDK móvil de OneSignal habilita notificaciones push, mensajes in-app y Live Activities en tus apps de iOS, Android, Huawei y Amazon. La configuración tiene dos pasos:
  1. Configurar las credenciales de la plataforma — conecta tus credenciales de FCM, APNs, HMS o ADM a OneSignal
  2. Integrar el SDK — instala el SDK de OneSignal para tu plataforma e inicialízalo en tu app
Para sitios web, consulta Configuración del Web SDK.

Configurar las credenciales de la plataforma

Cada plataforma requiere sus propias credenciales push. Configura las credenciales para cada plataforma que tu app soporta antes de integrar el SDK.

Configure su aplicación y plataforma de OneSignal

Configure su aplicación de OneSignal con las plataformas que admite — Apple (APNs), Google (FCM), Huawei (HMS) y/o Amazon (ADM).
Si su organización ya tiene una cuenta de OneSignal, solicite ser invitado a la Organización. De lo contrario, regístrese para obtener una cuenta gratuita para comenzar.
1

Cree o seleccione su aplicación

Cree una nueva aplicación haciendo clic en Nueva aplicación/sitio web, o agregue una plataforma a una aplicación existente en Configuración > Push e In-App. Seleccione la(s) plataforma(s) que desea configurar y haga clic en Siguiente: Configure su plataforma.
Panel de OneSignal que muestra el flujo de configuración de nueva aplicación con nombre de organización, nombre de app y selección de canal
2

Configure las credenciales de plataforma

Ingrese las credenciales para su plataforma:Haga clic en Guardar y continuar después de ingresar sus credenciales.
3

Guarde su ID de aplicación e instale el SDK

Su ID de aplicación se muestra en la pantalla final. Cópielo y guárdelo — lo necesita al inicializar el SDK. Seleccione su plataforma de SDK y siga la guía de configuración.
Panel de OneSignal que muestra el ID de aplicación y la opción de invitar al equipo después de la configuración

Integrar el SDK

Android nativo

Integra el SDK de OneSignal en apps Android nativas usando FCM.

iOS nativo

Integra el SDK de OneSignal en apps iOS nativas usando APNs.

React Native y Expo

Configuración para entornos React Native y Expo.

Flutter

Configuración del SDK para apps Flutter usando Dart.

Unity

Configuración del SDK multiplataforma para apps móviles basadas en Unity.

.NET MAUI

Integra el SDK de OneSignal con apps .NET MAUI.

Huawei Android nativo

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

Cordova, Ionic y Capacitor

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

Otras integraciones

FlutterFlow

Configuración del SDK low-code para apps FlutterFlow.

Median.co

Guía de integración para apps Median.co (anteriormente GoNative.io).

Versiones del SDK


Preguntas frecuentes

¿Son requeridos los SDKs?

No, pero son altamente recomendados y de código abierto en GitHub. Puedes integrar OneSignal usando solo la REST API, pero los SDKs simplifican el proceso significativamente, especialmente para manejar notificaciones push en todas las plataformas.

¿Qué puedo hacer sin el SDK?

Puedes usar las siguientes APIs directamente:
Los mensajes in-app y las Live Activities requieren el SDK — no se pueden entregar solo mediante API.

¿Por qué recomiendan usar los SDKs?

Las notificaciones push tienen requisitos específicos de la plataforma que los SDKs manejan por ti, incluyendo:
  • Obtener push tokens en Android, iOS, Huawei y web
  • Gestionar el estado de suscripción y los prompts de opt-in del usuario
  • Mostrar y procesar notificaciones push en el cliente
Los APNs de Apple y FCM de Google usan diferentes formatos de payload. El SDK de OneSignal analiza los payloads personalizados para mostrar y rastrear mensajes con precisión. Mantener esto manualmente agrega una complejidad significativa. Aprende más: Build vs. Buy: What Goes Into Building a Push Notification Platform

¿Necesito apps de OneSignal separadas para iOS y Android?

No. Una sola app de OneSignal soporta múltiples plataformas — iOS, Android, Huawei, Amazon y web. Configura las credenciales de cada plataforma en Settings > Push & In-App y todas comparten la misma app, usuarios y segmentos.

¿Pueden los dispositivos en China o en Huawei recibir notificaciones push?

Si el dispositivo tiene Google Play Services, recibe push a través de FCM. Si la app fue descargada desde Huawei AppGallery (incluidos los dispositivos Huawei no-HarmonyOS ejecutando Android), recibe push a través de HMS — configura el SDK de Huawei para habilitarlo. OneSignal usa FCM por defecto para dispositivos que soportan tanto HMS como FCM. Puedes preferir HMS sobre FCM si es necesario.