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 minComprueba 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.