# Solución de problemas: fallos comunes y arreglos

> Resuelve problemas comunes de intoCHAT: la burbuja no aparece, el rastreo no halla páginas, respuestas vagas o erróneas, falta el formulario o fallan acciones.

La mayoría de los problemas tienen pocas causas. Sigue la sección que coincida con lo que ves. La consola de desarrollador del navegador (F12) suele indicar la causa directamente.

## La burbuja del chat no aparece

- **El script no está en la página.** Abre el código fuente de la página y busca `embed.js`. Muchos creadores de webs solo añaden el código personalizado a la web publicada, no a la vista previa del editor. El script funciona en el head o en el body; justo antes de `</body>` es el lugar recomendado. Consulta [Instalar con una etiqueta script](/es/docs/script-tag).
- **ID de agente incorrecto.** La consola muestra `Chatbot not found.` Vuelve a copiar el snippet desde la pestaña **Share**.
- **La web no está en los dominios permitidos.** La consola muestra `intoCHAT: this website is not in the allowed domains of this agent, so the chat is not shown.` El agente está limitado a otras webs. En la pestaña **Share**, añade el dominio de esta web en **Where this agent can appear**, o vacía la lista para permitir cualquier web. Un dominio nuevo puede tardar hasta un minuto en llegar a la ventana de chat. Consulta [Dominios permitidos](/es/docs/allowed-domains).
- **El agente es privado.** La consola muestra `intoCHAT: this agent is private, so the chat is not shown.` En la pestaña **Share**, desactiva **Private agent** y haz clic en **Save**.
- **Google Tag Manager.** GTM elimina el atributo `data-chatbot-id` de las etiquetas script en las etiquetas de HTML personalizado, así que el widget no sabe qué agente cargar. La consola muestra "The embed script needs a data-chatbot-id attribute." Usa el snippet de la [guía de Google Tag Manager](/es/integraciones/google-tag-manager).
- **Content Security Policy.** Si tu web envía una cabecera CSP, permite `https://www.intochat.ai` en `script-src`, `connect-src` y `frame-src`.
- **Optimizadores de scripts.** El script lee el ID del agente de su propia etiqueta. Si un plugin combina o reescribe scripts, excluye `embed.js`.
- **Bloqueadores de anuncios o de rastreo.** Algunas extensiones del navegador bloquean scripts de chat de terceros. Prueba en una ventana privada sin extensiones.
- **La burbuja aparece pero el agente deja de responder.** Los visitantes ven «Message limit reached» cuando se agota tu cupo mensual; consulta [Planes y límites](/es/docs/plans-and-limits).

## Un iframe o el enlace directo no muestran el chat

- **El iframe se queda vacío o muestra un error del navegador.** La web no está en los [dominios permitidos](/es/docs/allowed-domains) del agente, o el agente es privado. El navegador no carga el chat en el recuadro, y la consola menciona `frame-ancestors`. Añade el dominio de la web en la pestaña **Share**, en **Where this agent can appear**.
- **«This agent is private.»** Desactiva **Private agent** en la pestaña **Share**. Mientras esté activado, solo tú puedes chatear con el agente, en el **Playground**.
- **«This agent doesn't exist anymore.»** El ID del agente en la dirección no es correcto, o el agente se ha eliminado. Vuelve a copiar el código desde la pestaña **Share**.
- **«The chat couldn't load. Please try again later.»** No se pudieron cargar los ajustes del agente. Recarga la página.

## El rastreo de la web no encuentra páginas

- **«No pages found»**: intoCHAT no pudo encontrar páginas en esa web. Revisa la dirección, o activa **Single page mode** y añade las páginas importantes una a una.
- **Todo queda filtrado**: revisa **Exclude URLs containing**. Un patrón como `/` coincide con todas las páginas.
- **«The page answered with an error (403)»** o similar: la web bloquea a los visitantes automáticos. Pide a quien gestiona la web que permita el acceso, o sube el contenido como archivo o pégalo como texto.
- **«No meaningful content found»**: la página apenas tiene texto legible.
- **«Monthly crawl limit reached»**: espera al reinicio mensual o cambia de plan. Archivos, textos y Q&A siguen funcionando.

Consulta [Rastreo del sitio web](/es/docs/website-crawl) y [Archivos](/es/docs/files).

## Las respuestas son erróneas, vagas o están desfasadas

1. Prueba la pregunta en el **Playground**.
2. En la pestaña **Knowledge**, usa **Preview the text** en la fuente que debería contener la respuesta. Si el texto no está, la página no se leyó como esperabas.
3. Para las preguntas frecuentes, añade un par de pregunta y respuesta. Las respuestas Q&A tienen prioridad.
4. Haz clic en la estrella (**Mark as priority**) de la fuente más fiable. Pasará por delante del resto del conocimiento relacionado y prevalecerá si hay contradicciones, sin volver a entrenar.
5. Si cambió una página de tu web, haz clic en **Refresh from website** (actualizar desde la web) en su fuente; vuelve a leer la página y la reentrena si el texto cambió. Si cambió un archivo, sube la nueva versión con el mismo nombre y entrena. Las fuentes no se actualizan solas.
6. Borra las fuentes desfasadas que contradicen a las actuales y revisa tus **Instructions**.

Cuando no encuentra nada relevante, el agente dice que no lo sabe en lugar de inventar. Es intencionado: añade el contenido que falta. Consulta [Gestionar fuentes](/es/docs/managing-sources).

## El formulario de leads no aparece

- **Enable lead collection** está activado y has hecho clic en **Save lead settings**.
- En el modo **Manual (visitor asks)** el formulario solo aparece cuando el visitante pide que lo contacten.
- Las reglas de palabras clave solo revisan el último mensaje del visitante.
- El formulario aparece como máximo tres veces por conversación, y no vuelve a aparecer cuando el visitante ya dejó sus datos en esa sesión. Para probar de nuevo, abre una ventana privada nueva.
- En los chats temporales no aparece nunca.

Consulta [Captación de leads](/es/docs/lead-collection).

## Una acción falla

- Abre la acción y haz clic en **Send test request** en **2. Try it** para ver el estado y la respuesta.
- **«URL points to a blocked or internal host»**: las direcciones privadas e internas se rechazan. Usa una URL pública.
- **«This address redirects somewhere else»**: haz clic en **Use this address**.
- **«Request timed out after 30s»**: el endpoint es demasiado lento.
- El agente nunca la llama: comprueba que la acción está activada y que **When to use** describe las preguntas para las que sirve.
- Las acciones del lado del cliente solo funcionan por completo en una página con el widget instalado, y fallan en una inserción con iframe. Consulta [Acciones del lado del cliente](/es/docs/client-actions).

¿Sigues sin resolverlo? Escribe a support@intochat.ai e indica el ID de tu agente.
