Manage scheduled messages
manage_scheduled_messagesSchedule WhatsApp messages to be sent automatically at a specific time, in one of two modes: bot (default) - sent from Kaption's WhatsApp number, not the user's own. Stored in Kaption's cloud and sent even when this computer is off. One-to-one chats only (no groups); one line, max 800 characters. local ("From this computer") - sent from the user's own WhatsApp number, as them, while this computer and WhatsApp are open. Stays on this device. Kaption keeps it within safe limits automatically (a few messages an hour and a day, minutes apart, only to chats where the other person has written, at most 3 a day to groups) and refuses what does not fit. The only mode that can send to groups (ones the user can post in and posted in within 30 days). Text only. A message whose time passes while this computer is off is missed, never sent late on its own. The local mode must first be turned on by the user in Kaption (its "From this computer" option, after reading the risks); an assistant cannot turn it on. A refused local request says why and ends with a reason code, e.g. "(reason: per-day)".
Actions: list - List scheduled messages of both modes (each has "mode"); pass mode to list only one get - Get a specific scheduled message by ID create - Schedule a new message (requires message + datetime + conversation_id) update - Change the message and/or datetime (requires id) delete - Cancel/delete a scheduled message (requires id); in local mode it cancels a waiting message and removes a finished one cancel - Local mode only: cancel a waiting, missed or failed message remove - Local mode only: remove a finished message from the list send_now - Local mode only: send a missed or failed message now (still within the limits) Pass mode "local" for every action on a local message.
Examples: List all: { action: "list" } Schedule (Kaption bot): { action: "create", message: "Hey, just following up!", datetime: "2026-03-07T09:00:00Z", conversation_id: "5491157390064@c.us" } Schedule from the user's own number: { action: "create", mode: "local", message: "Running 10 min late", datetime: "2026-03-07T09:00:00-03:00", conversation_id: "5491157390064@c.us" } Schedule to a group: { action: "create", mode: "local", message: "Standup moved to 10", datetime: "2026-03-07T09:00:00Z", conversation_id: "120363000000000000@g.us" } Cancel: { action: "delete", id: "msg_abc123" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Scheduled message ID (required for get/update/delete/cancel/remove/send_now) | |
| mode | No | "bot" (default): sent from Kaption's WhatsApp number. "local": sent from the user's own WhatsApp number while this computer and WhatsApp are open, within safe limits kept automatically; needed for groups. For list, omit to get both modes | |
| action | Yes | Scheduled message action to perform (cancel, remove and send_now need mode "local") | |
| filter | No | Filter for list action. Default: "pending" (not sent yet; in local mode also missed or failed ones waiting for the user) | |
| message | No | Message text to send (required for create, optional for update). Bot: one line, max 800 characters. Local: text only, up to 2000 characters | |
| datetime | No | ISO 8601 datetime when the message should be sent (required for create, optional for update) | |
| target_session | No | Session ID for multi-account routing | |
| conversation_id | No | Chat to send the message to (required for create): a person, or a group with mode "local" | |
| notification_type | No | Bot mode only. Notification type. Default: "automatic" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | The JSON-compatible result returned by the Kaption extension |