Configuración API
⬤ No conectado
Clínicas
—
Servicios
—
Eventos activos
—
Políticas
—
Seguros
—
🤖 RUBYBOT V5 — Conectado al Knowledge Module
El bot consume este módulo en cada conversación. El endpoint principal es/api/v1/knowledge/query y se activa después de "Parsear y Validar Intención" en n8n.
1. Webhook recibe mensaje
2. Gemini analiza intención
3. KM: Preparar Query
4. KM: Llamar API
5. KM: Formatear Contexto
6. Gemini genera respuesta
Últimos eventos activos
Conecta la API para ver eventos |
Clínicas activas
Conecta la API para ver clínicas |
Clínicas
| Nombre | Ciudad / Estado | Teléfono | ZIP | Estado | Acciones |
|---|---|---|---|---|---|
Cargando... | |||||
Servicios y Precios
| Nombre | Categoría | Precio | Duración | Cita req. | Acciones |
|---|---|---|---|---|---|
Cargando... | |||||
Eventos y Promociones
| Título | Tipo | Sede | Vigencia | Prioridad | Bot | Acciones |
|---|---|---|---|---|---|---|
Cargando... | ||||||
Políticas Rubymed
| Título | Categoría | Extracto | Acciones |
|---|---|---|---|
Cargando... | |||
Seguros Aceptados
| Nombre | Tipo de Plan | Notas | Acciones |
|---|---|---|---|
Cargando... | |||
Documentación de la API
Todos los endpoints requieren el header x-api-key: rubymed_secret_2025
GET
/api/v1/knowledge/query
Punto principal para el bot — devuelve clínicas, servicios, eventos, políticas y seguros filtrados por intención
GET
/api/v1/clinics
Lista todas las clínicas activas
GET
/api/v1/clinics/:id
Detalle de una clínica con servicios y eventos
GET
/api/v1/services?category=laboratorio&clinic_id=1
Lista servicios con filtro por categoría y sede
GET
/api/v1/events?type=promocion
Eventos activos (no expirados) con filtro por tipo
GET
/api/v1/policies
Políticas de Rubymed
GET
/api/v1/insurance
Seguros aceptados
POST
/api/v1/admin/events
Crear evento/promoción (admin)
POST
/api/v1/admin/clinics
Crear nueva clínica (admin)
Ejemplo de llamada desde n8n
GET /api/v1/knowledge/query?intent=consulta_precio&category=laboratorio&city=Houston&q=panel+metabolico
x-api-key: rubymed_secret_2025
Response:
{
"ok": true,
"data": {
"clinics": [ { "id": 1, "name": "Rubymed Houston North", ... } ],
"services": [ { "name": "Panel Metabólico Completo (CMP)", "price": 45, ... } ],
"events": [ { "title": "Laboratorios al 30% de descuento", ... } ],
"policies": [],
"insurance": []
}
}
Integración con RUBYBOT V5
Flujo de integración
1
Parsear y Validar Intención (existente)
↓
2
KM: Preparar Query NUEVO
↓
3
KM: Llamar API Knowledge NUEVO
↓
4
KM: Formatear Contexto NUEVO
↓
5
Gemini: Generar Respuesta (modificado)
Pasos para activar
- Instalar y correr la API en tu servidor
- Ejecutar
node seed.jspara cargar datos - Importar
rubymed-km-nodes.jsonen n8n - Crear credential Header Auth: name=
x-api-key - Conectar "KM: Preparar Query" después de "Parsear y Validar Intención"
- Actualizar el prompt de Gemini para incluir
km_context
Variable de entorno
RUBYMED_KM_URL=http://tu-servidor:3500
API_KEY=rubymed_secret_2025
DB_PATH=/data/rubymed_knowledge.db