- Comenzar: encuentra tu App ID y claves API
- Instalar el SDK: instala el SDK móvil o web
- Usuarios e identidad: identifica Usuarios, gestiona Suscripciones y protege el acceso
- Probar tu integración: verifica la entrega antes de lanzar
- Solución de problemas: depura problemas de entrega
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 contiene los datos de usuarios y mensajes, incluyendo el App ID y las claves API que necesitas para configurar el SDK. Aprende cómo se relacionan Apps, Organizaciones y cuentas si gestionas múltiples proyectos o entornos.Claves e IDs
Encuentra tu App ID, clave de API REST y Organization ID para autenticación.
Instalar el SDK
Instala el SDK de OneSignal para tu plataforma.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.
Configuración del SDK web
Instalación del Web SDK y configuración de notificaciones push del navegador.
- Windows
- macOS (las apps de Mac Catalyst son compatibles a través de nuestro SDK de iOS)
- watchOS y Wear OS
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.
Etiquetas
Agrega propiedades personalizadas a los usuarios para personalización y segmentación.
Eventos personalizados
Rastrea acciones de Usuario para activar Journeys o potenciar analíticas.
Probar tu integración
Verifica la entrega, el renderizado y los deep links con Usuarios de prueba antes de enviar a toda tu audiencia.Usuarios de prueba
Encuentra y configura usuarios de prueba para push, email y SMS.
Solución de problemas
Comienza con un registro de depuración y luego usa la guía de la plataforma que corresponda a tu integración.Solución de problemas móvil
Resuelve problemas comunes de entrega de push, APNs y mensajería in-app.
Solución de problemas del SDK web
Corrige errores de service worker, discrepancias de origen y notificaciones que no se muestran.
Registros de depuración
Habilita el registro detallado, reproduce el problema y comparte los registros con soporte.
Restablecer permisos de web push
Borra la caché del navegador, los service workers y los permisos de notificación para una prueba limpia.
Después de la configuración
Explora casos de uso comunes y consulta los métodos del SDK o los endpoints de la API REST mientras desarrollas.Tutoriales y casos de uso
Explora guías de implementación para carritos abandonados, flujos de incorporación, campañas de reactivación y más.
Etiquetas
Agrega propiedades personalizadas a los usuarios para personalización y segmentación.
Eventos personalizados
Rastrea acciones de Usuario para activar Journeys o potenciar analíticas.
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.
Preguntas frecuentes
¿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.