API abierta: integra VitalDesk con tu ERP, contabilidad o app personalizada

¿Por qué una API abierta para tu clínica?

Si tu clínica ya usa un sistema contable, un ERP o herramientas de Business Intelligence, probablemente estás duplicando datos manualmente: exportando planillas, copiando pagos, actualizando agendas en dos lugares. Eso se acabó.

Con la API de VitalDesk, tu software clínico se convierte en una fuente de datos conectada. Cualquier sistema externo puede leer información de pacientes, citas, pagos, tratamientos e inventario en tiempo real, de forma segura y automatizada.

¿Qué puedes hacer con la API?

1. Sincronizar pagos con tu sistema contable

Cada vez que se registra un pago en VitalDesk, tu ERP lo recibe automáticamente vía webhook. Adiós a las conciliaciones manuales de fin de mes.

2. Dashboards personalizados

Conecta Power BI, Metabase, Google Data Studio o cualquier herramienta de BI directamente a los endpoints de reportes. Obtén métricas de ingresos, ocupación de agenda y productividad por profesional actualizadas al minuto.

3. Automatizar flujos internos

¿Necesitas que al crear un paciente se genere una carpeta en Google Drive, se envíe un formulario de admisión o se notifique a un canal de Slack? Con webhooks puedes disparar cualquier automatización usando Zapier, Make o tu propia integración.

4. Integración con laboratorios y proveedores

Consulta inventario en tiempo real para sistemas de compras automatizadas. Cuando el stock de un insumo baja del mínimo, tu proveedor puede recibir una orden automáticamente.

Endpoints disponibles

Todos los endpoints son RESTful con respuestas JSON, paginación estándar y filtros avanzados:

• GET /external/patients — Listado de pacientes con búsqueda por nombre, RUT, email
• GET /external/appointments — Citas con filtros por fecha, profesional, estado
• GET /external/payments — Pagos con filtro por rango de fecha y método
• GET /external/treatments — Tratamientos con filtro por paciente y estado
• GET /external/inventory/items — Stock actual con alerta de bajo inventario
• GET /external/reports/summary — KPIs agregados: ingresos, citas, pacientes nuevos

Webhooks: eventos en tiempo real

En lugar de consultar la API periódicamente, configura webhooks para recibir notificaciones instantáneas cuando algo importante ocurre:

• appointment.created — Se creó una nueva cita
• appointment.cancelled — Se canceló una cita
• payment.received — Se registró un pago
• patient.created — Se registró un nuevo paciente
• treatment.completed — Se completó un tratamiento

Cada webhook incluye una firma HMAC-SHA256 en el header X-VitalDesk-Signature para que puedas verificar la autenticidad de cada notificación. Los reintentos automáticos (hasta 3 veces con backoff exponencial) garantizan que no se pierda ningún evento.

Seguridad de primer nivel

La API fue diseñada pensando en datos clínicos sensibles:

• API Keys con hash SHA-256 — Las claves nunca se almacenan en texto plano
• Scopes granulares — Cada key solo accede a los recursos que necesita (pacientes, citas, pagos...)
• Aislamiento por clínica — Una API key solo puede ver datos de su propia clínica, sin excepciones
• Rate limiting — 1,000 requests por minuto por key, con headers estándar X-RateLimit
• Expiración configurable — Define fecha de vencimiento para cada key

Ejemplo rápido

Obtener las citas del mes con un solo comando:

curl -H "X-API-Key: vd_live_tu_clave_aqui" \
  "https://tu-clinica.vitaldesk.cl/api/v1/external/appointments?date_from=2026-03-01&date_to=2026-03-31"

La respuesta incluye paginación, filtros aplicados y datos completos de cada cita con nombre de paciente y profesional.

¿Cómo empezar?

1. Activa el plan Enterprise — La API está disponible exclusivamente en este plan
2. Genera tu API Key — Desde Configuración > API y Webhooks, crea una key con los scopes que necesitas
3. Consulta la documentación — Swagger interactivo disponible en /api/docs
4. Configura webhooks — Define las URLs de callback y los eventos que quieres recibir
5. Integra — Usa cualquier lenguaje o herramienta que hable HTTP

¿Para quién es ideal?

La API Enterprise es especialmente útil para:

• Cadenas de clínicas que necesitan consolidar datos de múltiples sedes
• Clínicas con ERP propio que quieren evitar la doble digitación
• Equipos con área de TI que pueden construir integraciones personalizadas
• Clínicas que usan BI para tomar decisiones basadas en datos en tiempo real