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.
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
F12y ve a la pestana Console.
Pasos para diagnosticar
-
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>. -
Confirma que tu sitio use HTTPS. El
loader.jsse sirve por HTTPS y los navegadores bloquean mixed content: si tu pagina carga porhttp://, el script no se ejecutara. Pasa tu sitio a HTTPS. -
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 bloqueaomnifox.io. Anadehttps://omnifox.ioascript-srcyconnect-src. - Bloqueadores de anuncios/privacidad pueden frenar el widget; pruébalo con ellos desactivados.
-
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. -
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 elbody. - 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
Artículos relacionados
-
Cómo conectar Telegram
Conecta un bot de Telegram a tu bandeja de Omnifox en pocos minutos usando BotFather.
-
Guía completa del Webchat (chat para tu sitio web)
El Webchat a fondo, en 32 capítulos: instalarlo, apariencia, idiomas, formulario, departamentos, horario, disparadores, IA, la bandeja, identificación segura y API de JavaScript, con un sitio real de punta a punta.
-
Códigos de error de WhatsApp (Meta): qué significan y qué hacer
Tabla con los códigos de error de Meta más comunes al enviar por WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) y cómo resolver cada uno.
-
Pasar de WhatsApp por QR a Coexistence o Cloud API
Cuando termines de probar con el código QR, pasa tu número a la conexión oficial: sin topes, con plantillas, difusiones y sin riesgo de bloqueo por volumen.
-
Comentarios de Instagram y Facebook: responder y moderar desde Omnifox
Ve y responde los comentarios de tus publicaciones y anuncios de Facebook e Instagram, en público o en privado, y configura respuestas automáticas.