Solución de problemas: fallos comunes y arreglos

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

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 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 y Archivos.

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.

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.

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.

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