> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thaliq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalacion

> Como agregar el widget de Thaliq a tu sitio web

Agrega el script antes del cierre de `</body>` en tu HTML:

```html theme={null}
<script
  src="https://cdn.thaliq.com/widget.js"
  data-api-key="tq_ak_TU_ACCESS_KEY"
></script>
```

El widget se inicializa automaticamente al cargar la pagina. No necesitas escribir JavaScript adicional.

<Tip>
  Para el widget publico recomendamos usar **Access Keys** (`tq_ak_...`, visibles desde el workspace). Las **API Keys** (`tq_live_...`) tambien funcionan, pero solo se muestran una vez al crear. Las dos se gestionan desde **Agente > Credentials**.
</Tip>

### Con opciones de personalizacion

```html theme={null}
<script
  src="https://cdn.thaliq.com/widget.js"
  data-api-key="tq_ak_TU_ACCESS_KEY"
  data-title="Soporte"
  data-primary-color="#00D4AA"
  data-welcome="Hola! En que puedo ayudarte hoy?"
  data-position="bottom-right"
></script>
```

<Warning>
  La key es visible en el HTML del cliente. Esto es intencional — las keys del widget solo dan acceso a tools publicas (`requiresAuth: false`). Para tools con autenticacion del usuario, usa el [SDK](/sdk/overview).
</Warning>

## Verificar la instalacion

Una vez instalado, deberas ver un **boton de chat** flotante en la esquina inferior derecha (o izquierda, segun tu configuracion) de tu sitio.

1. Haz click en el boton
2. Escribe un mensaje
3. Deberas ver la respuesta del agente en streaming

Si no funciona, revisa la [guia de troubleshooting](/widget/troubleshooting).