Configuración del SDK móvil

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).

Instrucciones de configuración paso a paso

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.

2

Configure las credenciales de plataforma

Ingrese las credenciales para su plataforma:

• Android: Configure las credenciales de Firebase
• iOS: Token p8 (Recomendado) o Certificado p12
• Amazon: Genere una clave API
• Huawei: Autorice OneSignal

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.

---

​

Integrar el SDK

​

Otras integraciones

---

​

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:

• Crear usuario
• Crear suscripción
• Actualizar usuario
• Actualizar suscripción
• Crear mensaje
• Referencia de payload de notificación

​

¿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.