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

# WhatsApp

> Envía y recibe mensajes de WhatsApp con pacientes y empresas desde NADIA, usa plantillas aprobadas y gestiona conversaciones en tiempo real.

El módulo de WhatsApp te permite comunicarte con pacientes y empresas directamente desde NADIA, sin necesidad de salir del sistema. Los mensajes se sincronizan en tiempo real.

## Acceso

Todos los usuarios.

## Lista de conversaciones

En la columna izquierda verás todas las conversaciones activas, ordenadas por actividad más reciente. Cada conversación muestra el nombre del paciente vinculado (si existe) o el nombre del contacto de WhatsApp como alternativa. Usa la barra de búsqueda en la parte superior para encontrar una conversación por nombre. Haz clic en una conversación para abrirla en el panel de chat.

## Nueva conversación

Haz clic en el botón **"Nueva conversación"** (icono de lápiz/redactar) en la parte superior de la lista de conversaciones. Se abrirá un diálogo donde puedes buscar un paciente por nombre para iniciar el contacto.

## Enviar mensajes

### Mensaje libre

Escribe en la caja de texto en la parte inferior del chat y pulsa **Enter** o el botón de enviar.

### Plantillas de WhatsApp

Cuando la ventana de servicio está cerrada, el campo de texto aparece bloqueado y verás el botón **"Enviar plantilla"**. Las plantillas son mensajes predefinidos y aprobados por WhatsApp.

## Plantillas disponibles

NADIA tiene 11 plantillas activas organizadas en tres categorías. Algunas se envían automáticamente en respuesta a acciones del sistema; otras se disparan manualmente desde el selector de plantillas.

### General

| Plantilla           | Variables       | Disparador                     |
| ------------------- | --------------- | ------------------------------ |
| `notificacion_base` | `{{1}}` Mensaje | Manual desde ficha de paciente |

### Citas

| Plantilla                       | Variables                                                  | Disparador                              |
| ------------------------------- | ---------------------------------------------------------- | --------------------------------------- |
| `respuesta_disponibilidad_cita` | `{{1}}` Nombre, `{{2}}` Fecha y hora                       | Manual (selector de plantillas)         |
| `respuesta_confirmacion_cita`   | `{{1}}` Nombre, `{{2}}` Tratamientos, `{{3}}` Fecha y hora | Automático al crear cita                |
| `mensaje_cancelacion_cita`      | `{{1}}` Nombre, `{{2}}` Tratamientos, `{{3}}` Fecha        | Automático al cancelar cita             |
| `mensaje_recordatorio_cita`     | `{{1}}` Nombre, `{{2}}` Hora, `{{3}}` Tratamientos         | Cron job (24h antes de la cita)         |
| `mensaje_seguimiento_cita`      | `{{1}}` Nombre                                             | Cron job (15 días después de la sesión) |

### Bonos

| Plantilla                     | Variables                                                                                       | Disparador                             |
| ----------------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------- |
| `mensaje_compra_bono`         | `{{1}}` Nombre, `{{2}}` Nombre del bono, `{{3}}` Sesiones, `{{4}}` Fecha de caducidad           | Automático al asociar paciente a bono  |
| `mensaje_uso_bono`            | `{{1}}` Nombre, `{{2}}` Nombre del bono, `{{3}}` Sesiones restantes, `{{4}}` Fecha de caducidad | Automático al registrar pago/redención |
| `recordatorio_caducidad_bono` | `{{1}}` Nombre, `{{2}}` Sesiones restantes, `{{3}}` Fecha de caducidad                          | Cron job (próxima caducidad)           |

### Facturación

| Plantilla                      | Variables                                                              | Disparador                             |
| ------------------------------ | ---------------------------------------------------------------------- | -------------------------------------- |
| `recordatorio_pago_factura`    | `{{1}}` Nombre empresa, `{{2}}` Concepto, `{{3}}` Fecha de vencimiento | Automático al emitir factura a empresa |
| `recordatorio_factura_vencida` | `{{1}}` Nombre empresa, `{{2}}` Concepto, `{{3}}` Fecha de vencimiento | Cron job (facturas vencidas)           |

## La ventana de servicio de 24 horas

<Warning>
  WhatsApp Business solo permite enviar **mensajes libres** dentro de las **24 horas siguientes al último mensaje recibido** del contacto.

  Si han pasado más de 24 horas, el campo de texto aparece bloqueado y solo podrás usar **plantillas aprobadas** haciendo clic en **"Enviar plantilla"**. Una vez que el contacto te responda, la ventana de 24 horas se reinicia.
</Warning>

## Vincular conversación a paciente o empresa

Cada conversación de WhatsApp puede vincularse a un **paciente** o a una **empresa** de NADIA. Al vincular, el nombre del paciente o empresa aparece en la lista de conversaciones y en la cabecera del chat. Solo puede estar vinculada a uno de los dos a la vez.

## Navegar al perfil del contacto

En la cabecera del chat verás el nombre del contacto con un enlace. Haz clic en él para ir directamente a la ficha del paciente o de la empresa en NADIA.

## Tiempo real

Las conversaciones se actualizan automáticamente cuando llega un mensaje nuevo. No necesitas recargar la página.