API y SDK

Envía tu primer mensaje por API

Invoca un agente publicado mediante una petición HTTP y procesa su respuesta.

Actualizado 3 de agosto de 2026 · 8 min

Comprueba el agente

Puedes consultar el nombre y las capacidades del canal antes de invocarlo:

curl https://api.inceptiva.com/v1/agents/AGENT_ID \
  -H "Authorization: Bearer $INCEPTIVA_API_KEY"

Crea una respuesta

curl -X POST https://api.inceptiva.com/v1/agents/AGENT_ID/responses \
  -H "Authorization: Bearer $INCEPTIVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "¿Qué servicios ofrece Inceptiva?",
    "conversation_id": null,
    "metadata": {"source": "help-center"}
  }'

message es obligatorio y admite hasta 10.000 caracteres. conversation_id, external_reference y metadata son opcionales.

Procesa el resultado

La respuesta contiene:

{
  "conversation_id": "uuid",
  "response": "Respuesta del agente",
  "citations": []
}

Guarda conversation_id si necesitas continuar el diálogo. Las citas solo aparecen cuando el canal y el conocimiento utilizado permiten exponerlas.