Skip to main content
POST
/
api
/
forms
/
{formId}
/
chat
curl -X POST https://app.horneross.com/api/forms/form_abc123/chat \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Me llamo María García",
    "conversationId": "conv_form_123",
    "streaming": false
  }'

{
  "answer": "¡Perfecto María! Ahora necesito tu email para poder contactarte.",
  "currentField": "email",
  "filledFields": {
    "name": "María García"
  },
  "progress": {
    "current": 2,
    "total": 4,
    "percentage": 25
  },
  "conversationId": "conv_form_123"
}

​
Endpoint

POST /api/forms/{formId}/chat
Este endpoint permite que un agente de IA guíe al usuario campo por campo.

​
Path Parameters

​
formId
string
required
ID del formulario

​
Request Body

​
query
string
required
Respuesta del usuario al agente
​
conversationId
string
required
ID de la conversación del formulario. Usá el mismo ID para mantener el contexto.
​
streaming
boolean
default:"false"
Si es true, la respuesta se envía token por token via SSE
​
draft
boolean
default:"false"
Usar configuración draft del formulario en lugar de la publicada
curl -X POST https://app.horneross.com/api/forms/form_abc123/chat \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Me llamo María García",
    "conversationId": "conv_form_123",
    "streaming": false
  }'

​
Response

​
answer
string
required
Respuesta del agente al usuario
​
conversationId
string
required
ID de la conversación
​
currentField
string
Campo que se está completando actualmente
​
filledFields
object
Campos ya completados con sus valores
​
progress
object
Progreso del formulario
{
  "answer": "¡Perfecto María! Ahora necesito tu email para poder contactarte.",
  "currentField": "email",
  "filledFields": {
    "name": "María García"
  },
  "progress": {
    "current": 2,
    "total": 4,
    "percentage": 25
  },
  "conversationId": "conv_form_123"
}