Troubleshooting: el Webchat no aparece en el sitio

Si instalaste el widget de Webchat y la burbuja no se ve en tu web, esta guia te lleva paso a paso por las causas mas comunes: snippet mal pegado, HTTPS y errores de consola.

Jun 26, 2026

Mira este paso en el video · Solución de problemas

El widget de Webchat es la burbuja de chat que se incrusta en tu sitio. Cuando pegas el snippet y la burbuja no aparece, casi siempre es por uno de cinco motivos. Esta guia los recorre en orden, de lo mas frecuente a lo mas raro.

Antes de empezar

  • Necesitas un canal de Webchat ya creado en Canales -> Conectar canal -> Webchat.
  • Abre la pagina de tu sitio donde deberia verse la burbuja, en una ventana de incognito (para descartar cache y extensiones).
  • Ten a mano la consola del navegador: en Chrome/Edge pulsa F12 y ve a la pestana Console.

Pasos para diagnosticar

  1. Verifica que el snippet este completo y bien ubicado. En el canal de Webchat abre la pestana Instalar (embed) y copia de nuevo el codigo. Debe lucir asi y pegarse justo antes de la etiqueta </body>:

    <script src="https://omnifox.io/widget/loader.js" data-widget-key="..." async></script>
    

    Un error tipico es pegarlo dentro de un comentario, dentro de otro <script>, o despues de </body>.

  2. Confirma que tu sitio use HTTPS. El loader.js se sirve por HTTPS y los navegadores bloquean mixed content: si tu pagina carga por http://, el script no se ejecutara. Pasa tu sitio a HTTPS.

  3. Revisa la consola del navegador. Recarga con la consola abierta y busca lineas en rojo. Senales utiles:

    • Failed to load resource ... loader.js -> el dominio no puede alcanzar Omnifox (firewall, bloqueador, o el snippet apunta a una URL equivocada).
    • Errores de CSP (Content-Security-Policy ... refused to load) -> tu cabecera CSP bloquea omnifox.io. Anade https://omnifox.io a script-src y connect-src.
    • Bloqueadores de anuncios/privacidad pueden frenar el widget; pruébalo con ellos desactivados.
  4. Comprueba el data-widget-key. Si lo editaste a mano y quedo incompleto, el loader no encuentra el canal. Vuelve a copiar el snippet entero desde la pestana Instalar; no modifiques esa cadena.

  5. Descarta cache. Si usas Cloudflare, WordPress con cache, o un CDN, purga el cache del sitio y vuelve a probar en incognito.

Como verificar que quedo bien

En la pestana Instalar del canal hay un registro "Instalado en" con los dominios donde el loader se ha cargado. La primera vez que alguien abre una pagina con tu snippet, el dominio anfitrion aparece ahi. Si ves tu dominio y la marca de tiempo reciente, la instalacion es correcta. Si dice "No installations detected yet", el snippet aun no se ejecuto en ningun navegador.

Si aun no funciona

  • Prueba en otro navegador y en el celular: si aparece en uno y no en otro, es una extension o el cache local.
  • Si tienes un <iframe> o un constructor de paginas (Wix, Squarespace), confirma que permita insertar scripts personalizados en el body.
  • Revisa que el canal de Webchat este activo y no pausado en Canales.

Tips

  • Manten el snippet en tu plantilla global (footer del tema) para que cargue en todas las paginas, no solo en una.
  • Tras cambiar color, nombre o saludo del widget no hace falta reinstalar: el loader lee la configuracion en vivo.

Articulos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp