API Reference

POST /api/v2/agent/{agentId}/chat

{
  "query": "¿Cuáles son los horarios?",
  "conversationId": "conv_abc123",
  "visitorId": "user_456",
  "streaming": false,
  "contact": {
    "email": "cliente@ejemplo.com",
    "firstName": "Juan",
    "phoneNumber": "+5491123456789"
  }
}

{
  "answer": "Nuestros horarios son de 9 a 18 hs.",
  "conversationId": "conv_abc123",
  "messageId": "msg_xyz789",
  "sources": [
    {"source": "FAQ", "score": 0.95}
  ]
}

GET /api/v2/conversations

{
  "data": [
    {
      "id": "conv_abc123",
      "agentId": "agent_xyz",
      "status": "open",
      "messagesCount": 5,
      "contact": {"email": "cliente@ejemplo.com"},
      "createdAt": "2024-01-21T10:00:00Z"
    }
  ]
}

GET /api/v2/conversations/{conversationId}

GET /api/v2/conversations/{conversationId}/messages

PUT /api/v2/conversations/{conversationId}/status

{"status": "resolved"}

GET /api/v2/agents

GET /api/v2/agents/{agentId}

{
  "id": "agent_abc123",
  "name": "Agente de Ventas",
  "description": "Responde consultas de productos",
  "modelName": "gpt-4o",
  "tools": ["datastore", "lead-capture"],
  "status": "active"
}

POST /api/v2/agents

{
  "name": "Agente de Soporte",
  "systemPrompt": "Sos un agente de soporte...",
  "modelName": "gpt-4o",
  "tools": ["datastore", "request-human"]
}

PUT /api/v2/agents/{agentId}

GET /api/v2/datastores

POST /api/v2/datastores/{datastoreId}/query

{
  "query": "¿Cuáles son los horarios?",
  "topK": 5
}

{
  "results": [
    {
      "content": "Nuestros horarios son...",
      "score": 0.95,
      "source": {"name": "FAQ General"}
    }
  ]
}

POST /api/v2/datastores/{datastoreId}/sources/file

curl -X POST .../sources/file \
  -H "Authorization: Bearer API_KEY" \
  -F "file=@documento.pdf"

POST /api/v2/datastores/{datastoreId}/sources/url

{"url": "https://ejemplo.com/faq"}

POST /api/v2/datastores/{datastoreId}/sources/text

{
  "content": "Información a indexar...",
  "name": "Políticas de envío"
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key inválida"
  }
}

const response = await fetch('.../chat', {
  headers: {
    'Accept': 'text/event-stream',
  },
  body: JSON.stringify({
    query: 'Contame sobre tus productos',
    streaming: true
  }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  console.log(decoder.decode(value));
}