Skip to main content
Sigue esta guía para habilitar web push y así alcanzar a los usuarios con contenido oportuno cuando no están en tu sitio. Web push soporta texto, imágenes, botones de acción y sonidos.
Web push notification examples across different browsers and devices

Las notificaciones web push alcanzan a los usuarios incluso cuando no están en tu sitio

Web push requiere:
  • Un sitio web HTTPS seguro con un certificado SSL válido
  • La capacidad de agregar el service worker de OneSignal a tu sitio web
  • Un origen único que siga la política de mismo origen
  • Permiso del usuario para recibir notificaciones
  • Navegadores soportados (Chrome, Firefox, Safari, Edge)
Los usuarios no pueden suscribirse en modo incógnito o de navegación privada. iOS requiere configuración adicional. Ver Web push para iOS. Algunos navegadores limitan los prompts o requieren un gesto del usuario. Ver Web push FAQ.

​
Elige tu guía de configuración

Completa una de estas rutas de configuración de sitio.
¿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

Sitio típico: configura el dashboard, sube el service worker y agrega el SDK de JavaScript.

Plugin WordPress

Plugin oficial de OneSignal. No requiere SDK de JavaScript ni subir el service worker.

Configuración Shopify

Conecta Shopify a través de la integración Vendo. Vendo despliega el SDK en tu tienda.

Migración desde otro proveedor

Múdate desde otro proveedor web push y retén tus suscripciones.
Si tu sitio está construido con Angular, React o Vue, usa la guía del framework correspondiente. Si cargas el SDK con Google Tag Manager, termina la configuración del dashboard y del service worker en Configuración SDK Web y luego inicializa en GTM. Web push en iOS para iPhones y iPads funciona a partir de iOS 16.4+. Después de terminar una ruta de configuración de sitio, agrega un manifest.json y haz que los usuarios agreguen tu sitio a su pantalla de inicio.

Configuración iOS web push

Requisitos adicionales de Apple después de terminar una ruta de configuración de sitio.

​
Tipos de integración

En el dashboard de OneSignal, ve a Settings > Push & In-App > Web y selecciona el tipo de integración que coincida con tu sitio.
OneSignal dashboard showing integration type options: Typical Site, WordPress, and Custom Code

Elige tu tipo de integración basado en la configuración de tu sitio web

Sitio típico

Recomendado. Configura prompts, notificación de bienvenida y ruta del service worker en el dashboard.

WordPress

Requerido si usas el plugin oficial de OneSignal para WordPress.

Código personalizado

Control total sobre los prompts y las opciones de init en código.
Shopify no es una opción del dashboard. Las tiendas Shopify deben usar Código personalizado. Sitio típico no puede establecer la ruta del service worker de Vendo, por lo que las suscripciones fallan. Ver Configuración Shopify.
Después de seleccionar un tipo de integración, termina la guía de configuración correspondiente. Los detalles de los campos de Sitio típico están en Configuración SDK Web. Los detalles de los campos de Código personalizado están en Configuración con código personalizado.

​
Prompts de permiso web

Los usuarios deben otorgar permiso antes de poder recibir web push. Los navegadores muestran un diálogo nativo del sistema para ese permiso. OneSignal recomienda mostrar primero un pre-prompt personalizable para que puedas explicar el valor y evitar que el navegador bloquee los prompts nativos repetidos. Sitio típico y WordPress: agrega, elimina y actualiza prompts en el dashboard de OneSignal en cualquier momento. Código personalizado: controla los prompts en OneSignal.init(). Ver la Referencia SDK Web.
Explica el beneficio en el pre-prompt, muéstralo después del engagement (no en la primera carga de página) y luego abre el diálogo nativo del navegador solo cuando el usuario acepte.

Prompts de permiso web

Compara los prompts slidedown, de categorías, nativo, campana de suscripción y otros tipos.

Referencia SDK Web

Muestra u oculta prompts en código con el SDK Web.
iOS no muestra el prompt de permiso hasta que el usuario agrega tu sitio a su pantalla de inicio. Ver Web push para iOS.

