Cómo solucionar errores de instalación del service worker

Queremos que la instalación de PushEngage en WordPress sea fluida, pero aun así puedes encontrar problemas. El service worker es el archivo clave para recopilar suscriptores de notificaciones push y enviar campañas de notificaciones push.

Hemos recopilado una guía con varios problemas comunes relacionados con el archivo Service Worker durante la instalación de PushEngage y cómo puedes solucionar estos problemas.

Antes de empezar

• Debes evitar las redirecciones; el archivo service-worker.js debe ser accesible públicamente (https://www.miweb.com/service-worker.js). Si hay alguna redirección al intentar visitar el archivo service-worker.js, tu instalación es incorrecta y la suscripción también fallará.
• Si ves un error 403 o 404 después de intentar suscribirte a tu sitio, algo impide que los archivos del Service Worker de PushEngage sean de libre acceso. Puedes comprobarlo visitando tu Panel de Control de PushEngage o la Consola de tu Navegador. Estos archivos deben estar escritos en mayúsculas, no como redirecciones. Estas páginas deberían ser accesibles para ti sin ningún problema.
• Es necesario fusionar service workers si estás integrando PushEngage en un sitio web que ya tiene un service worker (como una PWA) para que PushEngage funcione correctamente. Esta guía te ayuda a fusionar el service worker de PushEngage con el service worker existente en tu sitio web.

Problemas con el Service worker y sus soluciones

Error 1: URL incorrecta del archivo Service Worker

TypeError: No se pudo registrar un ServiceWorker para el ámbito (https://xxxx) con el script (https://www). Se recibió un código de respuesta HTTP incorrecto (404) al obtener el script.

Solución: Verifica que el nombre y la ubicación del archivo Service Worker coincidan con el valor de tu panel de PushEngage navegando a Configuración del sitio » Configuración avanzada » Configuración del Service Worker

Error 2: El navegador no tiene permiso para leer el archivo Service Worker

TypeError: No se pudo registrar un ServiceWorker para el ámbito ('https://xxx') con el script ('https://xxxx'): Se recibió un código de respuesta HTTP incorrecto (403) al obtener el script.

Solución: Comprueba la configuración del servidor web con el proveedor del servicio de alojamiento web para asegurarte de que la configuración permite el acceso de lectura al archivo Service Worker y que el archivo es accesible públicamente desde Internet.

El equipo de PushEngage no puede ayudarte a cambiar los permisos; solo tu empresa de alojamiento o tu equipo de desarrollo pueden ayudarte a solucionar estos permisos.

Error 3: No se pudo ejecutar ‘importScripts’

Uncaught DOMException: No se pudo ejecutar 'importScripts' en 'WorkerGlobalScope'. El script en (https://xxxxxx) no se pudo cargar en (https://www).

Solución:  El archivo Service Worker utiliza un nombre de subdominio incorrecto en la declaración importScripts (https://xxxx.pushengage.com) dentro del archivo Service Worker. Por lo tanto, asegúrese de que la declaración importScript utilice el subdominio correcto de PushEngage asignado al sitio.

El valor del parámetro de consulta de dominio en la URL del Service Worker es incorrecto. Esto se aplica solo a los sitios que utilizan el plugin de WordPress.

Error 4: No se pudo registrar un Service Worker

DOMException: No se pudo registrar un Service Worker para el ámbito (https://www) con el script (https://xxxxxxxx). La ruta del ámbito proporcionado ('xxx') no está bajo el ámbito máximo permitido ('xxxxxxx'). Ajuste el ámbito, mueva el script del Service Worker o utilice la cabecera HTTP Service-Worker-Allowed para permitir el ámbito.

Solución:  Mueva el archivo del service worker al directorio raíz y actualice la ruta del service worker a través de esta guía.
Después de hacerlo, establezca el valor de la cabecera HTTP Service-Worker-Allowed en ‘/’ para las solicitudes al archivo del service worker.

Si encuentras algún problema, por favor contáctanos haciendo clic aquí. Nuestro equipo de soporte podrá ayudarte.