Requisitos de web push
Tu sitio web debe cumplir con todo lo siguiente para que Web Push funcione: APIs de navegador requeridas Seguridad y conexión- ✅ Solo HTTPS (con certificado SSL válido)
- ✅ Service worker de OneSignal instalado
- ✅ El navegador debe alcanzar:
- Servidores push del navegador (ej., FCM, Mozilla)
api.onesignal.com
- ✅ Permiso de notificaciones otorgado por el usuario
- ❌ No en modo Incógnito/Privado/Invitado
- ❌ Datos del sitio no borrados (elimina suscripciones)
Requisitos iOS/iPadOS
Para recibir push en iOS o iPadOS:- iOS 16.4+ o iPadOS 16.4+
- El sitio debe agregarse a la pantalla de inicio y abrirse desde allí
- Archivo
manifest.jsonválido con campos requeridos - Los usuarios deben aceptar permisos de notificaciones después de abrir como aplicación web
Configuración iOS web push
Sigue los pasos específicos de Apple para habilitar web push en iPhones e iPads ejecutando iOS 16.4+.
Soporte de navegadores y plataformas
Compatibilidad de navegadores por sistema operativo
| Navegador | Windows PC | macOS | Android | iOS (iPhone, iPad) |
|---|---|---|---|---|
| Chrome 50+ | Sí | Sí | Sí | Sí ¹ |
| Firefox 47+ | Sí | Sí | Sí | Sí ¹ |
| Safari 10+ | No | Sí | No | Sí ¹ |
| Microsoft Edge 18+ ² | Sí | Sí | Sí | Sí ¹ |
| Opera ² | Sí | Sí | Sí | Sí ¹ |
| Samsung Internet ² | No | No | Sí | Sí ¹ |
| Yandex ² | Sí | Sí | Sí | Sí ¹ |
| UC Browser ² | Sí | No | Sí | Sí ¹ |
| Internet Explorer ³ | No | No | No | No |
| DuckDuckGo | No | No | No | No |
- ¹ iOS requiere instalación de aplicación web (ver requisitos de configuración iOS web push arriba)
- ² Los navegadores basados en Chromium aparecen como “Chrome” en analytics de OneSignal
- ³ Internet Explorer está obsoleto y ya no recibe actualizaciones
Cambios de dominio y migración
Entender la política de origen del navegador
Los navegadores vinculan las suscripciones de web push a un origen (dominio/URL del sitio) específico por razones de seguridad. No puedes transferir suscriptores entre diferentes orígenes - esta es una limitación del navegador, no una restricción de OneSignal. Diferentes orígenes incluyen:- HTTP vs HTTPS (ej.,
http://mysite.com→https://mysite.com) - www vs sin www (ej.,
www.mysite.comvsmysite.com) - Diferentes dominios/subdominios (ej.,
domain1.comvsdomain2.comosub1.domain.comvssub2.domain.com)
Opciones de migración
Al cambiar el origen de tu sitio, elige uno de estos enfoques:- Nueva App OneSignal (Recomendado)
- Actualizar App y eliminar suscriptores antiguos
Mejor para: La mayoría de cambios de dominio, especialmente cuando quieres una migración limpia
- Crea una nueva App OneSignal para tu nuevo dominio
- Estrategia de envío dual: Continúa enviando desde la app antigua, pero establece “Launch URL” a tu nuevo dominio
- Transición gradual:
- Enviadores de alta frecuencia (1+ notificaciones/día): transición de 2 semanas
- Enviadores de frecuencia media (2+ notificaciones/semana): transición de 2 meses
- Notificaciones de migración: Envía 1-2 mensajes como “¡Nos mudamos! Visita nuestro nuevo sitio para mantenerte actualizado” al inicio y final de la transición
Actualización de HTTP a HTTPS
Actualizar de HTTP a HTTPS crea un nuevo origen. Sigue los pasos de migración de dominio arriba ya que los navegadores tratan los sitios HTTPS como completamente separados de sus versiones HTTP.Múltiples sitios y subdominios
Limitaciones de una sola app
Debido a la política de mismo origen del navegador, no puedes usar una App OneSignal para múltiples orígenes como:https://mysite.comyhttps://www.mysite.comhttps://main.comyhttps://shop.main.com
Soluciones para múltiples orígenes
- Estrategia de origen único
- Apps separadas
- Suscribe usuarios solo en tu dominio principal
- Redirige usuarios de otros orígenes al dominio principal para suscripción
- Redirige de vuelta a la página original después de la suscripción
Escenarios de soporte de idiomas
- Mismo origen (Recomendado)
- Orígenes diferentes
- URLs como
https://mysite.com/en/ohttps://mysite.com/es/ - Usa una sola App OneSignal
- Sigue la guía de prompts multi-idioma
- Implementa Idioma y localización
Configuración avanzada
Múltiples apps OneSignal en el mismo sitio
- No recomendado - causa conflictos de suscripción.
- Qué sucede: OneSignal resuscribe automáticamente a los usuarios al App ID visitado más recientemente, causando que los suscriptores reboten entre apps y creando muchos dispositivos desuscritos.
- Mejor enfoque: Usa Data Tags para segmentar usuarios dentro de una sola app.
Sitios en subcarpetas
Web push opera a nivel de origen. Para sitios en subcarpetas (ej.,https://example.com/blog), usa el origen principal (https://example.com) para la configuración.
Autoalojamiento de archivos SDK
Fuertemente desaconsejado. Las especificaciones de push del navegador cambian frecuentemente, y OneSignal actualiza archivos inmediatamente para mantener compatibilidad. Usa las URLs CDN de OneSignal desde tu configuración Web Push en su lugar.Código init personalizado
El códigoinit personalizado solo funciona con Configuración con código personalizado.
Usuarios de Configuración típica o Constructor de sitios web: El código init personalizado será ignorado por el SDK de OneSignal. Si necesitas retrasar la inicialización, usa los métodos de privacidad.
Desarrollo y pruebas
Pruebas de entorno local
Ver Configuración SDK Web > Pruebas locales para configuración completa de pruebas locales.Integración de service worker
OneSignal puede trabajar junto con service workers existentes y PWAs. Ver Integración de múltiples Service Workers para detalles de implementación.Spam push
Las notificaciones push no están diseñadas para usarse para anuncios, spam de usuarios o campañas engañosas. Si tu app es detectada enviando notificaciones spam, los navegadores pueden enviar a tus usuarios una notificación de “Advertencia de spam”. Evita enviar notificaciones que:- No sean relevantes para los usuarios
- Usen palabras como “Anuncios” o enlacen a una página que no está relacionada con la app
- No sean de una fuente confiable (ej. una marca con la que no estás asociado)
- Revisar tu contenido de notificaciones y eliminar cualquier cosa que pueda considerarse spam. Esto incluye:
- Las palabras “Anuncios” o “Anuncio” en el título o cuerpo
- Enlaces a páginas que no están relacionadas con la app
- Enlaces a páginas que no son de una fuente confiable (ej. una marca con la que no estás asociado)
- Continuar enviando y monitorear reportes adicionales.
Solución de problemas
Tiempo de despliegue de actualizaciones
- Archivos Service Worker: caché de 24 horas
- SDK Web: caché de 3 días
Problemas de notificaciones Chrome en macOS
Para usuarios de Chrome en macOS, asegúrate de que las notificaciones estén habilitadas para ambos:- App Google Chrome (Menú Apple > Configuración > Notificaciones)
- App Google Chrome Helper
Siguientes pasos después de la configuración
- Prueba exhaustivamente en tus navegadores y dispositivos soportados
- Implementa manejo de errores adecuado para solicitudes de permiso
- Configura analytics para monitorear tasas de suscripción
- Planifica tu estrategia de notificaciones para evitar fatiga del usuario
- Considera pruebas A/B del tiempo y mensajería de tu solicitud de permiso
Errores comunes de migración
- Limpiar datos del navegador desuscribe usuarios automáticamente
- Notificaciones duplicadas durante transiciones de app dual
- iOS requiere instalación de aplicación web antes de que push funcione
- Modos Privado/Incógnito nunca soportan notificaciones push
- Los service workers deben ser accesibles en la raíz de tu sitio o subdirectorio configurado