Skip to main content
POST
Chatea con un agente (headless)

Autorizaciones

Authorization
string
header
requerido

Una clave de API del espacio de trabajo: wdy_live_… / wdy_test_…. Se crea en POST /workspaces/{tenantId}/keys y se muestra exactamente una vez.

Parámetros de ruta

agentId
string
requerido

Cuerpo

application/json
message
string
requerido

La pregunta del visitante que responde el agente.

Required string length: 1 - 1000
locale
enum<string>
predeterminado:es
Opciones disponibles:
es,
en
conversationId
string

Continúa una conversación: pasa el conversationId que devolvió un turno anterior. Omítelo para iniciar una nueva; el servidor es dueño de la transcripción.

Respuesta

conversationId
string
requerido

La conversación, propiedad del servidor, en la que está este turno.

reply
string
requerido

La respuesta de texto del asistente.

components
object[]
requerido

Los componentes de generative-UI que el agente eligió renderizar.

cached
boolean
requerido

True cuando el turno se reprodujo desde la caché (no gastó crédito).