> ## 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.

# WhatsApp

> Gestión de citas y preguntas frecuentes por WhatsApp: cómo MarIA atiende a los pacientes por mensajería

Además de las llamadas de voz, MarIA atiende conversaciones entrantes por **WhatsApp**. El paciente escribe al número del centro y el agente responde, gestiona citas y resuelve dudas frecuentes de la misma forma que lo haría por teléfono.

## Capacidades por WhatsApp

| Capacidad             | Descripción                                                                                       |
| --------------------- | ------------------------------------------------------------------------------------------------- |
| **Agendar cita**      | El paciente solicita cita, MarIA consulta el EHR y confirma en la misma conversación              |
| **Cancelar cita**     | El paciente indica qué cita cancelar; MarIA la cancela en el EHR                                  |
| **Modificar cita**    | Combina cancelación y nueva agenda en el hilo de conversación                                     |
| **FAQs de centros**   | Responde preguntas sobre horarios, ubicaciones, coberturas y especialidades                       |
| **Escalado a humano** | Si la situación lo requiere, MarIA transfiere el chat a un agente humano con el contexto completo |

## Notificaciones salientes

MarIA también puede enviar mensajes proactivos al paciente por WhatsApp:

* **Confirmación de cita**: inmediatamente después de agendar (por teléfono o por WhatsApp).
* **Recordatorio de cita**: 24-48h antes de la cita para reducir ausencias.

Ambas notificaciones se envían mediante plantillas aprobadas por Meta. Contacta con [soporte@omniloy.com](mailto:soporte@omniloy.com) para configurar o añadir plantillas.

## Flujo de conversación entrante

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

  P->>M: "Quiero pedir una cita con cardiología"
  M-->>P: "¿En qué centro prefieres?"
  P-->>M: Indica el centro
  M->>E: appointment.getBenefits / getSlots
  E-->>M: Disponibilidad
  M-->>P: Propone opciones de fecha y hora
  P-->>M: Confirma
  M->>E: appointment.create
  E-->>M: appointmentId confirmado
  M-->>P: Cita confirmada + confirmación por WhatsApp
```

## APIs de WhatsApp

La gestión de citas por WhatsApp usa los contratos API comunes de MarIA. Consulta [APIs: Eventos de webhooks](/maria/es/webhooks-eventos) y [APIs: Integraciones EHR](/maria/es/integraciones-ehr) para eventos y contratos aplicables.

## Base de conocimiento FAQ

Las preguntas frecuentes se responden usando los documentos indexados en `POST /faq/documents`. El mismo corpus de conocimiento se usa tanto en las llamadas de voz como en las conversaciones de WhatsApp. Mantén los documentos actualizados con información sobre centros, coberturas, horarios y especialidades.

## Firma HMAC en webhooks

Los webhooks de MarIA se firman con `HMAC-SHA256`. Cabecera `X-Integration-Signature: sha256=<hex>` calculada sobre el cuerpo RAW. Ver [Verificación de firmas HMAC](/maria/es/webhooks-firmas).