​
Usuarios y suscripciones

Cuando un usuario se suscribe a push, OneSignal crea una suscripción vinculada a ese navegador y dispositivo. Las suscripciones web push se crean cuando los usuarios:
  • Otorgan permiso para notificaciones push en tu sitio web en 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 y dispositivo crea una suscripción separada. El modo incógnito y la navegación privada no pueden crear suscripciones. Las suscripciones web push permanecen anónimas hasta que les asignas un External ID.
OneSignal dashboard Users page showing a list of Users with Subscription details

Dashboard OneSignal: Audience > Users

Usuarios

Gestiona usuarios, asigna External IDs y rastrea su actividad.

Suscripciones

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.

​
Diseñar notificaciones web push

Las notificaciones web push soportan títulos, mensajes, iconos, imágenes y botones de acción. El diagrama muestra qué elementos puedes personalizar (1–5) y cuáles controla el navegador (6–9).
Annotated diagram showing the anatomy of a web push notification with customizable and browser-controlled elements

Anatomía de una notificación web push. Personaliza los elementos 1–5. El navegador controla los 6–9.

Elementos personalizables:
  1. Título: Encabezado que llama la atención (recomendado: menos de 50 caracteres)
  2. Mensaje: Contenido principal de la notificación (recomendado: menos de 120 caracteres)
  3. Icono: Icono de marca cuadrado (recomendado: PNG, JPG o GIF no animado de 256×256)
  4. Imagen grande: Contenido visual llamativo
  5. Botones de acción: Botones de llamado a la acción
Elementos controlados por el navegador (no personalizables):
  1. Navegador: El navegador que muestra el push
  2. Dominio: El origen de tu sitio, establecido por el navegador
  3. Marca de tiempo y descartar: Controles agregados por el navegador
  4. 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

Personaliza los 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 mensajes en el idioma preferido de cada usuario.

​
Configurar comportamiento web push

Controla cuándo aparecen los mensajes, cuánto tiempo se almacenan y qué sucede al hacer clic.

​
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

Elige la URL de destino y cómo un clic enfoca o navega una pestaña abierta.

​
Prueba tu configuración

Confirma la integración en varios navegadores antes de enviar a toda tu audiencia.

​
Lista de verificación pre-lanzamiento

  • El SDK está cargado sin errores en la consola
  • El prompt de permiso aparece y funciona correctamente
  • 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 y solución de problemas

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 propiedades personalizadas a los usuarios para personalización y segmentación.

​
Preguntas frecuentes

​
¿Pueden los usuarios suscribirse a web push en iOS?

Sí, a partir de iOS 16.4+. Termina primero Sitio típico, Código personalizado, WordPress o Shopify, luego agrega un manifest.json y haz que los usuarios agreguen tu sitio a su pantalla de inicio. Ver Configuración iOS web push.

​
¿Por qué un usuario dejó de recibir notificaciones web push?

Las razones más comunes son:
  1. El usuario limpió sus datos del navegador. Será resuscrito automática y silenciosamente cuando regrese a tu sitio si habilitaste la opción Auto Resubscribe en tu configuración de Web Push.
  2. El usuario desactivó las notificaciones push en la configuración del sistema operativo. Deberá volver a suscribirse manualmente a tu sitio para recibir notificaciones push nuevamente.
Para más detalles sobre estas y otras razones, ver Notificaciones web push no mostradas.

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

​
¿Cómo registro más de un dominio para web push?

Necesitas una aplicación de OneSignal separada para cada dominio o subdominio. Una sola aplicación de OneSignal solo puede servir a un origen. Redirige a los usuarios a un único origen para la suscripción o crea una aplicación de OneSignal por origen. Ver Múltiples sitios y subdominios.

​
¿Por qué no aparece mi prompt de web push?

Las causas comunes incluyen un sitio servido sobre HTTP, un service worker que no está registrado, que el usuario ya otorgó o denegó permiso, o el modo incógnito. Revisa la consola del navegador y ver Prompts de permiso web y Problemas de visualización de prompts.