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 the merchant's 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 the merchant's 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-off or recurring (daily, weekly or monthly). It can be plain text or run an agent action when sent (with `action`): sales summary, today's transactions, pending links, BaaS balances, etc. If the reminder is meant to send a payment or charge link, it ALWAYS reaches the WhatsApp of the merchant who requested it, never 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 number, it must be saved first with tilopay_save_contact. Maximum 20 active reminders. The message is sent with a fixed prefix identifying the merchant. Times are in the merchant's local time (based on their WhatsApp phone's country).

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-09-14 · Owner: equipo-integraciones

View as raw Markdown