> ## Documentation Index
> Fetch the complete documentation index at: https://omniloy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```mermaid theme={null}
sequenceDiagram
  autonumber
  participant P as Paciente
  participant M as MarIA (Voice)
  participant E as EHR/HIS

  P->>M: Llama al número del centro
  M-->>P: Saluda e identifica necesidad
  alt Gestión de cita
    M->>E: appointment.getBenefits / getSlots
    E-->>M: Catálogo y disponibilidad
    M-->>P: Propone opciones
    P-->>M: Confirma fecha y hora
    M->>E: appointment.create
    E-->>M: appointmentId confirmado
    M-->>P: Confirma la cita
    M-->>P: Envía confirmación por WhatsApp (opcional)
  else FAQ
    M-->>P: Responde con información del centro/servicio
  end
```

## Entornos

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

Contacta con [soporte@omniloy.com](mailto:soporte@omniloy.com) 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](/maria/es/auth) 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.