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.
50d Consejo rápido de depuración
Abre la Consola de Desarrollador de tu 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 tu página, sigue estos pasos de solución de problemas en orden:
Error: "Widget no configurado" (con detalles sobre cada atributo data-* que falta)
Revisa la consola del navegador para este mensaje de error.
Asegúrate de que todos los atributos de datos requeridos estén presentes en la etiqueta del script:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>Error: "Se requiere autenticación" o "Credenciales inválidas"
El widget no puede autenticarse con la API. Esto suele ocurrir cuando las credenciales son incorrectas o han expirado.
Los problemas de autenticación suelen ser sencillos de solucionar. Trabaja a través de estas verificaciones:
client_id sea correcto en tu aplicación OAuth - Copia directamente desde tu panel para evitar errores tipográficos¿Aún atascado? Intenta crear una nueva aplicación OAuth en tu 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: Revisa la pestaña de red del navegador para los encabezados de solicitud de token y compara X-Embed-Origin con tu 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. Desactiva esta configuración o ajusta 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 tu página, pero a veces pueden ocurrir conflictos.
Sigue estos pasos para diagnosticar problemas de color:
Consejo de depuración: Abre el widget en tu navegador y utiliza la herramienta de inspección de elementos para verificar qué valores de CSS se están aplicando realmente. Esto te mostrará si tus colores se están cargando o siendo sobrescritos.
Cuando el widget se carga correctamente pero las funciones 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 pasa nada o aparece un error. Revisa la pestaña de red del navegador para solicitudes fallidas (debería 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. Diagnostica sistemáticamente:
Prueba rápida: Si los mensajes funcionan en una ventana de incógnito pero no en tu navegador normal, el problema probablemente esté relacionado con extensiones del navegador o datos de autenticación en caché.
El widget requiere características modernas del navegador:
Navegadores mínimos soportados: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Cuando necesites asistencia adicional más allá de esta guía, estas herramientas y recursos te ayudarán a diagnosticar problemas o obtener soporte.
Habilita el modo de depuración para ver registros detallados en la consola de tu navegador. Esto proporciona información sobre lo que el widget está haciendo en cada paso:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>¿Aún tienes problemas?
Revisa nuestra guía de configuración o contacta con soporte con los registros de la consola de tu navegador y los detalles de configuración.