<!--
  AUTO-GENERADO por scripts/import-corpus.mjs a partir de manuales/corpus/ — NO EDITAR A MANO.
  Para cambiar este contenido: edita manuales/neutros/*.html, regenera el corpus
  (manuales/build-corpus.mjs) y vuelve a ejecutar "pnpm run import:corpus".
  Fuente: manuales/neutros/06-manual-widget.html#s5
-->

## 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.