Alerts and notifications
WriteWhat it covers#
The agent can notify the merchant over WhatsApp when a charge comes in, when a charge is declined, when an order arrives, and send a daily summary at the chosen time. These two tools read and change those settings.
They do not send messages on their own: they only turn alerts on and off and report the current settings. Fields that are not sent are preserved.
Tools#
View notification settings
Read onlytilopay_get_notification_settings
Shows how the merchant's notifications are configured: whether payments received are notified over WhatsApp and/or email, which email, from which amount and whether there is a quiet-hours window.
Parameters
No parameters.
Returns
{ settings }
settings = the merchant's notification configuration: which WhatsApp notifications are on (approved charges, failed charges, daily summary, orders) and what time the daily summary is sent.
Configure the merchant's notifications
Writetilopay_set_notification_settings
Changes the merchant's notification settings: turn on or off the payment-received notification over WhatsApp and email, the destination email, the minimum amount to notify and the quiet-hours window (in the merchant's local time). Only send the fields the user asked to change.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
payment_whatsapp | boolean | — | Notify over WhatsApp when a payment is received |
payment_email | boolean | — | Notify over email when a payment is received |
notify_email | string | — | Email that receives the notifications (if omitted, the account's) |
min_amount | number | — | Minimum amount to notify (0 = notify for any amount) |
quiet_from | string | — | Local time when the quiet window starts (null to remove it) |
quiet_to | string | — | Local time when the quiet window ends (null to remove it) |
Returns
{ settings }
settings = the already updated notification configuration. Fields that are not sent are kept.
Last verified: 2026-09-14 · Owner: equipo-integraciones