Solución de problemas
Utilice esta página cuando el widget esté instalado pero no se comporte como se esperaba.
El widget no aparece
Primero verifique la consola del navegador. ChattyBox informa que faltan atributos requeridos allí.
Causas comunes:
- El script no está presente ni en HTML desplegado ni en DOM vivo.
- El script se agregó a la plantilla, diseño, contenedor del administrador de etiquetas o área de código CMS incorrectos.
- El script está detrás de una regla de consentimiento o un activador del administrador de etiquetas que no se activó.
- El componente que monta el loader nunca se ejecuta en esa ruta.
- Una política de seguridad de contenido bloquea
https://chattybox.ai/widget.js. - CSS u otro widget se superpone al iniciador.
Solución más pequeña:
- Abra la página pública implementada en una ventana de incógnito.
- Busque
chattybox.ai/widget.jsen fuente y panel Elements; un loader SDK puede existir solo en DOM. - Confirme que el script aparece una vez e incluye
data-api-keyydata-api-url. - Mueva el script al pie de página global, al diseño de la aplicación, a la raíz Docusaurus o al activador GTM Todas las páginas si falta.
Falta data-api-url
El widget sale antes de tiempo cuando falta data-api-url.
Utilice el fragmento completo del panel o agregue el atributo requerido:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Si su panel muestra una URL API diferente, use el valor del panel en lugar del valor de ejemplo.
Errores de origen o clave API no válidos
Causas comunes:
- La clave del widget público se copió incorrectamente.
- La clave fue eliminada, caducada o pertenece a otro backend/API URL.
- La clave ha permitido orígenes y el origen del sitio actual no está incluido.
- La página se carga desde
http://localhost, una URL de vista previa o un dominio personalizado que no está permitido para esa clave.
Correcciones:
- Abra el proyecto en el panel ChattyBox.
- Copie un fragmento nuevo de la pestaña Insertar.
- Revise orígenes solo si activó la restricción; añada esquema, host y puerto exactos.
- Vuelva a implementar o publicar el sitio y pruébelo nuevamente en una ventana de incógnito.
Idioma incorrecto
Un chatbot RAG basado en fuentes fiable necesita contenido fuente claro para cada respuesta.
El widget elige el idioma de interfaz así:
data-locale, solo con override permitido.- En fixed, el idioma predeterminado.
- En auto,
<html lang>, navegador y predeterminado. - Un valor no admitido se convierte en inglés sin continuar.
Correcciones:
- Elimine un valor
data-localeincorrecto si la página debe detectar automáticamente el idioma. - Establezca
<html lang="de">,<html lang="fr">o el código de idioma correspondiente en páginas localizadas. - Agregue
data-locale="de"solo cuando una página deba forzar un idioma de interfaz de usuario de widget específico. - El idioma de UI no fuerza el de respuesta; indexe y pruebe cada idioma. Los cambios se resuelven al iniciar, no en cada ruta SPA.
Sin citas ni respuestas débiles
ChattyBox respuestas del contenido indexado. Las citas faltantes o las respuestas débiles generalmente significan que el contenido fuente necesario no se recuperó o no responde claramente a la pregunta.
Correcciones:
- Haga la misma pregunta en el chat de prueba del panel y compare las páginas citadas.
- Asegúrese de que la página de origen sea pública y esté incluida en el rastreo.
- Agregue títulos claros, ejemplos, preguntas frecuentes y texto de respuesta directa a la página de origen.
- Evite capturas, vídeo, contenido oculto, JavaScript o iframes como única fuente.
- Espere el cooldown y embeddings; revise avisos de contenido parcial de 512 KiB.
Páginas no raspadas o con contenido obsoleto
Causas comunes:
- La página no aparece en el mapa del sitio enviado.
- El modo URL manual no incluía la página.
- La página bloquea HTTP normal, requiere autenticación/CAPTCHA, redirige a un destino bloqueado o solo carga con JavaScript.
- El contenido de la página cambió después del último raspado.
- El contenido se presenta de tal manera que el rastreador no puede extraer texto útil.
Correcciones:
- Confirme que la página se abra públicamente en una ventana privada del navegador.
- Utilice el modo de mapa del sitio para una cobertura amplia o URL manuales para un conjunto seleccionado.
- Envíe la URL canónica en lugar de una URL de seguimiento, una URL de redireccionamiento o una URL de inicio de sesión.
- Vuelva a rastrear tras el cooldown: 7 días Free o 24h pago, incluso tras fallo.
- Compare recuentos y Content: Completed puede incluir omisiones;
robots.txtno se aplica y Rebuild Index no vuelve a obtener la web.
Configuración no guarda
Guarde General Settings y Scraping Configuration por separado. Con Config locked, el bloqueo es irreversible y Persona, scrape y operaciones de contenido se rechazan; despliegue por CLI. Solo branding permitido por plan sigue siendo excepción. Analytics y Content Gaps requieren Pro/Business; Logs está en todos los planes.
Todavía atascado
Recopile estos detalles antes de contactar al soporte:
- La URL de la página pública donde debería aparecer el widget.
- Una captura de pantalla o copia de cualquier error de la consola del navegador.
- Si la página usa HTML, Next.js, Docusaurus, WordPress, CMS o Google Tag Manager.
- Si el fragmento incluye
data-api-keyydata-api-url. - Una pregunta de prueba que debería funcionar y la página fuente que la responde.