Skip to main content

​
El widget no aparece

Verifica que el atributo data-api-key tenga una key valida con formato tq_live_xxx. Puedes crear una nueva en API Keys en la plataforma.
Abre las DevTools del navegador (F12) y revisa la pestaña Console y Network. Verifica que la peticion a cdn.thaliq.com/widget.js se complete correctamente (status 200).
El widget usa clases con prefijo thaliq- para evitar conflictos. Si algun estilo de tu sitio interfiere, verifica que no haya reglas CSS globales agresivas (ej: * { display: none !important; }).
Si usas carga diferida (defer, async), el widget se auto-inicializa correctamente. Pero si lo cargas dinamicamente, asegurate de que el DOM este listo.

​
El agente no responde

Ve a API Keys en la plataforma y verifica que la key este activa. Si la revocaste, crea una nueva.
Si ves el mensaje “Limite alcanzado”, has excedido el limite de requests por minuto de tu plan. Espera el tiempo indicado o considera upgradear tu plan.
  • Starter: 5 req/min
  • Growth: 50 req/min
  • Enterprise: Sin limite
Si el agente necesita ejecutar acciones pero no tiene tools configuradas, puede que no responda como esperas. Ve a Tools en la plataforma y verifica la configuracion.

​
Errores comunes en consola

​
[ThaliqWidget] API key is required

No se proporciono data-api-key en el script tag o apiKey en el constructor. 
<!-- Asegurate de incluir data-api-key -->
<script
  src="https://cdn.thaliq.com/widget.js"
  data-api-key="tq_live_xxx"
></script>

​
Error HTTP 403

Tu API Key no tiene acceso a alguna funcionalidad. Esto puede significar:
  • La feature requiere un plan superior
  • La API Key fue creada para un tenant diferente

​
Error HTTP 429

Has alcanzado el rate limit. El widget muestra automaticamente un mensaje con el tiempo de espera. Revisa los limites de tu plan.

​
Error de conexion / CORS

La API de Thaliq permite CORS desde cualquier origen. Si ves errores de CORS:
  1. Verifica que la URL de la API sea correcta (https://api.thaliq.com)
  2. Verifica que no haya un proxy o firewall corporativo bloqueando la conexion
  3. Verifica que tu sitio use HTTPS (las peticiones HTTP a HTTPS pueden ser bloqueadas)

​
El widget se ve mal en mobile

El widget automaticamente cambia a modo pantalla completa en pantallas menores a 480px. Si no se ve correctamente:
  1. Asegurate de tener el meta tag viewport: 
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
  2. Verifica que tu CSS no override estilos del widget

​
Las acciones interactivas no aparecen

Si configuraste instrucciones con acciones (consent, confirm, etc.) pero no aparecen:
  1. Verifica que la instruccion este habilitada en la plataforma
  2. Verifica que la instruccion este asociada a la tool correcta
  3. Verifica que la tool tenga requiresAuth: false (para ser visible en el widget)
  4. Recuerda que en plan Starter, solo el tipo consent esta disponible

​
Aun necesitas ayuda?

Si el problema persiste, contactanos con:
  • La URL de tu sitio web
  • Captura de la consola del navegador (DevTools > Console)
  • Tu plan actual y tenant ID
Contactar soporte