# Recordatorios

> Herramientas del MCP para crear, ver y cancelar recordatorios por WhatsApp, con o sin una acción del agente al enviarse.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-09-14
- url: https://www.tilopay.com/developers/agentes/mcp/recordatorios

## Qué cubre [#que-cubre]

Un recordatorio es un mensaje de WhatsApp programado: una sola vez, diario, semanal o mensual. Puede
ser sólo texto o traer una **acción** que el agente ejecuta al enviarlo, escrita en lenguaje natural
("dame el resumen de ventas de hoy", "listá los enlaces de pago sin cobrar"), y el resultado se
adjunta al mensaje.

Reglas que conviene tener claras:

- Las horas son la hora local del comercio, según el país de su teléfono de WhatsApp.
- Hay un máximo de 20 recordatorios activos.
- Los recordatorios de enlaces de pago o de cobros **siempre** llegan al WhatsApp del comercio,
  nunca al cliente.
- Para enviar a otro número, primero hay que guardarlo como
  [contacto](/developers/agentes/mcp/contactos).

## Herramientas [#herramientas]

### Crear recordatorio [#tilopay-create-reminder]

- `tilopay_create_reminder`
- Acceso: Escritura

Crea un recordatorio por WhatsApp, de una sola vez o recurrente (diario, semanal o mensual). Puede ser solo texto o ejecutar una acción del agente al enviarse (con `action`): resumen de ventas, transacciones del día, enlaces pendientes, saldos BaaS, etc. Si el recordatorio es para enviar un enlace de pago o cobro, SIEMPRE llega al WhatsApp del comercio que lo pidió, nunca al cliente. En los demás casos se envía al WhatsApp del comercio o a un contacto ya guardado (contact_name); si el usuario da un teléfono nuevo, hay que guardarlo primero con tilopay_save_contact. Máximo 20 recordatorios activos. El mensaje sale con un prefijo fijo que identifica al comercio. Horas en la hora local del comercio (según el país de su teléfono de WhatsApp).

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `message` | string | sí | Texto del recordatorio (máx. 500 caracteres, sin HTML) |
| `action` | string | — | Instrucción que el agente ejecutará al enviarlo, en lenguaje natural, ej. 'dame el resumen de ventas de hoy' o 'lista los enlaces de pago pendientes'. El resultado se adjunta al mensaje. Omítelo si es un recordatorio de solo texto. |
| `schedule` | string (once | daily | weekly | monthly) | sí | Frecuencia: once = una sola vez |
| `when` | string | — | Solo para once: fecha y hora local 'YYYY-MM-DD HH:mm' |
| `time_of_day` | string | — | Para recurrentes: hora local 'HH:mm' |
| `weekday` | integer | — | Para weekly: 0 = domingo ... 6 = sábado |
| `day_of_month` | integer | — | Para monthly: día del mes (1-28) |
| `contact_name` | string | — | Nombre de un contacto ya guardado (mcp_contact) que debe recibirlo. Si se omite, llega al WhatsApp del comercio. No se aceptan teléfonos nuevos: guárdelos primero con tilopay_save_contact. |

**Devuelve**

`{ id, message, action, phone, contact_name, schedule, when, next_run_local, is_active }`

El recordatorio creado: cuándo se envía en la hora local del comercio, a qué número, y qué acción del agente se ejecuta al enviarse. Máximo 20 recordatorios activos; los de enlaces de cobro siempre llegan al WhatsApp del comercio, nunca al cliente.

### Ver recordatorios [#tilopay-list-reminders]

- `tilopay_list_reminders`
- Acceso: Sólo lectura

Lista los recordatorios activos del comercio con su próxima fecha de envío.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `include_inactive` | boolean | — | true para incluir los ya enviados o cancelados |

**Devuelve**

`{ reminders[] }`

reminders = recordatorios del comercio con su mensaje, frecuencia, próxima ejecución en hora local y si están activos.

### Cancelar recordatorio [#tilopay-cancel-reminder]

- `tilopay_cancel_reminder`
- Acceso: Sensible

Cancela un recordatorio por su ID o buscando parte de su texto. No borra el historial, solo deja de enviarse.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | string | — | ID del recordatorio |
| `search` | string | — | Parte del texto del recordatorio |

**Devuelve**

`{ cancelled }`

cancelled = el recordatorio que quedó desactivado.