> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Solución de problemas del Web SDK
> Soluciona problemas de OneSignal Web Push en Chrome, Firefox, Safari y Android. Corrige errores comunes de service worker, origen, tipo MIME y push móvil con orientación de depuración paso a paso.
## Descripción general
Esta guía te guía a través de la solución de problemas de tu configuración del Web SDK de OneSignal. Antes de continuar, revisa la [Configuración del Web SDK](./web-sdk-setup) para asegurarte de haber completado todos los pasos.
Las razones más comunes por las que el web push parece no funcionar están realmente relacionadas con la configuración de notificaciones de tu navegador y dispositivo:
### Compatibilidad del navegador
Los usuarios pueden ver [solicitudes de permiso web](/docs/es/permission-requests) pero no pueden suscribirse a notificaciones push en los modos de navegación de incógnito, privado o invitado.
| Browser | Windows | macOS | Android | iOS |
| -------------------------------------------------------------------------------- | ------- | ----- | ------- | --- |
| [Chrome](https://en.wikipedia.org/wiki/Google_Chrome) | ✅ | ✅ | ✅ | ✅ ¹ |
| [Firefox](https://en.wikipedia.org/wiki/Firefox) | ✅ | ✅ | ✅ | ✅ ¹ |
| [Safari 10+](https://en.wikipedia.org/wiki/Safari_\(web_browser\)) | ❌ | ✅ | ❌ | ✅ ¹ |
| [Microsoft Edge](https://en.wikipedia.org/wiki/Microsoft_Edge) | ✅ | ✅ | ✅ | ✅ ¹ |
| [Opera](https://en.wikipedia.org/wiki/Opera_\(web_browser\)) ² | ✅ | ✅ | ✅ | ✅ ¹ |
| [Samsung Internet](https://en.wikipedia.org/wiki/Samsung_Internet_for_Android) ² | ❌ | ❌ | ✅ | ✅ ¹ |
| [Yandex](https://en.wikipedia.org/wiki/Yandex_Browser) ² | ✅ | ✅ | ✅ | ✅ ¹ |
| [UC Browser](https://en.wikipedia.org/wiki/UC_Browser) ² | ✅ | ❌ | ✅ | ✅ ¹ |
| [Internet Explorer](https://en.wikipedia.org/wiki/Internet_Explorer) | ❌ | ❌ | ❌ | ❌ |
| [DuckDuckGo](https://en.wikipedia.org/wiki/DuckDuckGo) | ❌ | ❌ | ❌ | ❌ |
¹ iOS requiere la instalación de una aplicación web (consulte [Configuración de push web en iOS](/docs/es/web-push-for-ios))
² Los navegadores basados en Chromium aparecen como "Chrome" en los análisis de OneSignal
### Configuración de notificaciones del dispositivo
La configuración de notificaciones del dispositivo es la **causa más común** por la que las notificaciones web push no aparecen. Revise los siguientes ajustes, incluidos los modos de concentración (No molestar, Batería baja, etc.), antes de buscar otras causas.
Seleccione el sistema operativo correcto en las pestañas de abajo. Debería ver Windows, macOS, Android e iOS.
1. Seleccione **Inicio > Configuración > Notificaciones y acciones > Obtener notificaciones de aplicaciones y otros remitentes**
2. **Asegúrese de que su sitio y navegador también estén habilitados.**
**Configuración de notificaciones en Windows 11:**
1. Seleccione **Inicio > Configuración > Sistema > Notificaciones**
2. Active **Notificaciones**
3. Desactive **No molestar** (durante las pruebas, las notificaciones push se mostrarán cuando esto esté desactivado)
4. Desplácese hacia abajo hasta **Notificaciones de aplicaciones y otros remitentes**
5. Asegúrese de que sus navegadores estén **Activados**.
1. Navegue a **Configuración del sistema > Notificaciones**
2. Asegúrese de que las **Notificaciones** estén habilitadas en el Centro de notificaciones.
Es posible que deba seleccionar **Permitir notificaciones al duplicar o compartir la pantalla**.
3. Desplácese hacia abajo hasta la lista de notificaciones de aplicaciones y asegúrese de que su navegador esté activado.
Algunos navegadores como Chrome y Edge muestran 2 entradas de aplicación diferentes.
1. Notificaciones push web estándar
2. Alertas internas, p. ej. Google Calendar
Asegúrese de que ambas estén habilitadas.
4. Seleccione la aplicación y active la configuración. Seleccione cómo desea que se muestren las notificaciones.
Algunas versiones antiguas de Safari pueden mostrar el sitio web en su lista de notificaciones de aplicaciones. Asegúrese de comprobar que el sitio web esté activado en este caso.
5. Navegue a **Configuración del sistema > Concentración** y asegúrese de que no haya modos de concentración activos durante las pruebas.
1. Navegue a **Configuración > Notificaciones > su navegador de elección**.
2. Asegúrese de que **"Mostrar notificaciones"** y su sitio web estén marcados.
Android utiliza canales de notificación por aplicación. Si el canal de notificaciones de su navegador está configurado como silencioso o desactivado, las notificaciones push no aparecerán aunque el interruptor principal esté activado. En Configuración, toque la entrada del navegador y compruebe que cada canal de notificaciones esté habilitado y configurado con un estilo de alerta visible.
iOS requiere que agregue su sitio a la Pantalla de inicio antes de que los suscriptores puedan recibir notificaciones push en iPhones y iPads. Complete la [configuración de push web para iOS](/docs/es/web-push-for-ios) antes de solucionar problemas.
1. Toque el botón **Compartir** del navegador y seleccione **Agregar a la pantalla de inicio**.
2. Abra su sitio desde la Pantalla de inicio y permita las notificaciones cuando aparezca el aviso de permiso.
3. Vaya a **Configuración > Notificaciones > su sitio** en el dispositivo y asegúrese de que **Permitir notificaciones** esté activado.
### Problemas de visualización del mensaje
Las siguientes son razones comunes por las que la solicitud de notificación push web puede no mostrarse como se esperaba.
Revise su configuración de [Solicitud de permiso web](/docs/es/permission-requests) para asegurarse de haber configurado una solicitud y comprender los diferentes comportamientos del navegador.
Por ejemplo, algunos navegadores como Safari requieren una acción del usuario (hacer clic en un botón) antes de que pueda aparecer la solicitud nativa. Los detalles de cada navegador se pueden encontrar en nuestra sección [Solicitud de permiso web > Solicitud de permiso nativa](/docs/es/permission-requests#native-permission-prompt).
Los navegadores no permiten que los usuarios se suscriban a notificaciones en estos modos. Es por eso que la solicitud deslizante puede mostrarse pero la solicitud de permiso nativa no se mostrará.
Asegúrese de estar [utilizando un navegador y dispositivo que admita push web](/docs/es/troubleshooting-web-push#browser-compatibility).
Navegue a la configuración de su navegador y verifique la configuración de permisos de "Notificaciones". Ejemplo de Chrome: `chrome://settings/content/notifications`
En este ejemplo:
* El usuario ha seleccionado "No permitir que los sitios envíen notificaciones", lo que impedirá que se muestre la solicitud de permiso nativa. Esto debe mostrar "Los sitios pueden solicitar enviar notificaciones" para permitir que se muestre la solicitud de permiso nativa.
* El usuario ha agregado `https://yoursite.com` a la lista "No se permite enviar notificaciones", lo que impedirá que se muestre la solicitud de permiso nativa. Esto debe eliminarse de la lista para permitir que se muestre la solicitud de permiso nativa.
**Documentación específica del navegador:**
* [Chrome](https://support.google.com/chrome/answer/3220216) - Esta página explica cómo administrar las notificaciones en Chrome yendo a Configuración > Privacidad y seguridad > Configuración del sitio > Notificaciones, donde puede controlar el comportamiento predeterminado y administrar los permisos de sitios web individuales.
* [Firefox](https://support.mozilla.org/en-US/kb/push-notifications-firefox) - Esta guía cubre las notificaciones push web de Firefox, explicando cómo administrar los permisos de notificación a través de Configuración > Privacidad y seguridad > Notificaciones, y cómo controlar los permisos de sitios específicos a través del icono de información del sitio en la barra de direcciones.
* [Safari](https://support.apple.com/guide/safari/customize-website-notifications-sfri40734/mac) - Esta guía de Apple explica cómo personalizar las notificaciones de Safari en Mac a través de Safari > Preferencias > Sitios web > Notificaciones, donde puede administrar qué sitios pueden enviar notificaciones y controlar el comportamiento de las notificaciones a través de Preferencias del Sistema.
* [Edge](https://support.microsoft.com/en-us/microsoft-edge/manage-website-notifications-in-microsoft-edge-0c555609-5bf2-479d-a59d-fb30a0b80b2b) - Este artículo detalla cómo administrar las notificaciones de Edge navegando a Configuración > Privacidad, búsqueda y servicios > Permisos del sitio > Notificaciones, o haciendo clic en el icono de información del sitio en la barra de direcciones.
Para iOS, existen algunos requisitos adicionales para solicitar a los usuarios su suscripción. Se puede ver más información en la guía [Push web móvil para iOS/iPadOS](/docs/es/web-push-for-ios).
***
## Pasos para solucionar problemas
Después de verificar lo anterior, sigue estos pasos para solucionar problemas de tu configuración del Web SDK de OneSignal.
Las herramientas de desarrollador del navegador se pueden usar para interactuar con nuestro Web SDK en tu página web y habilitar el registro para verificar errores.
* **Chrome**: Haz clic derecho en la página, haz clic en *Inspeccionar* y haz clic en la pestaña *Consola* de la ventana emergente que se abre.
* **Firefox**: Haz clic derecho en la página, haz clic en *Inspeccionar elemento* y haz clic en la pestaña *Consola* de la ventana emergente que se abre.
* **Safari**: Ve a **Safari → Preferencias → Avanzado** y asegúrate de que *Mostrar menú Desarrollar en la barra de menús* esté marcado. Luego, en tu página web, haz clic derecho, haz clic en *Inspeccionar elemento* y haz clic en la pestaña *Consola* de la ventana emergente que se abre.
* **Chrome en Android**: [Habilitar depuración USB](https://developer.chrome.com/docs/devtools/remote-debugging/), conecta tu dispositivo a tu computadora y accede a las herramientas de desarrollador con `chrome://inspect#devices` en tu navegador Chrome de escritorio.
* **Firefox en Android**: [Habilitar depuración USB](https://developer.mozilla.org/en-US/docs/Tools/about:debugging), conecta tu dispositivo a tu computadora y accede a las herramientas de desarrollador con `about:debugging` en tu navegador Firefox de escritorio.
1. [Habilitar el inspector web en iOS](https://developer.apple.com/library/archive/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/GettingStarted/GettingStarted.html).
2. Abre el navegador Safari en tu Mac y selecciona **Desarrollar > tu dispositivo > tu sitio**.
Ahora puedes ejecutar comandos en la Consola de herramientas de desarrollador. Ejecuta el siguiente código:
```javascript JavaScript theme={null}
OneSignal.Debug.setLogLevel('trace');
```
* Deberías ver `undefined` como resultado.
* Cierra la pestaña y abre una nueva en la misma página. Solo actualizar no activará todos los eventos de inicialización del SDK.
* Comenzarás a ver los registros del SDK de OneSignal en la Consola.
### Errores de configuración
Puedes encontrar los siguientes errores después de que OneSignal se inicialice:
Error: SDK already initialized
**Lo que esto significa:** El código `init` del Web SDK de OneSignal se está llamando más de una vez, a menudo causado por combinar la configuración del plugin de WordPress con código manual o agregar accidentalmente el código `init` de OneSignal varias veces.
**Cómo solucionarlo:** Elimina cualquier llamada `init` duplicada. Si usas el plugin de WordPress, elimina cualquier código manual de OneSignal de tus archivos de tema.
Error: Can only be used on: (URL establecida en el panel de OneSignal)
**Lo que esto significa:** El dominio que estás visitando actualmente no coincide con la URL del sitio configurada en tu panel de OneSignal.
**Cómo solucionarlo:** Copia la URL del sitio en tu navegador y pégala en la configuración de **Configuración > Push e In-app > Web > URL del sitio** de tu panel de OneSignal. Asegúrate de que sea el origen del sitio usando el siguiente formato:
* **Protocolo:** Debe ser `https://` (para pruebas locales, consulta [Configuración de Localhost](./web-sdk-setup#local-testing))
* **Dominio:** `example.com` vs `www.example.com`
* **Subdominio:** `app.example.com` vs `example.com`
Los tres componentes deben coincidir entre la URL real de tu sitio y la configuración de tu panel.
Error: OneSignalSDK: The "My site is not fully HTTPS" option is no longer supported starting with version 16 (User Model) of the OneSignal SDK.
**Lo que esto significa:** Tu panel de OneSignal está configurado para usar un sitio HTTP y probablemente actualizaste para usar HTTPS.
Tus usuarios que se suscribieron a tu sitio mientras usaban HTTP o la opción "Mi sitio no es completamente HTTPS" en realidad están suscritos a un subdominio que te proporcionamos en el formato `https://your-label.os.tc` y no al origen real de tu sitio. Esto se debe a que el web push no es compatible con sitios HTTP o sitios web que no pueden alojar service workers.
**Cómo solucionarlo:** Tienes 2 opciones, pero ambas requieren que tus usuarios se vuelvan a suscribir porque en realidad están suscritos al subdominio `os.tc`.
1. Crea una nueva aplicación de OneSignal y establece el nuevo ID de aplicación en tu código de inicialización de OneSignal. El beneficio de esto es que puedes continuar enviando push desde la aplicación antigua/original de OneSignal. Envía tantas notificaciones como quieras informando a tus usuarios que el sitio se ha actualizado y que deben volver y suscribirse nuevamente para seguir recibiendo actualizaciones. Ofrecer un descuento o incentivo para volver a suscribirse ayuda mucho. Establece la "URL de lanzamiento" en una página de destino y proporciónales un botón para suscribirse fácilmente nuevamente como nuestro mensaje de campana, mensaje de enlace personalizado o mensaje de diapositiva de categoría. Consulta [Mensajes de permiso](./permission-requests) para más detalles.
2. Si deseas mantener el mismo ID de aplicación, necesitarías usar nuestra API de [Actualizar una aplicación](/reference/update-an-app) para actualizar el `chrome_web_origin` y el `safari_site_origin` al origen HTTPS de tu sitio. Debido a que estos usuarios se suscribieron al subdominio `os.tc`, no tienen permisos de push permitidos en el navegador para tu sitio. El navegador no "sabe" que están suscritos a tu sitio, por lo que recibirán el mensaje nuevamente. Si se suscriben nuevamente, tendrán 2 suscripciones de web push a tu sitio en el mismo navegador y recibirán notificaciones duplicadas. Por esta razón, recomendamos [eliminar todos tus suscriptores actuales de web push](./delete-users) para evitar que reciban notificaciones duplicadas. Antes de eliminarlos, envía algunas notificaciones informándoles que el sitio se ha actualizado y que deben suscribirse nuevamente para seguir recibiendo actualizaciones. Ofrecer un descuento o incentivo para volver a suscribirse funciona muy bien. Establece la "URL de lanzamiento" en una página de destino y proporciónales un botón para suscribirse fácilmente nuevamente como nuestro mensaje de campana, mensaje de enlace personalizado o mensaje de diapositiva de categoría. Consulta [Mensajes de permiso](./permission-requests) para más detalles.
### Errores de instalación del service worker
Si se te presenta el [mensaje de permiso nativo](./permission-requests) y haces clic en "Permitir", puedes encontrar los siguientes errores de instalación del service worker:
Y: Falló el registro de un Service Worker.
\[Instalación del Service Worker] Falló la instalación del service worker TypeError: No se pudo registrar un ServiceWorker para el alcance ('`https://your-site.com/`') con el script ('`https://your-site.com/...`'): Se recibió un código de respuesta HTTP incorrecto (404) al obtener el script.
\[Instalación del Service Worker] Falló la instalación del service worker TypeError: No se pudo registrar un ServiceWorker para el alcance ('`https://www.yoursite.com/`') con el script ('`https://www.yoursite.com/...`'): Se recibió un código de respuesta HTTP incorrecto (403) al obtener el script.
El script tiene un tipo MIME no compatible ('tipo MIME actual').
\[Instalación del Service Worker] Falló la instalación del service worker SecurityError: No se pudo registrar un ServiceWorker para el alcance ('[https://your-site.com/](https://your-site.com/)') con el script ('[https://your-site.com/](https://your-site.com/)...'): El script tiene un tipo MIME no compatible ('tipo MIME actual').
\[Instalación del Service Worker] Falló la instalación del service worker SecurityError: No se pudo registrar un ServiceWorker para el alcance ('[https://your-site.com/](https://your-site.com/)') con el script ('[https://your-site.com/](https://your-site.com/)...'): El recurso del script está detrás de una redirección, lo cual no está permitido.
**Lo que esto significa:** Tu archivo de service worker está configurado incorrectamente.
**Cómo solucionarlo:**
Nuestro SDK busca el archivo de service worker `OneSignalSDKWorker.js` en el directorio raíz de tu sitio a menos que especifiques un nombre de archivo o ubicación personalizada como se describe en la [Guía de configuración del Service Worker](./onesignal-service-worker).
Asegúrate de haber configurado el nombre de archivo, ubicación y alcance correctos para que nuestro SDK encuentre el archivo del service worker.
Según tu configuración, abre el archivo directamente en tu navegador.
* Si no configuraste una ubicación personalizada, entonces deberías ver el código JavaScript del archivo del service worker en la raíz de tu sitio: `https://yoursite.com/OneSignalSDKWorker.js`
* Si usas WordPress, deberías verlo aquí: `https://yoursite.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js`
* Si usas una ubicación personalizada, deberías verlo aquí: `https://yoursite.com/your-custom-location/OneSignalSDKWorker.js`
Los nombres de archivo distinguen entre mayúsculas y minúsculas. Asegúrate de usar `OneSignalSDKWorker.js` o el nombre de archivo que configuraste.
Algunos servidores convertirán automáticamente el nombre del archivo a minúsculas. Ten esto en cuenta si no puedes encontrar el archivo.
* Deberías ver el siguiente código JavaScript:
```javascript JavaScript theme={null}
importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");
```
* Este archivo debe servirse con un `content-type` de `application/javascript`.
* No puede haber redirecciones a este archivo. Los archivos deben estar alojados en el mismo dominio que tu sitio (sin dominios CDN o proxy)
Revisa la [Guía de configuración del Service Worker](./onesignal-service-worker) para obtener instrucciones de configuración más detalladas.
### Notificaciones no mostradas
Esta sección asume:
1. Has revisado la guía [Notificaciones no mostradas: Web Push](./notifications-not-shown-web-push) para conocer las razones comunes por las que las notificaciones pueden no estar apareciendo en tu dispositivo.
2. Se te mostró el [mensaje de permiso nativo](./permission-requests) y hiciste clic en "Permitir". Consulta [Problemas de visualización del mensaje](#problemas-de-visualización-del-mensaje) arriba si no te suscribiste a través del mensaje de permiso nativo.
Si lo anterior es cierto, sigue estos pasos para verificar tu ID de suscripción y enviarte una notificación push:
Ejecuta el siguiente código en la consola de herramientas de desarrollador del navegador:
```javascript JavaScript theme={null}
function getUserInfo() {
console.log('getUserInfo()');
Promise.all([
OneSignal.Notifications.isPushSupported(),
OneSignal.Notifications.permission,
OneSignal.User.PushSubscription.optedIn,
OneSignal.User.PushSubscription.id
]).then(([
isPushSupported,
isSubscribed,
isOptedIn,
subscriptionId
]) => {
console.log('The current URL of this page: ', location.href);
console.log('Push is supported on this browser: ', isPushSupported);
console.log('You are subscribed to notifications in the browser: ', isSubscribed);
console.log('You are opted-in with OneSignal: ' , isOptedIn);
console.log('Your OneSignal Subscription ID: ', subscriptionId);
}).catch(e => {
console.error('Error getting user info:', e);
});
}
getUserInfo();
```
Esto te dirá:
* La URL de la página en la que estás si hay alguna confusión.
* Si el navegador actual que estás usando soporta notificaciones push.
* `true` significa que el navegador soporta notificaciones push.
* `false` significa que el navegador no soporta notificaciones push.
* Si estás suscrito a notificaciones en el navegador.
* `true` significa que permitiste permisos push para esta URL.
* `false` significa que no permitiste o denegaste permisos push para esta URL.
* Si estás optado con OneSignal.
* `true` significa que tu suscripción está suscrita a notificaciones push en OneSignal.
* `false` significa que tu suscripción no está suscrita a notificaciones push en OneSignal. Verifica si el [método `optOut()`](./web-sdk-reference) se está llamando en tu sitio.
* Tu ID de suscripción de OneSignal.
* Guarda esto para el siguiente paso. Este es el ID que usarás para enviarte una notificación push.
Guarda estos datos de la consola en un archivo de texto y compártelos con nuestro equipo de soporte si necesitas más ayuda.
Si estás suscrito a notificaciones, optado con OneSignal y tienes un ID de suscripción, puedes enviarte una notificación.
Sigue los pasos en [Buscar y configurar suscripciones de prueba](./test-users) para configurarte como probador y enviarte una notificación.
Si no estás recibiendo notificaciones en Chrome, usa estas herramientas de diagnóstico específicas de Chrome para identificar el problema.
1. En una nueva pestaña, abre `chrome://gcm-internals`.
2. Haz clic en el botón "Start Recording" en la parte superior izquierda. Asegúrate de ver "Connection State: CONNECTED".
3. Deja esto abierto y envíate otra notificación push a tu suscripción de web push de Chrome.
4. Deberías ver algo en el "Receive Message Log" si lo recibiste.
* Si no ves un "Data msg received", entonces tu navegador Chrome no está recibiendo la notificación en absoluto. Por favor háznos saber sobre esto en soporte.
* Si ves "Data msg received" pero aún no recibiste una notificación, continúa con el siguiente paso.
5. Abre una nueva pestaña en `chrome://serviceworker-internals`
6. Busca `Scope: https://your-site.com` (reemplaza `your-site.com` con el dominio real de tu sitio).
7. Haz clic en **Inspect**, o **Start -> Inspect**. Aparecerá una ventana emergente de Chrome Developer Tools.
8. En la ventana emergente de Chrome Developer Tools de nuestro service worker, haz clic en la pestaña **Console** y ejecuta `OneSignalWorker.log.trace();`. Debería devolver `undefined`. Cualquier mensaje de nuestro service worker debería aparecer ahora en esta ventana emergente.
¿Necesita ayuda?
Chatee con nuestro equipo de Soporte o envíe un correo electrónico a `support@onesignal.com`
Por favor incluya:
* Detalles del problema que está experimentando y pasos para reproducir si están disponibles
* Su ID de aplicación de OneSignal
* El ID externo o ID de suscripción si corresponde
* La URL del mensaje que probó en el panel de OneSignal si corresponde
* Cualquier [registro o mensaje de error](/docs/es/capturing-a-debug-log) relevante
¡Estamos felices de ayudar!
***