Problemas comunes y soluciones para la integración y uso de widgets.
¿Tienes problemas? Estás en el lugar correcto. Esta guía cubre los problemas más comunes que los desarrolladores encuentran al integrar el widget, junto con soluciones paso a paso. La mayoría de los problemas se pueden resolver en solo unos minutos.
🔍 Consejo de depuración rápida
Abra la Consola de Desarrollador de su navegador (F12) antes de solucionar problemas. La mayoría de los errores del widget mostrarán mensajes claros en la consola que apuntan directamente al problema.
Si el widget no aparece en absoluto en su página, siga estos pasos de solución de problemas en orden:
Error: "Widget no configurado" (con detalles sobre cada atributo data-* faltante)
Verifique la consola del navegador para este mensaje de error.
Asegúrese de que todos los atributos de datos requeridos estén presentes en la etiqueta de script:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>Error: "Autenticación requerida" o "Credenciales inválidas"
El widget no logra autenticarse con la API. Esto suele suceder cuando las credenciales son incorrectas o han expirado.
Los problemas de autenticación suelen ser sencillos de solucionar. Trabaje a través de estas verificaciones:
client_id sea correcto en su aplicación OAuth - Copie directamente desde su panel para evitar errores tipográficos¿Aún atascado? Intente crear una nueva aplicación OAuth en su panel. A veces, comenzar de nuevo resuelve problemas de configuración oscuros.
Error: "Origen no permitido" o solicitud de token de widget rechazada
Común al incrustar en un iframe y el dominio host no está listado en los orígenes permitidos de OAuth.
Consejo de validación: Verifique la pestaña de red del navegador para los encabezados de solicitud de token y compare X-Embed-Origin con su entrada de allowed_origins de OAuth.
Problema de posicionamiento del botón
El widget se carga pero el botón está fuera del área visible.
position: fixedoverflow: hiddenSi hide_on_mobile está habilitado en la configuración, el widget estará oculto en dispositivos móviles. Desactive esta configuración o ajuste el punto de ruptura móvil.
Los problemas visuales son comunes y generalmente fáciles de solucionar. El widget está diseñado para estar visualmente aislado de su página, pero a veces pueden ocurrir conflictos.
Siga estos pasos para diagnosticar problemas de color:
Consejo de depuración: Abra el widget en su navegador y use la herramienta de inspeccionar elemento para verificar qué valores de CSS se están aplicando realmente. Esto le mostrará si sus colores se están cargando o siendo sobrescritos.
Cuando el widget se carga correctamente pero las características no funcionan como se esperaba, estas soluciones ayudarán.
Error de red, tiempo de espera o sesión expirada
El usuario escribe un mensaje y hace clic en enviar, pero no sucede nada o aparece un error. Verifique la pestaña de red del navegador para solicitudes fallidas (deberían mostrarse en rojo en la pestaña de red).
Los problemas de envío de mensajes generalmente están relacionados con la conectividad de red o sesiones expiradas. Diagnostique sistemáticamente:
Prueba rápida: Si los mensajes funcionan en una ventana de incógnito pero no en su navegador normal, el problema probablemente esté relacionado con las extensiones del navegador o los datos de autenticación en caché.
El widget requiere características modernas del navegador:
Navegadores mínimos compatibles: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Cuando necesite asistencia adicional más allá de esta guía, estas herramientas y recursos le ayudarán a diagnosticar problemas o obtener soporte.
Habilite el modo de depuración para ver registros detallados en la consola de su navegador. Esto proporciona información sobre lo que está haciendo el widget en cada paso:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>¿Sigue teniendo problemas?
Verifique nuestra guía de configuración o contacte con soporte con los registros de la consola de su navegador y los detalles de configuración.