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 en la fuente de la página implementada.
- 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 mismo shell de la aplicación elimina el script durante la navegación del lado del cliente.
- 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.
- Fuente de la página de búsqueda para
chattybox.ai/widget.js. - 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 creada para un proyecto diferente.
- Se implementó una clave de prueba en producción o se implementó una clave de producción en prueba.
- 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.
- Si se configuran orígenes permitidos, agregue el origen exacto que sirve a la página, incluido el protocolo y el nombre de host.
- 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 en este orden:
data-localeen el script del widget.- El valor de la página
<html lang>. - El idioma del navegador del visitante.
- Respaldo inglés.
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. - Vuelva a extraer todas las versiones en idiomas si las respuestas citan o recuperan contenido en el idioma incorrecto.
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 depender de capturas de pantalla, videos, acordeones ocultos o contenido iframe como única fuente.
- Vuelva a raspar la página actualizada y luego vuelva a probar.
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 redirige, bloquea rastreadores, requiere autenticación o está excluida por reglas de robots.
- 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 raspar después de publicar cambios de contenido.
- Consulte el panel en busca de páginas fallidas u omitidas.
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.