Saltar al contenido
Documentación

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. Los mensajes que el chat muestra a los visitantes se citan aquí en inglés; los visitantes los ven en el idioma del widget.

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.
  • El país del visitante está bloqueado. La consola muestra intoCHAT: this agent is not offered in the visitor's country (Share > Limits and access), so the chat is not shown. El país está en Blocked countries en la pestaña Share. Quítalo y haz clic en Save. El país se obtiene de la dirección IP, así que un visitante con una VPN puede parecer que está en otro sitio. Consulta Límites y acceso.
  • 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 se puede chatear con el agente en el Playground, y solo tú y los miembros de tu equipo.
  • «This chat isn't available in your region.» El país del visitante está en Blocked countries en la pestaña Share. Quítalo y haz clic en Save.
  • «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.

Los visitantes ven un mensaje de límite

  • «Too many messages. Please try again later.» Este visitante alcanzó Limit messages per visitor en la pestaña Share. Puede volver a escribir cuando termine su hora, contada desde su primer mensaje. Las personas de una misma red comparten un límite. Sube el número o desactiva el límite.
  • «Too many messages right now. Please try again in a moment.» Se alcanzaron los límites por hora propios de intoCHAT, que se aplican a todos los agentes, para este agente o para la dirección IP del visitante. Espera un momento y vuelve a intentarlo.
  • «This chat has reached its limit for now. Please try again later.» El agente alcanzó su Monthly message cap for this agent. La tarjeta muestra la cuenta y la fecha en que vuelve a empezar. Sube el tope o desactívalo; el agente vuelve a responder desde el siguiente mensaje.
  • «This chat isn't available in your region.» El país del visitante está en Blocked countries.
  • «Message limit reached»: se han agotado los mensajes mensuales de tu plan para todos tus agentes. Consulta Planes y límites.
  • «The Playground couldn't reply» con una nota sobre el tope mensual: los mensajes del Playground cuentan para el tope del agente. Súbelo o desactívalo.

Consulta Límites y acceso.

Los textos del widget están en otro idioma

  • Los botones y avisos están en otro idioma. Siguen el ajuste Widget language de la pestaña Appearance. Con Automatic, la burbuja del chat usa primero el atributo lang de la etiqueta <html> de tu página, por ejemplo <html lang="es">, y después los idiomas del navegador del visitante. Muchos creadores de webs ponen este atributo por ti; comprueba que coincide con la página. Para usar un solo idioma en todas partes, elígelo en Widget language y haz clic en Save changes.
  • Una página en otro idioma muestra inglés. El widget habla inglés, alemán, francés, italiano y español. Con cualquier otro idioma de página pasa a los idiomas del navegador del visitante y, si no, al inglés.
  • El iframe en la página o el enlace directo no siguen el idioma de la página. No tienen página anfitriona, así que con Automatic siguen el navegador del visitante.
  • Tu bienvenida u otros textos siguen en un solo idioma. Los textos que escribes tú aparecen tal cual. Solo se traducen los textos predeterminados.
  • El agente responde en otro idioma. Las respuestas siguen Reply language en la pestaña Setup, no este ajuste. Por defecto es el idioma en que escribe el visitante. Para usar un solo idioma en todas las respuestas, elígelo en Reply in, activa Always use this language y haz clic en Save changes. Consulta Instrucciones.

Consulta Aspecto.

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.

El entrenamiento no termina

  • Cerraste la página durante el entrenamiento. El entrenamiento sigue en los servidores de intoCHAT. Abre la pestaña Knowledge para ver su progreso.
  • Hay fuentes que siguen pendientes de entrenar. Abre la pestaña Knowledge: un entrenamiento interrumpido se reanuda al hacerlo. Si la barra sigue indicando «… sources waiting to be trained», haz clic en Train agent. Las fuentes terminadas siguen entrenadas.
  • Una fuente muestra Failed. Pasa el ratón por la etiqueta para ver el motivo. Haz clic en Retry failed o usa Re-index saved text en la fuente.
  • Falta un archivo o una página que añadiste. Aún se estaba leyendo cuando saliste de la página. Vuelve a añadirlo y espera a que aparezca como añadido.

