API para desarrolladores
Construye sobre BotDesk
Una API REST simple para conversar con tus bots, leer el historial, medir el uso y recibir eventos en tiempo real. Desde Zapier, Make o tu propio backend.
Empieza en 30 segundos
- 01
Genera tu API key
Desde el panel de BotDesk, en Ajustes → API. La clave identifica tu cuenta en cada request.
- 02
Autentica cada request
Envía la clave en el header X-API-Key. Todos los endpoints viven bajo /public/v1.
- 03
Envía tu primer mensaje
Un POST a /chat te devuelve la respuesta del bot, sus fuentes y las métricas de la consulta.
Request
curl https://api.yepbrain.com/v1/public/v1/chat \
-H "X-API-Key: $BOTDESK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "¿Cuál es el horario de atención?"}'Response
{
"conversation_id": "a3f1c2e0-...",
"response": "Atendemos de lunes a viernes de 9 a 18h.",
"sources": [{ "filename": "horarios.pdf", "score": 0.94 }],
"tokens_used": 312,
"latency_ms": 840
}