API programatica

El widget expone una API global en window.ThaliqWidget que permite controlarlo programaticamente desde JavaScript.

Como acceder a la instancia

Hay dos formas de inicializar el widget, y cada una expone la API de manera distinta:

Opcion A — Auto-init con `data-api-key`

<script src="https://cdn.thaliq.com/widget.js" data-api-key="tq_live_xxx"></script>

Despues de cargar, window.ThaliqWidget es directamente la instancia. Podes llamar metodos sobre el global:

window.ThaliqWidget.open();
window.ThaliqWidget.send('Hola');

Opcion B — Init programatico

const widget = ThaliqWidget.init({ apiKey: 'tq_live_xxx' });
window.thaliq = widget; // guardalo donde quieras

ThaliqWidget.init() retorna la instancia. El global window.ThaliqWidget sigue siendo { init, _class } (no la instancia). Guarda el retorno para llamar metodos despues.

No mezcles estilos. Si usas <script data-api-key> para auto-init, no llames ThaliqWidget.init() despues — sobreescribirias la instancia.

Metodos de la instancia

`open()`

Abre la ventana de chat.

window.ThaliqWidget.open();

`close()`

Cierra la ventana de chat.

window.ThaliqWidget.close();

`toggle()`

Alterna entre abierto y cerrado.

window.ThaliqWidget.toggle();

`send(text)`

Envia un mensaje programaticamente. Util para iniciar conversaciones contextuales. Internamente escribe el texto en el input y dispara el envio.

window.ThaliqWidget.send('Necesito ayuda con mi pedido #12345');

Ejemplo: Boton contextual

<button onclick="ThaliqWidget.send('Quiero saber mas sobre el Plan Growth')">
  Preguntar sobre Plan Growth
</button>

`reset()`

Reinicia la conversacion: limpia los mensajes en pantalla, descarta el conversationId activo y vuelve al estado inicial. La proxima request crea un thread nuevo.

window.ThaliqWidget.reset();

`setMcpTokens(tokens)`

Actualiza los tokens MCP en runtime (passthrough al backend en el header X-MCP-Tokens). Util cuando el usuario se loguea contra un sistema externo despues de cargar el widget y necesitas darle acceso al MCP server correspondiente sin recargar.

window.ThaliqWidget.setMcpTokens({
  'github-mcp': 'ghp_xxx',
  'jira-mcp': 'eyJh...',
});

`destroy()`

Elimina el widget completamente del DOM y limpia listeners + suscripcion SSE. Util para SPAs cuando navegas a otra pagina o cuando el componente que lo monta se desmontya.

window.ThaliqWidget.destroy();

Ejemplo: Abrir el chat automaticamente

<script
  src="https://cdn.thaliq.com/widget.js"
  data-api-key="tq_live_xxx"
></script>

<script>
  // Abrir el chat 3 segundos despues de cargar la pagina
  setTimeout(() => {
    window.ThaliqWidget.open();
  }, 3000);
</script>

Ejemplo: Abrir con un boton custom

Usa data-show-launcher="false" para ocultar el boton flotante y controlar el chat con tu propio boton:

<!-- Tu propio boton -->
<button id="help-btn" class="my-help-button">
  ¿Necesitas ayuda?
</button>

<script
  src="https://cdn.thaliq.com/widget.js"
  data-api-key="tq_live_xxx"
  data-show-launcher="false"
></script>

<script>
  document.getElementById('help-btn').addEventListener('click', () => {
    window.ThaliqWidget.open();
  });
</script>

Ejemplo: Mensaje contextual segun la pagina

<script>
  // Detectar la pagina actual y enviar mensaje contextual
  document.addEventListener('DOMContentLoaded', () => {
    const path = window.location.pathname;

    if (path.includes('/pricing')) {
      // En la pagina de pricing, pre-cargar pregunta
      window.ThaliqWidget.open();
      window.ThaliqWidget.send('Quiero mas informacion sobre los planes');
    }
  });
</script>

Empezar

Workspace

Construir un agente

Widget

Ejemplos

Como acceder a la instancia

Opcion A — Auto-init con `data-api-key`

Opcion B — Init programatico

Metodos de la instancia

`open()`

`close()`

`toggle()`

`send(text)`

`reset()`

`setMcpTokens(tokens)`

`destroy()`

Ejemplo: Abrir el chat automaticamente

Ejemplo: Abrir con un boton custom

Ejemplo: Mensaje contextual segun la pagina

​Como acceder a la instancia

​Opcion A — Auto-init con data-api-key

​Opcion B — Init programatico

​Metodos de la instancia

​open()

​close()

​toggle()

​send(text)

​reset()

​setMcpTokens(tokens)

​destroy()

​Ejemplo: Abrir el chat automaticamente

​Ejemplo: Abrir con un boton custom

​Ejemplo: Mensaje contextual segun la pagina

Como acceder a la instancia

Opcion A — Auto-init con `data-api-key`

Opcion B — Init programatico

Metodos de la instancia

`open()`

`close()`

`toggle()`

`send(text)`

`reset()`

`setMcpTokens(tokens)`

`destroy()`

Ejemplo: Abrir el chat automaticamente

Ejemplo: Abrir con un boton custom

Ejemplo: Mensaje contextual segun la pagina