- Comenzar — accede a tu App de OneSignal y encuentra tus claves API
- Configurar canales de mensajería — instala el SDK y configura los canales
- Referencia de SDK y API — documentación detallada de métodos, clases y endpoints
- Usuarios e identidad — identifica Usuarios, gestiona Suscripciones y protege el acceso
- Pruebas y depuración — verifica tu integración antes de lanzar
- Webhooks y eventos — recibe eventos de mensajes en el lado del servidor
Comenzar
Si tu equipo ya tiene una cuenta de OneSignal, pide a un administrador que te invite a la Organización. De lo contrario, crea una cuenta para empezar. Tu App de OneSignal es donde viven los datos de usuarios y mensajes. Cada App tiene su propio App ID, claves API y canales de mensajería. Puedes tener múltiples Apps en una sola Organización para diferentes proyectos o entornos.Apps, Organizaciones y cuentas
Cómo se relacionan Apps, Organizaciones y cuentas entre sí.
Claves e IDs
Encuentra tu App ID, clave de API REST y Organization ID para autenticación.
Agregar miembros del equipo
Invita desarrolladores y asigna roles dentro de tu Organización.
Uso y facturación
Facturación, facturas y detalles de uso.
Configurar canales de mensajería
Instala el SDK de OneSignal para crear y rastrear la participación de usuarios en tus plataformas. Cada canal de mensajes tiene su propia guía de configuración que cubre credenciales, inicialización del SDK y tutoriales.Configuración del SDK móvil
Configuración del SDK para iOS, Android, Huawei y Amazon. Habilita notificaciones push, mensajes in-app y Live Activities.
Push web
Instalación del Web SDK y configuración de notificaciones push del navegador.
Configuración del canal de email y verificación del dominio del remitente.
Mensajes in-app
Muestra mensajes enriquecidos e interactivos dentro de tu aplicación móvil.
SMS
Configuración del canal SMS y registro con operadores.
RCS
Mensajería enriquecida con contenido de marca y confirmaciones de lectura.
Live Activities
Actualizaciones dinámicas de la pantalla de bloqueo de iOS. Capacidades similares disponibles para Android.
Prompts de push móvil
Configura prompts de opt-in para recopilar Suscripciones push en mobile.
Prompts de push web
Configura prompts de opt-in para recopilar Suscripciones push en web.
Referencia de SDK y API
Documentación detallada para SDKs de cliente, SDKs de servidor y la API REST.Referencia de SDK móvil
Métodos, clases y hooks de eventos para SDKs de iOS, Android y multiplataforma.
Referencia de SDK web
Inicialización, gestión de Usuarios, métodos de Suscripción y disparadores personalizados.
Referencia de SDK de servidor
Instala y configura SDKs de servidor para Node.js, Python, Java, Go, PHP, Ruby, C# y Rust.
Descripción general de la API REST
Endpoints, autenticación, límites de velocidad y formatos de solicitud/respuesta.
Mensajes transaccionales
Envía OTPs, recibos y alertas urgentes mediante API con datos personalizados.
SDKs de servidor en GitHub
Código fuente y ejemplos para todas las bibliotecas de SDK de servidor.
Usuarios e identidad
OneSignal asigna a cada persona un OneSignal ID y rastrea sus dispositivos, direcciones de email y números de teléfono como Suscripciones. Los Usuarios son anónimos hasta que llamas alogin con un External ID para identificarlos. Identificar Usuarios unifica sus Suscripciones en todos los canales y dispositivos.
Usuarios
Modelo de Usuario, External ID, Usuarios anónimos vs. identificados, y login/logout.
Suscripciones
Dispositivos, direcciones de email y números de teléfono que reciben tus mensajes.
Verificación de identidad
Requiere JWTs generados por el servidor para prevenir la suplantación de Usuarios.
Alias
Mapea identificadores personalizados a Usuarios para seguimiento multiplataforma e integraciones.
Etiquetas
Establece datos clave-valor en Usuarios para personalización y segmentación.
Eventos personalizados
Rastrea acciones de Usuario para activar Journeys o potenciar analíticas.
Pruebas y depuración
Verifica que tu integración funcione antes de enviar a toda tu audiencia.Suscripciones de prueba
Encuentra y configura Suscripciones de prueba para push, email y SMS.
Registros de depuración
Captura registros detallados del SDK desde aplicaciones móviles para la resolución de problemas.
Solución de problemas móvil
Resuelve problemas comunes de entrega push, APNS y mensajes in-app.
Solución de problemas web
Soluciona problemas de service worker, compatibilidad del navegador y push web.
Webhooks y eventos
Recibe eventos de mensajes en el lado del servidor para analíticas, automatización o sincronización con sistemas externos.Event Streams
Transmite clics, aperturas, recepciones y otros eventos de mensajes a tu data warehouse en tiempo real.
Webhooks de Journey
Envía solicitudes HTTP a tu servidor desde los pasos del Journey.
Webhooks de push web
Callbacks HTTP para eventos de visualización, clic y cierre de push web.
Preguntas frecuentes
¿Cómo autentico las solicitudes a la API REST?
Incluye tu clave de API REST en el encabezadoAuthorization como token Bearer: Authorization: Key YOUR_REST_API_KEY. Encuentra tu clave en Configuración > Claves e IDs en el dashboard de OneSignal. Consulta Claves e IDs para más detalles.
¿Cuál es la diferencia entre SDKs de cliente y SDKs de servidor?
Los SDKs de cliente (móvil y web) se ejecutan en tu app en el dispositivo del Usuario. Gestionan el registro de Suscripciones, prompts de permiso, mensajes in-app e identificación de Usuario mediantelogin. Los SDKs de servidor se ejecutan en tu backend y llaman a la API REST para enviar mensajes, gestionar Usuarios y exportar datos.
¿Cómo identifico Usuarios en distintos dispositivos?
Llama aOneSignal.login("your_external_id") en cada dispositivo después de que el Usuario inicie sesión. OneSignal fusiona todas las Suscripciones con el mismo External ID bajo un único Usuario. Consulta Usuarios para detalles de implementación.
¿Necesito configurar la verificación de identidad?
La verificación de identidad es opcional pero se recomienda encarecidamente para apps en producción. Sin ella, cualquier cliente puede llamar alogin con un External ID arbitrario. Habilitar la verificación de identidad requiere actualizar el SDK de OneSignal para usar un JWT generado por el servidor, evitando la suplantación.
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages