Reminders

Destructive

What it covers#

A reminder is a scheduled WhatsApp message: one-off, daily, weekly or monthly. It can be plain text or carry an action the agent runs when it fires, written in natural language ("give me today's sales summary", "list the pending payment links"), and the result is attached to the message.

Rules worth knowing:

Times are your local time, based on the country of their WhatsApp number.
There is a maximum of 20 active reminders.
Reminders about payment links or charges always go to your WhatsApp, never to the customer.
To send to another number, save it first as a contact.

Tools#

Create reminder

Write

tilopay_create_reminder

Creates a WhatsApp reminder, one-time or recurring (daily, weekly or monthly). It can be text only or run an agent action when sent (with `action`): sales summary, the day's transactions, pending links, etc. It does NOT create banking reminders (balance, movements, statements, transfers): the merchant configures those in the calendar of the Banca Cliente portal. If the reminder is to send a payment link or charge, it ALWAYS goes to the WhatsApp of the merchant who asked for it, never to the customer. In other cases it is sent to the merchant's WhatsApp or to an already saved contact (contact_name); if the user gives a new phone, it must first be saved with tilopay_save_contact. Maximum 20 active reminders. The message goes out with a fixed prefix that identifies the merchant. Times in the merchant's local time (according to the country of their WhatsApp phone).

Parameters

Parameter	Type	Required	Description
`message`	string	yes	Reminder text (max. 500 characters, no HTML)
`action`	string	—	Instruction the agent will run when sending it, in natural language, e.g. 'give me today's sales summary' or 'list pending payment links'. The result is attached to the message. Omit it for a plain-text reminder.
`schedule`	string (once \| daily \| weekly \| monthly)	yes	Frequency: once = one time only
`when`	string	—	Only for once: local date and time 'YYYY-MM-DD HH:mm'
`time_of_day`	string	—	For recurring ones: local time 'HH:mm'
`weekday`	integer	—	For weekly: 0 = Sunday ... 6 = Saturday
`day_of_month`	integer	—	For monthly: day of the month (1-28)
`contact_name`	string	—	Name of an already saved contact (mcp_contact) who should receive it. If omitted, it reaches the merchant's WhatsApp. New phone numbers are not accepted: save them first with tilopay_save_contact.

Returns

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

The created reminder: when it is sent in the merchant's local time, to which number, and what agent action runs when it is sent. Maximum 20 active reminders; charge-link ones always reach the merchant's WhatsApp, never the customer's.

View reminders

Read only

tilopay_list_reminders

Lists the merchant's active reminders with their next send date.

Parameters

Parameter	Type	Required	Description
`include_inactive`	boolean	—	true to include those already sent or cancelled

Returns

{ reminders[] }

reminders = the merchant's reminders with their message, frequency, next run in local time and whether they are active.

Cancel reminder

Sensitive

tilopay_cancel_reminder

Cancels a reminder by its ID or by searching part of its text. It does not delete the history, it just stops being sent.

Parameters

Parameter	Type	Required	Description
`id`	string	—	Reminder ID
`search`	string	—	Part of the reminder's text

Returns

{ cancelled }

cancelled = the reminder that was deactivated.

Last verified: 2026-10-07 · Owner: equipo-integraciones

View as raw Markdown