Recordatorios

Irreversible

Qué 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.

Herramientas#

Crear recordatorio

Escritura

tilopay_create_reminder

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

Sólo lectura

tilopay_list_reminders

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

Sensible

tilopay_cancel_reminder

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.

Última verificación: 2026-09-14 · Responsable: equipo-integraciones

Ver como Markdown crudo