Skip to main content
La sección Avanzada cubre configuraciones especializadas y comportamientos de notificaciones para clientes con requisitos específicos o implementaciones personalizadas.

Webhooks Web Push

OneSignal proporciona Webhooks Web Push dedicados para manejar eventos de notificaciones. Ver Webhooks Web Push para detalles completos de implementación. Importante: Los Webhooks Web Push son una implementación separada de los Webhooks de eventos y no pueden usarse de manera intercambiable.

Configuración de Service Worker

OneSignal verifica automáticamente el alcance raíz para service workers por defecto. Sin embargo, recomendamos encarecidamente personalizar tu integración para usar un alcance no raíz para mejor seguridad y evitar conflictos con service workers existentes. Sigue nuestra guía Configuración Service Worker de OneSignal para implementar una configuración de alcance personalizado. ¿Por qué usar un alcance no raíz?
  • Previene conflictos con service workers existentes
  • Mejora la seguridad limitando el alcance de OneSignal
  • Proporciona mejor control sobre la arquitectura de service worker de tu sitio

Desarrollo y pruebas locales

Para propósitos de desarrollo y pruebas, consulta nuestra guía completa de Pruebas locales que cubre:
  • Configuración de entornos localhost
  • Prueba de notificaciones sin certificados SSL
  • Depuración de problemas comunes de desarrollo

Comportamiento de clic de notificaciones

OneSignal soporta múltiples comportamientos de navegador cuando los usuarios hacen clic en notificaciones. Para manejo avanzado de URL y opciones como desactivar acciones de clic completamente, consulta Deep-links y URLs.

Comportamiento predeterminado

Cuando los usuarios hacen clic en una notificación y no tienen tu sitio abierto, el navegador abre una nueva pestaña y navega a la URL de la notificación.

Cuando el sitio ya está abierto

Cuando los usuarios tienen tu sitio abierto en una o más pestañas del navegador, puedes configurar cómo responde el navegador: Navegación exacta (Predeterminado)
  • Coincide la URL exacta de la notificación (ej. example.com/product) con una pestaña abierta
  • Navega a la URL de la notificación en esa pestaña coincidente
  • Mejor para targeting de página específica
Navegación de origen
  • Coincide el origen de la notificación (ej. example.com) con cualquier pestaña abierta de tu sitio
  • Navega a la URL de la notificación en la pestaña coincidente
  • Útil para navegación general del sitio
Enfoque exacto
  • Coincide la URL exacta de la notificación con una pestaña abierta
  • Enfoca en esa pestaña sin refrescar la página
  • Ideal cuando no quieres interrumpir el estado actual de la página del usuario
Enfoque de origen
  • Coincide el origen de la notificación con cualquier pestaña abierta de tu sitio
  • Enfoca en esa pestaña sin refrescar la página
  • Mejor para llamar la atención a tu sitio sin navegación

Persistencia de notificaciones

Por defecto, las notificaciones se muestran durante aproximadamente 5 segundos antes de moverse al Historial de notificaciones, donde permanecen durante 1 semana antes de su eliminación automática por el sistema operativo.

Habilitar notificaciones persistentes

Puedes hacer que las notificaciones persistan en pantalla hasta la interacción del usuario para suscriptores de navegadores Chrome y Edge.
No todos los navegadores y sistemas operativos soportan notificaciones persistentes. Cuando se habilita, solo afecta a usuarios elegibles y puede impactar la apariencia de notificaciones reduciendo el conteo de caracteres y afectando la visualización de imágenes/botones.
Consideraciones importantes:
  • Los suscriptores actuales deben volver a visitar tu sitio después de habilitar esta configuración para ver los cambios
  • Las notificaciones persistentes pueden molestar a los usuarios si se usan en exceso
  • Se recomienda solo para notificaciones de alta importancia (ej., aplicaciones de gestión de tareas)
  • Los usuarios pueden pasar el cursor sobre las notificaciones para mantenerlas visibles para lectura

Métodos de implementación

1

Configuración del dashboard

Usa el toggle “Persistence” en tu dashboard de OneSignal para habilitar/deshabilitar esta característica.

Toggle de persistencia de notificaciones

2

Implementación con código personalizado

Agrega la propiedad persistNotification a la inicialización de tu SDK Web Push:
persistNotification: true,
Incluye esto en tu código de inicialización de OneSignal para habilitar la persistencia para navegadores y sistemas operativos soportados.

Compatibilidad de navegadores

Navegadores soportados:
  • Chrome (soporte completo)
  • Edge (soporte completo)
Navegadores no soportados:
  • Firefox (la configuración no tiene efecto)
  • Safari (la configuración no tiene efecto)

Mejores prácticas

  • Usar con moderación: Solo habilita para notificaciones verdaderamente importantes para evitar frustración del usuario
  • Probar exhaustivamente: Verifica el comportamiento en diferentes navegadores y dispositivos
  • Monitorear retroalimentación del usuario: Observa tasas aumentadas de opt-out que pueden indicar fatiga de notificaciones
  • Considerar el contexto: Las notificaciones persistentes funcionan mejor para contenido sensible al tiempo o accionable
Siguientes pasos:
  • Revisa tu estrategia de notificaciones para determinar si la persistencia es apropiada
  • Prueba la característica con un segmento pequeño de usuarios antes del despliegue completo
  • Monitorea métricas de engagement después de la implementación
  • Considera implementar diferentes configuraciones de persistencia para diferentes tipos de notificaciones