POST /api/agent/chat - Thaliq Docs

Endpoint para enviar un mensaje al agente y recibir la respuesta completa en un solo payload. Usa este endpoint cuando no necesites streaming.

Para respuestas en tiempo real, usa el endpoint de streaming.

Request

POST https://api.thaliq.com/api/agent/chat

Headers

Ver Autenticacion para el detalle completo. Headers comunes:

Header	Requerido	Descripcion
`X-API-Key`	Si	API Key del tenant. Resuelve tambien el agente si la key esta asociada a uno
`Content-Type`	Si	`application/json`
`X-Integration-Type`	No	`widget` o `sdk` (filtra tools por `requiresAuth`)
`X-User-Id`	No	ID del usuario final (tracking)
`X-Participant-Id`	No	Fingerprint del visitante (anon)
`X-MCP-Tokens`	No	JSON con tokens MCP por server
`Authorization`	No	`Bearer <jwt>` (passthrough MCP)

Body

{
  "message": "¿Cuales son los horarios de atencion?",
  "conversationId": "conv_abc123",
  "agentId": "agent_uuid",
  "channel": "widget"
}

Campo	Tipo	Requerido	Descripcion
`message`	`string`	Si	El mensaje del usuario
`conversationId`	`string`	No	ID de conversacion existente para mantener contexto. Si se omite o expiro el session timeout, el backend crea una nueva
`agentId`	`string`	No	Override del agente. Si se omite, se usa el agente bindeado a la API key (o el default del tenant si no hay binding)
`agentType`	`string`	No	`'general'` por defecto
`channel`	`string`	No	`'platform' \| 'widget' \| 'sdk' \| 'studio' \| 'whatsapp' \| 'telegram' \| 'slack'`. Afecta filtrado en stats e inbox
`actionResponse`	`object`	No	Respuesta a una accion HITL pendiente (consent/confirm/select/form). Solo aplicable cuando se esta resumiendo un turno suspendido

Response

{
  "success": true,
  "data": {
    "message": "Nuestro horario de atencion es de lunes a viernes de 9am a 6pm.",
    "conversationId": "conv_abc123"
  }
}

Campo	Tipo	Descripcion
`success`	`boolean`	Si la peticion fue exitosa
`data.message`	`string`	La respuesta del agente
`data.conversationId`	`string`	ID de la conversacion (usar para mensajes siguientes)

Ejemplo con curl

curl -X POST https://api.thaliq.com/api/agent/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tq_live_xxx" \
  -d '{
    "message": "¿Cuales son los horarios de atencion?"
  }'

Ejemplo con JavaScript

const response = await fetch('https://api.thaliq.com/api/agent/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'tq_live_xxx',
  },
  body: JSON.stringify({
    message: '¿Cuales son los horarios de atencion?',
  }),
});

const data = await response.json();
console.log(data.data.message);
// → "Nuestro horario de atencion es de lunes a viernes de 9am a 6pm."

Continuando una conversacion

Usa el conversationId de la primera respuesta para mantener el contexto:

// Primer mensaje
const res1 = await fetch('https://api.thaliq.com/api/agent/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'tq_live_xxx',
  },
  body: JSON.stringify({ message: 'Hola, necesito ayuda' }),
});
const data1 = await res1.json();
const conversationId = data1.data.conversationId;

// Segundo mensaje (con contexto)
const res2 = await fetch('https://api.thaliq.com/api/agent/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'tq_live_xxx',
  },
  body: JSON.stringify({
    message: '¿Cuanto cuesta el plan Growth?',
    conversationId,
  }),
});