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_ak_xxx"
></script>
Para widget publico recomendamos Access Keys (tq_ak_...). Tambien funciona con API Keys (tq_live_...). Ambas se gestionan desde Agente > Credentials.
Flujo de comunicacion
Tu sitio web Thaliq API
│ │
│ GET /api/agent/stream?q=... │
│ Headers: │
│ x-api-key: tq_ak_xxx │
│ x-integration-type: widget │
│───────────────────────────────────▶│
│ │ Procesa con Claude AI
│ │ Ejecuta tools (si aplica)
│ SSE: content.delta │
│◀───────────────────────────────────│
│ SSE: content.delta │
│◀───────────────────────────────────│
│ SSE: response.completed │
│◀───────────────────────────────────│
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
| Navegador | Version minima |
|---|
| Chrome | 80+ |
| Firefox | 75+ |
| Safari | 13+ |
| Edge | 80+ |
Siguiente paso
Instalacion
Aprende como instalar el widget en tu sitio web.
