- Sitio web HTTPS: Web push solo funciona en sitios seguros con un certificado SSL válido
- Service worker: Debes poder agregar el service worker de OneSignal a tu sitio web
- Origen de dominio único: Debe seguir la política de mismo origen
- Permiso del usuario: Los usuarios deben otorgar permiso explícitamente para recibir notificaciones
- Navegadores soportados: Funciona en la mayoría de navegadores modernos (Chrome, Firefox, Safari, Edge)
Guías para desarrolladores web push
Antes de que puedas enviar notificaciones web push, tu desarrollador necesita completar los siguientes pasos.¿No eres desarrollador? Ver Gestionar miembros del equipo para invitar a un compañero de equipo con acceso de desarrollador a tu proyecto OneSignal.
Configuración SDK Web
Guía completa para instalar y configurar el SDK Web de OneSignal, incluyendo pruebas en localhost y prompts de permiso.
Plugin WordPress
Integra rápidamente notificaciones push en WordPress usando nuestro plugin oficial—sin codificación requerida.
Configuración iOS web push
Sigue los pasos específicos de Apple para habilitar web push en iPhones e iPads ejecutando iOS 16.4+.
Migración desde otro proveedor
Aprende a hacer la transición desde otro proveedor web push y retener tus suscriptores.
Opciones de configuración
Configura tu sitio web para web push en el dashboard de OneSignal bajo Settings > Push & In-App > Web.
Sitio típico
Recomendado - Configura prompts, notificación de bienvenida y configuración de service worker directamente en el dashboard—sin codificación backend requerida.
WordPress
Usa el plugin oficial de OneSignal para configurar fácilmente push en tu sitio WordPress con configuración completa basada en UI.
Código personalizado
Configuración de control completo para desarrolladores que quieren personalizar todo a través de código.
- Nombre del sitio: Usado en títulos de notificación predeterminados
- URL del sitio: Debe coincidir exactamente con tu origen de dominio (sin rutas o desajuste de
www) - Resuscripción automática: Recomendado - Resuscribe automáticamente a usuarios recurrentes que limpiaron datos del navegador
- URL de icono predeterminado: Imagen de
256x256pxmostrada en notificaciones (si no se establece, se usa un icono de campana predeterminado)
Resuscripción automática
Si los usuarios limpian sus datos del navegador, dejarán de recibir notificaciones push. Habilita esta opción para resuscribir automáticamente a los usuarios cuando regresen a tu sitio. Ver Suscripciones para más detalles.
Prompts de permiso web
Solicitar permiso de notificación a los usuarios es crítico para el opt-in. Puedes personalizar el comportamiento y apariencia de las solicitudes de permiso según tu configuración.Prompts de permiso web
Compara diferentes tipos de prompt (slidedown, basado en categorías, nativo, campana de suscripción y más) y aprende cuándo usar cada uno.
Referencia SDK Web
Aprende a controlar programáticamente cuándo y cómo se muestran los prompts usando el SDK.
Notificación de bienvenida
Puedes habilitar un push de confirmación opcional que se envía inmediatamente después de que un usuario se suscriba. La integración Típica y WordPress puede establecer esto en el dashboard.
welcomeNotification en la función OneSignal.init. Ver Referencia SDK Web para detalles.
¿Por qué enviar notificaciones de bienvenida?
- Permite que los usuarios sepan que se han suscrito exitosamente
- Muestra cómo se verán las futuras notificaciones
- Proporciona contenido de incorporación o siguientes pasos
Usuarios y suscripciones
Cuando un usuario se suscribe a push, OneSignal automáticamente crea una suscripción única vinculada a su navegador/dispositivo. Las suscripciones web push se crean cuando los usuarios:- Otorgan permiso para notificaciones push en tu sitio web usando un navegador y dispositivo específico
- Regresan a tu sitio después de limpiar datos del navegador (si la Resuscripción automática está habilitada)
- Se suscriben desde un nuevo navegador o dispositivo
Cada combinación de navegador/dispositivo crea una suscripción separada. El modo incógnito/navegación privada no puede crear suscripciones. Las suscripciones web push permanecen anónimas hasta que les asignas un External ID.
Usuarios
Aprende a gestionar usuarios, asignar External IDs y rastrear su actividad.
Suscripciones
Entiende cómo funcionan las suscripciones a través de navegadores y dispositivos.
Segmentos
Agrupa usuarios en segmentos para dirigirte basado en comportamiento, dispositivo y más.
Soporte iOS
Apple agregó soporte web push para iPhones e iPads ejecutando iOS 16.4+ pero con requisitos más estrictos:- Los usuarios deben agregar tu sitio a su pantalla de inicio
- Los prompts de permiso se muestran solo después de ese paso
- Las notificaciones se comportan como alertas de app nativa una vez habilitadas
Web push para iOS
Instrucciones paso a paso para habilitar soporte iOS, incluyendo configuración de service worker y manifest.
Guía de agregar a pantalla de inicio
Consejos para alentar a los usuarios a instalar tu sitio para que puedan recibir iOS web push.
Diseñar notificaciones web push
Crear notificaciones push efectivas involucra más que escribir texto. Aprende qué elementos son personalizables y cómo usarlos efectivamente.
- Título: Encabezado que llama la atención (recomendado: menos de
50caracteres) - Mensaje: Contenido principal de la notificación (recomendado: menos de
120caracteres) - Icono: Tu icono de marca o imagen específica de notificación (recomendado:
256x256pxPNG o JPG) - Imagen grande: Contenido visual llamativo
- Botones de acción: Botones de llamado a la acción
- Navegador: El navegador/app mostrando el push
- Dominio: Tu origen de sitio establecido automáticamente por el navegador
- Marca de tiempo y Descartar: El navegador agrega estos controles
- Más opciones: Controles adicionales específicos del navegador
Descripción general Push
Descripción general completa de la creación de notificaciones push, opciones y comportamiento de entrega.
Plantillas
Ahorra tiempo con plantillas reutilizables para mensajería consistente.
Personalización y localización de mensajes
Puedes personalizar mensajes push para coincidir con las preferencias e idioma de cada usuario.Personalización de mensajes
Inserta variables dinámicas (como nombre o preferencias) para adaptar mensajes.
Mensajería multi-idioma
Entrega automáticamente mensajes en el idioma preferido de cada usuario.
Configurar comportamiento web push
Controla cómo se comportan tus mensajes push después del envío—cuándo aparecen, cuánto tiempo se almacenan y cómo interactúan los usuarios.Configuraciones de entrega, visualización y descarte
Throttling
Controla la velocidad de entrega de notificaciones.
Frequency Capping
Establece límites para prevenir el sobre-envío de notificaciones al mismo usuario.
Time To Live (TTL)
Define cuánto tiempo los servicios push retienen mensajes cuando el dispositivo está offline.
Web Push Topic
Usa temas para agrupar, reemplazar o suprimir notificaciones duplicadas.
Comportamiento de clic
Controla qué sucede cuando un usuario hace clic en una notificación. Por defecto: Hacer clic abre tu página de inicio. Personalízalo:- Dirige usuarios a una URL específica
- Usa tracking UTM
- Suprime el comportamiento predeterminado con
?_osp=do_not_open
URLs, enlaces y Deep Linking
Dirige usuarios a contenido o páginas relevantes usando deep links y tracking.
Botones de acción
Permite que los usuarios tomen acciones inmediatas desde tu notificación.
SDK Push Notification Event Listeners
Escucha eventos de clic y activa comportamiento in-app con código personalizado.
Prueba tu configuración
Antes de lanzar, prueba exhaustivamente tu implementación web push a través de dispositivos y navegadores.Lista de verificación pre-lanzamiento
- SDK está cargado correctamente sin errores
- El prompt de permiso aparece y funciona
- La notificación de prueba se envía y recibe
- Los iconos e imágenes se renderizan correctamente
- El service worker está registrado y actualizado
- El certificado HTTPS es válido
Analytics push y solución de problemas
Mide el rendimiento de notificaciones y resuelve problemas comunes de entrega:Reportes de mensajes push
Ve métricas de entrega, tasa de apertura y clics para cada mensaje.
Descripción general de analytics
Explora métricas de engagement y comportamiento del usuario a través de canales.
Notificaciones no mostradas o retrasadas
Lista de verificación de solución de problemas si los mensajes no aparecen.
Imágenes de notificación no se muestran
Soluciona problemas de renderizado de imágenes a través de diferentes navegadores.
Próximos pasos
Pruebas A/B
Optimiza mensajes con experimentos para encontrar qué impulsa el engagement.
Journeys
Construye flujos de mensajería automatizados de múltiples pasos disparados por el comportamiento del usuario.
Etiquetas
Agrega datos a nivel de usuario para personalización y targeting.
Analytics
Rastrea métricas de engagement y conversión a través de canales.
Preguntas frecuentes
¿Pueden los usuarios suscribirse a web push en iOS?
Sí, comenzando con iOS 16.4+. Los usuarios primero deben agregar tu sitio web a su pantalla de inicio, luego otorgar permiso de notificación. Ver Web push para iOS para los pasos completos de configuración.¿Por qué un usuario dejó de recibir notificaciones web push?
La causa más común es que el usuario limpió sus datos del navegador, lo que elimina la suscripción push. Habilita Auto Resubscribe en tu configuración de web push para resuscribir automáticamente a usuarios recurrentes. Ver Suscripciones para más detalles.¿Funcionan las notificaciones web push en modo Incógnito o navegación privada?
No. Los usuarios no pueden suscribirse a web push mientras están en modo incógnito o navegación privada. Las suscripciones creadas en una sesión normal no son accesibles en modo privado.¿Qué navegadores admiten notificaciones web push?
Chrome, Firefox, Safari (macOS e iOS 16.4+) y Edge admiten web push. Cada navegador puede tener diferente comportamiento de prompt y visualización de notificaciones. Ver Web push FAQ para detalles específicos de cada navegador.¿Puedo usar subdominios con web push?
Cada subdominio (por ejemplo,app.example.com vs shop.example.com) es un origen separado. Los navegadores aplican la política de mismo origen para web push, por lo que cada subdominio requiere su propia aplicación de OneSignal. El service worker también debe estar alojado en el mismo origen que la página de suscripción — no se permiten CDN ni otros subdominios. Ver Múltiples sitios y subdominios para opciones de configuración.