Widget

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.

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_ak_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.

Navegador	Version minima
Chrome	80+
Firefox	75+
Safari	13+
Edge	80+

Navegador

Version minima

Chrome

80+

Firefox

75+

Safari

13+

Edge

80+

Empezar

Workspace

Construir un agente

Ejemplos

Widget

Caracteristicas

Ligero

Streaming

Personalizable

Responsive

Interactivo

API programatica

Vista rapida

Flujo de comunicacion

Que tools ve el widget

Compatibilidad

Siguiente paso

Instalacion

​Caracteristicas

Ligero

Streaming

Personalizable

Responsive

Interactivo

API programatica

​Vista rapida

​Flujo de comunicacion

​Que tools ve el widget

​Compatibilidad

​Siguiente paso

Instalacion

Caracteristicas

Vista rapida

Flujo de comunicacion

Que tools ve el widget

Compatibilidad

Siguiente paso