Consulta Gestionar fuentes.

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 páginas web y de Notion solo se vuelven a leer solas si el Auto-resync está activado; los archivos, textos y Q&A, nunca.
  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.
  • Con el traspaso por correo activado, a un visitante que pide hablar con una persona se le ofrece el traspaso en lugar del formulario, salvo que se cumpla una regla.

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.

El traspaso por correo no funciona

  • El agente nunca lo ofrece. Comprueba que Offer hand-off by email está activado en la pestaña Setup y que has hecho clic en Save changes. El agente solo lo ofrece cuando el visitante pide hablar con una persona o quiere un seguimiento que el agente no puede dar. Los chats temporales no se pueden traspasar. Si el chat en vivo está activado y alguien tiene abierta la bandeja de Live chat, el agente pide en su lugar a tu equipo que se una, y solo ofrece el traspaso por correo si el visitante prefiere que le contacten por correo.
  • El agente dice que no ha podido pasar la conversación. El agente ya envió 20 traspasos en la última hora, o el correo no se pudo enviar. Inténtalo más tarde.
  • El agente dice que el equipo ya tiene la conversación. Esta conversación se traspasó hace menos de 10 minutos.
  • No llega ningún correo. Revisa los destinatarios en Email when a new lead arrives en la pestaña Leads y tu carpeta de spam. Los correos enviados desde el Playground empiezan por [Test].

Consulta Traspaso por correo.

No se ofrece el chat en vivo

  • El agente ofrece el traspaso por correo, o no ofrece ninguna persona. Comprueba que Offer live chat when someone from the team is online está activado en Live chat, en la pestaña Setup. El chat en vivo solo se ofrece mientras alguien de tu equipo está en línea: con la bandeja de Live chat abierta en una pestaña, en los últimos 2 minutos, por alguien con el rol Editor o superior. Una pestaña en segundo plano deja de contar al cabo de unos 17 minutos.
  • No pasa nada en el Playground. El Playground no muestra el chat en vivo. Pruébalo desde tu web o desde el enlace directo del agente.
  • No pasa nada en un chat temporal. Los chats temporales nunca piden el chat en vivo.
  • El visitante no ve mis respuestas. Si tomaste el control de un chat en el que el visitante no pidió hablar con una persona, su ventana del chat solo muestra tus respuestas después de su siguiente mensaje o al recargar la página.

Consulta Chat en vivo.

Un webhook no llega

Haz clic en Recent deliveries debajo del webhook en la pestaña Leads. El error de un envío fallido suele indicar la causa.

  • HTTP 301: redirects aren't followed, u otro estado 3xx: indica la dirección final a la que lleva la redirección.
  • No response within 10 seconds.: responde primero con un estado 2xx y haz el trabajo lento después.
  • The server's TLS certificate isn't valid.: corrige o renueva el certificado de tu servidor.
  • The webhook is turned off. Turn it on to deliver events.: activa el webhook y luego haz clic en Resend.
  • La dirección se rechaza al guardar: usa una dirección pública que empiece por https://. No se admiten direcciones de redes privadas o internas.
  • Tu comprobación de la firma falla: calcúlala sobre el cuerpo sin procesar antes de interpretar el JSON, incluye el valor de X-IntoChat-Timestamp y usa el secreto más reciente si hiciste clic en New secret. Si rechazas marcas de tiempo antiguas, comprueba el reloj de tu servidor.
  • No llega nada en absoluto: comprueba que el webhook está en Active y que el evento está marcado en Events to send. Un contacto que vuelve no genera un nuevo lead.created.

Consulta Webhooks.

Has perdido tu app de autenticación

  • Tienes un código de recuperación. En el paso del código de la página de inicio de sesión, haz clic en Usar un código de recuperación e introduce uno. Después desactiva y vuelve a activar la autenticación en dos pasos en Settings, Account para configurar tu móvil nuevo.
  • No te queda ningún código de recuperación. Escribe a support@intochat.ai desde la dirección de correo de tu cuenta. Cuando el soporte haya confirmado que eres tú, puede desactivarte la autenticación en dos pasos.
  • Los códigos siempre se rechazan. Configura la hora de tu móvil para que se actualice automáticamente: los códigos dependen del reloj. Además, cada código funciona una sola vez.

Consulta Autenticación en dos pasos.

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

Ver como Markdown