Skip to main content
El widget de Thaliq es un script JavaScript ligero (~5KB gzip) que agrega un chat flotante a tu sitio web, conectado directamente a tu agente de IA.

​
Caracteristicas

Ligero

~5KB gzipped, sin dependencias externas. Vanilla JavaScript puro.

Streaming

Respuestas en tiempo real via SSE (Server-Sent Events).

Personalizable

Colores, textos, posicion — adaptalo a tu marca.

Responsive

Ventana flotante en desktop, pantalla completa en mobile.

Interactivo

Soporta acciones Human-in-the-Loop (consent, formularios, seleccion).

API programatica

Controla el widget por codigo: abrir, cerrar, enviar mensajes.

​
Vista rapida

<!-- Una sola linea para agregar el chat a tu sitio -->
<script
  src="https://cdn.thaliq.com/widget.js"
  data-api-key="tq_live_xxx"
></script>
Esto renderiza un boton de chat en la esquina inferior derecha. Al hacer click, se abre una ventana de chat conectada a tu agente.

​
Flujo de comunicacion

Tu sitio web                         Thaliq API
    │                                    │
    │  GET /api/agent/stream?q=...       │
    │  Headers:                          │
    │    x-api-key: tq_live_xxx          │
    │    x-integration-type: widget      │
    │───────────────────────────────────▶│
    │                                    │  Procesa con Claude AI
    │                                    │  Ejecuta tools (si aplica)
    │  SSE: content.delta                │
    │◀───────────────────────────────────│
    │  SSE: content.delta                │
    │◀───────────────────────────────────│
    │  SSE: response.completed           │
    │◀───────────────────────────────────│

​
Que tools ve el widget

El widget envia automaticamente el header x-integration-type: widget, lo cual filtra las tools disponibles:
  • Tools con requiresAuth: false → Disponibles en el widget
  • Tools con requiresAuth: true → No disponibles (requieren autenticacion del usuario)
Esto garantiza que usuarios anonimos en tu sitio web solo accedan a tools publicas.

​
Compatibilidad

NavegadorVersion minima
Chrome80+
Firefox75+
Safari13+
Edge80+

​
Siguiente paso

Instalacion

Aprende como instalar el widget en tu sitio web.