Introducción a la API de MarIA

Visión general de la API de MarIA: canales soportados, arquitectura y punto de partida para la integración

Bienvenido a la API de MarIA. Este portal documenta todos los recursos necesarios para integrar el agente de voz de Omniloy en tu entorno hospitalario.

​

Qué incluye esta API

• Llamadas entrantes (Voice): MarIA atiende las llamadas de los pacientes, gestiona citas con el EHR y responde FAQs.
• WhatsApp: el paciente escribe al centro y MarIA gestiona citas y responde FAQs igual que por teléfono. También envía confirmaciones y recordatorios por plantilla.
• Centros y servicios: endpoints para consultar y gestionar los centros, servicios y coberturas configurados en MarIA.
• Base de conocimiento FAQ: gestión de documentos que alimentan al agente con información sobre tus centros y servicios.
• Llamadas salientes y cuestionarios: programación de llamadas outbound y cuestionarios de seguimiento mediante MarIA Core.
• Integración EHR/HIS mediante webhooks: MarIA ⇄ Hospital para beneficios, huecos y citas.
• Gestión de webhooks: registro y configuración de endpoints para recibir eventos de MarIA.

​

Flujo principal: llamada entrante

​

Entornos

Entorno	URL
Producción	https://{your-prod-endpoint}
Staging	https://{your-dev-endpoint}

Contacta con [e-mail] para obtener tus credenciales de API.

​

Autenticación

Todas las operaciones de la API usan X-Api-Key. Los webhooks de MarIA hacia tu sistema se firman con HMAC-SHA256. Consulta la guía de Autenticación para los detalles.

​

Especificación OpenAPI

La especificación completa en formato OpenAPI está disponible en la sección Referencia de API de esta documentación.