Verificación y resolución de problemas

El widget no aparece en la web

• Comprueba el código fuente de la página en el navegador (clic derecho → «Ver código fuente»), no solo el editor de tu CMS: algunas plataformas cachean las plantillas y tardan en propagar el cambio, o necesitan que publiques explícitamente.
• Prueba en una ventana de incógnito sin extensiones: algunos bloqueadores de anuncios o de privacidad bloquean scripts de chat de terceros.
• Revisa que el snippet no se haya pegado dos veces (por ejemplo, en el tema y en un plugin de código a la vez) ni en conflicto con otro widget de chat de otro proveedor.

«Falta el identificador del widget»

Aparece cuando el atributo data-widget no llega con valor al navegador — típicamente porque se cortó al copiar y pegar a mano, o porque una plantilla con variables no sustituyó el valor. El widget muestra este aviso en vez de fallar en silencio. Solución: vuelve a Canales → Widget Web, copia el snippet de nuevo con el botón «Copiar» y sustituye el bloque completo, sin editarlo a mano.

El widget aparece pero no conecta o no responde

• Dominio no permitido: si en Ajustes → Personalización widget → Dominios permitidos hay al menos un dominio dado de alta, el widget solo conecta desde esos dominios y sus subdominios (ver capítulo 4). Comprueba que el dominio que sirve la página con el snippet está en la lista (recuerda: www.tuagencia.es no cubre tuagencia.es «a secas»; el dominio raíz sí cubre el www). Con la lista vacía, esta causa queda descartada.
• data-api sin /api/v1: si tu instalación usa un backend propio y añadiste manualmente el atributo data-api, la URL debe incluir el sufijo /api/v1 (por ejemplo https://api.tudominio.es/api/v1). Si falta, el widget llama a rutas que no existen y no consigue conectar. En el caso normal (backend compartido de la plataforma) no debes usar este atributo.

Estado «Sin conexión, reintentando…»

El widget detectó que no puede hablar con el servidor (una caída puntual de red o del backend). Muestra un aviso con el botón «Reintentar» y también reintenta automáticamente. La conversación no se pierde: al reconectar continúa donde estaba. Si el aviso persiste varios minutos, contacta con los datos de contacto de tu proveedor.