Endpoints públicos y de plataforma de Guren AI: chat de Ana, ingreso de leads, agenda, diagnóstico APA, validación de SQL, integraciones, Laura y David, con autenticación, errores y límites.
Actualizado el
La API de Guren AI tiene dos partes: la API del sitio, que usa guren.cl (chat, leads, agenda, voz), y la API de plataforma bajo /api/v1, que atiende los avisos de los proveedores, las integraciones de cada cliente y las funciones de Laura y David.
Envía un mensaje a Ana con el historial y recibe su respuesta y la etapa. Solo acepta solicitudes desde el propio sitio y tiene límites por minuto y por día.
GET|POST /api/voice/session
Entrega la configuración de una sesión de voz de demostración (máximo 3 minutos, con límite por IP).
POST /api/lead
Ingresa un lead del formulario de contacto y lo envía al destino configurado.
GET /api/booking/availability?date=AAAA-MM-DD
Horarios libres de un día, en hora de Santiago.
POST /api/booking
Crea una reunión con Google Meet. Rechaza horarios pasados o a menos de 15 minutos.
POST /api/event
Analítica propia del sitio, sin cookies. Responde siempre 204.
Ana es sin estado en el chat web: quien llama mantiene el historial y lo envía en cada turno. El historial se sanea antes de usarse (ver saneamiento).
POST /api/ana/chat
curl -X POST https://guren.cl/api/ana/chat \
-H "Content-Type: application/json" \
-d '{
"message": "¿Pueden atender llamadas fuera de horario?",
"history": [
{ "role": "user", "content": "Hola, tengo una clínica dental" },
{ "role": "assistant", "content": "¡Hola! ¿Qué te gustaría resolver en la clínica?" }
]
}'
respuesta 200
{
"ok": true,
"role": "assistant",
"name": "Ana",
"tenant": "guren-corp",
"company": "Guren AI",
"content": "Sí, podemos ayudar a que tu clínica dental atienda consultas 24/7. Por ejemplo, si un paciente llama a las 10 de la noche, la llamada se atiende y la hora queda agendada para el día siguiente.\n\n¿Cuántas llamadas diarias recibes aproximadamente?",
"thought": "…",
"stage": "BOOKING",
"context": { "industry": "isMedical", "pain": "operational_efficiency" }
}
Campo
Descripción
content
La respuesta de Ana, ya revisada por los guardrails de salida.
stage
DISCOVERY, SOLUTION_MAPPING, QUALIFICATION o BOOKING.
context
Lo que Ana ya sabe de la conversación (rubro, canal de leads, volumen, dolor, CRM), en etiquetas canónicas.
thought
Nota interna de diagnóstico. No la muestres al visitante.
name, email y company son obligatorios; si faltan o el correo no es válido, responde 400. Para integrar leads de tus sistemas en una implementación, usa el ingreso firmado.
curl -X POST https://guren.cl/api/v1/david/demo/validate \
-H "Content-Type: application/json" \
-d '{"sql": "SELECT SUM(p.payment_value) FROM olist_orders o JOIN olist_order_items i ON o.order_id = i.order_id JOIN olist_order_payments p ON o.order_id = p.order_id LIMIT 10"}'
respuesta 422
{
"ok": false,
"status": "BLOCKED",
"issues": [
{
"code": "UNSAFE_MULTI_JOIN_DUPLICATION",
"message": "Agregar olist_order_payments cruzando olist_order_items (relación 1:N) duplica filas en silencio. Agrega cada hecho por separado (CTE) y luego une."
}
],
"schema": "olist-demo"
}
Una consulta segura responde 200 con "status": "APPROVED". Los códigos de bloqueo están en Consultas seguras.