Saltar al contenido principal

​
Problemas comunes de configuración

​
Verificar la configuración de tu dashboard de OneSignal

Asegúrate de haber completado cada paso en la guía de configuración de WordPress:
  • Selecciona la opción WordPress Plugin al crear tu aplicación OneSignal
  • Tu URL del Sitio debe coincidir exactamente con la URL del navegador
    • Por ejemplo, https://example.com no es lo mismo que https://www.example.com. Usa una versión consistentemente.
    • Solo se soporta un origen de sitio para push. Consulta Política del mismo origen.
  • Asegúrate de haber agregado al menos una solicitud de permiso.

​
No agregar el código de OneSignal manualmente

El plugin de WordPress de OneSignal incluye automáticamente el script de inicialización y el Service Worker. ✅ Esto significa:
  • No debes agregar manualmente código JavaScript de OneSignal en tu tema, pie de página u otros plugins.
❌ Si quieres usar Configuración de Código Personalizado, desinstala primero el plugin de WordPress para evitar conflictos.

​
Cómo solucionar problemas de tu sitio

1

Verificar que el plugin esté activo y abrir herramientas de desarrollador

Carga tu sitio en una ventana de navegador normal (no incógnito) con el plugin habilitado.

Haz clic derecho en tu sitio, haz clic en Inspeccionar y abre la pestaña Console.

2

Verificar errores de OneSignal en la consola

Abre la pestaña Console, refresca la página y busca errores rojos o amarillos relacionados con OneSignal. Consulta Errores comunes de consola de OneSignal para ayuda.
3

Verificar estado de suscripción en el navegador

Pega esto en la consola:
OneSignal.User.PushSubscription.id
Si estás suscrito, devuelve una cadena (tu ID de Suscripción).

Encuentra tu ID de Suscripción de OneSignal en la consola.

4

Verificar ID de Suscripción en el dashboard de OneSignal

Ve a OneSignal.com > Audience > Subscriptions y busca el ID devuelto arriba.

Busca en tu dashboard de OneSignal el ID de Suscripción.

5

Enviar una notificación push de prueba

Si la suscripción existe y el estado es Subscribed, sigue la guía de Push para enviar una notificación. Si no aparece nada, consulta Notifications not shown para correcciones específicas del navegador.

​
Errores comunes de consola de OneSignal

​
SdkInitError: OneSignal: This web push config can only be used on … Your current origin is …

Error de discordancia de URL del sitio.

Tu URL del sitio en el dashboard de OneSignal no coincide con tu dominio real. Asegúrate de que coincida exactamente con el dominio que ves en el navegador.

​
PushPermissionNotGrantedError: The user dismissed the permission prompt.

El visitante rechazó la solicitud del navegador. No aparecerá nuevamente hasta que expire un período de espera. Consulta Solicitudes de permiso web para reglas del navegador o limpia los datos del sitio para reintentar inmediatamente.

​
The OneSignal web SDK can only be initialized once.

Error de inicialización duplicada de OneSignal.

Estás cargando OneSignal dos veces. Elimina el código de OneSignal agregado manualmente si estás usando el plugin.

​
Installing service worker failed.. 403 or 404 error

Archivo Service Worker faltante (403/404).

Asegúrate de que este archivo sea accesible: https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js Si no, consulta Soporte común de plugin para corregir problemas de CDN o caché.

​
Soporte común de plugin

Los CDN y plugins de caché pueden bloquear los archivos requeridos de OneSignal. Usa estas configuraciones específicas por plugin:

​
Autoptimize

En Excluded scripts, agrega: 
wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/(.*)

​
WP Rocket

Bajo CDN > Exclude Files From CDN, agrega: 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)

​
LiteSpeed Cache

Bajo CDN > Exclude Path, agrega: 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)
Luego presiona guardar.

​
WP Super Cache

  1. Ve a Settings > WP Super Cache > CDN
  2. En Exclude if substring, incluye: onesignal-free-web-push-notifications
  3. Haz clic en Contents > Delete Cache

​
WP Engine

En WP Engine plugin > General Settings > HTML Post-Processing, agrega estos, reemplazando YOURSITEHERE:
text
#https?://(www\.)?(YOURSITEHERE\.com|mywpenginehandleHere.wpengine.com|wpengineCDNpathHere.wpengine.netdna-(ssl|cdn).com)/wp-(content|includes)#
=> https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-$4
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-content/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/

​
W3 Total Cache

  1. Ve a Performance > CDN
  2. Bajo Rejected files, agrega:
{plugins_dir}/onesignal-free-web-push-notifications/sdk_files/*

Configuración de exclusión de W3 Total Cache.

​
BunnyCDN

Excluye onesignal en las Rutas Excluidas de CDN del plugin.

Ejemplo de exclusión de BunnyCDN.

​
CDN Enabler

En Settings > CDN Enabler, agrega esto a “Exclusions”: 
onesignal-free-web-push-notifications

​
PressCDN

En Exclude Directories, agrega: 
/wp-content/plugins/onesignal-free-web-push-notifications/

​
Breeze

En Settings > CDN > Exclude Content, agrega: 
/onesignal-free-web-push-notifications/sdk_files/

Ejemplo de exclusión de Breeze.

​
Hummingbird Pro

Ve a Asset Optimization, encuentra el archivo SDK de OneSignal y elimínalo de la optimización.

Optimización de Assets de Hummingbird Pro.

​
Sucuri

Sigue la guía de Whitelist de Sucuri para permitir archivos de OneSignal.

​
iThemes Security plugin

Deshabilita la opción “Disable PHP in Plugins” bajo System Tweaks.

Configuración de plugin PHP de iThemes.

​
Defender Security plugin

No habilites “Prevent PHP execution”. Ve a Defender Plugin > Security Tweaks y verifica que la configuración esté deshabilitada.

​
Ejemplo de .htaccess para acceso al Service Worker

html
<Files *.php>
Order allow,deny
Deny from all
</Files>
<Files OneSignalSDKWorker.js.php>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>
<Files OneSignalSDKWorker.js>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>

​
Ralentizaciones del servidor o sitio inalcanzable después de enviar notificaciones

Si tu servidor experimenta ralentizaciones o se vuelve inalcanzable después de enviar notificaciones, a menudo se debe al aumento de carga de activos de notificación o recursos limitados del servidor.

​
No alojar tus propios íconos de notificación

Evita el auto-alojamiento de imágenes usadas en notificaciones. Cuando alojas tus propios íconos o imágenes de notificación, tu servidor puede sobrecargarse ya que el navegador de cada destinatario intenta obtener la imagen al mismo tiempo que se envía una notificación. Para reducir la tensión del servidor, usa soluciones de alojamiento de imágenes o servicios CDN optimizados para acceso de alta concurrencia.

​
Considera actualizar recursos de alojamiento

Si los problemas del servidor persisten, puede que necesites:
  • Actualizar tu plan de alojamiento: Puede ser necesario un mayor ancho de banda o un alojamiento más potente para manejar envíos de notificaciones a gran escala.
  • Consultar con tu proveedor de alojamiento: Tu proveedor puede ofrecer perspectivas u optimizaciones específicas para tu entorno de alojamiento.