# Recordatorios de citas

> Recordatorios de citas

Source: https://docs.plazbot.com/kb/recordatorios-de-citas

Los recordatorios envían avisos automáticos por WhatsApp para cada cita o evento: antes, para que tu cliente no falte, y después, por ejemplo para pedirle su opinión con una encuesta.

[Watch the video on YouTube](https://www.youtube.com/watch?v=Fgxy0QNUBVE)

## 1\. Crear un pool

Un **pool** agrupa los recordatorios de un mismo tipo de cita.

1. Ve a **Agentes → Recordatorios** y presiona **Crear Recordatorio**.
2. Escribe el **Nombre**, por ejemplo «Recordatorios Clínica».
3. Elige el **Origen de eventos**:

Origen

De dónde salen las citas

**Manual**

Citas que creas a mano

**Agente de IA**

Citas que agenda un agente de IA (elige cuál)

**Automatización**

Citas creadas por automatizaciones (nodo Agente IA con Google Calendar o acción Crear evento); eliges una o todas

**API Externa**

Citas que llegan por API desde tu sistema de reservas

4. Deja **Habilitado** encendido.

## 2\. Agregar recordatorios

Presiona **Agregar recordatorio** por cada aviso que quieras enviar.

- **Momento del envío**: **Antes del evento** (en minutos u horas) o **Después del evento** (en horas o días, contados desde el fin del evento).
- **Tipo de acción**:
  - **Plantilla WhatsApp**: elige una plantilla aprobada y asigna sus **Variables de la plantilla**. Cada variable puede ser **Texto fijo**, **Sistema** (Nombre del contacto, Fecha del evento, Título del evento…), **Variable del evento** (un code enviado al crear el evento) o **Variable del contacto**. Con **Etiquetas al enviar**, el contacto recibe esas etiquetas cuando se envía el recordatorio.
  - **Encuesta de satisfacción**: elige la encuesta. Debe estar activa y con disparador «Pool» o «Ambos» (Configuración → Encuesta de Satisfacción).

Ejemplo: **24 horas antes** con la plantilla `recordatorio_cita` ({{1}} = Nombre del contacto, {{2}} = Fecha del evento) y **2 horas después** con una encuesta.

Presiona **Crear pool**. En la lista verás su origen, los recordatorios («24h antes, 2h después (encuesta)») y su estado.

## 3\. Crear las citas por API

Si el origen es **API Externa**, vuelve a abrir el pool: verás su **API Key** y la **Documentación API** con los endpoints:

Método

Endpoint

Qué hace

POST

`/api/reminders/{poolId}/events`

Crear evento (crea el contacto si no existe)

POST

`/api/reminders/{poolId}/events/bulk`

Crear hasta 100 eventos en un request

PUT

`/api/reminders/{poolId}/events/{eventId}`

Actualizar evento

DELETE

`/api/reminders/{poolId}/events/{eventId}`

Eliminar evento y cancelar sus recordatorios

GET

`/api/reminders/{poolId}/events`

Listar eventos

Todos usan el header `x-api-key` con la API Key del pool. Las fechas se interpretan en la zona horaria del workspace; el campo `variables` (`{ code, val }`) queda disponible como **Variable del evento** en la plantilla.

```bash
curl -X POST "https://api.plazbot.com/api/reminders/{poolId}/events" \
  -H "Content-Type: application/json" \
  -H "x-api-key: {apiKey}" \
  -d '{
    "contactPhone": "+573001234567",
    "contactName": "Juan Pérez",
    "title": "Cita odontológica",
    "startDate": "2026-03-15T10:00:00",
    "endDate": "2026-03-15T10:30:00"
  }'
```