Schedule a WhatsApp status
manage_statusSchedule a post to the user's WhatsApp Status (stories) for a future date and time, or cancel a scheduled status post. The post is made later by the user's own WhatsApp on this computer; to post right now the user uses WhatsApp itself, so there is no post-now action. Only when status posts are turned on for the account; needs the "From this computer" scheduled mode and its consent in Kaption (an assistant cannot accept consent). A status is either text (max 700 characters) on a background colour (#RRGGBB) with a font (0-7), or one image (JPG/PNG/WebP) or MP4 video with an optional caption (max 1024). Images and videos need create_attachment_upload: call it with the file's name, mime and size, PUT the raw file bytes to its uploadUrl, then call manage_status schedule with attachment: { ref: attachmentRef } (one use, within an hour). The inline attachment { name, mime, dataB64 } is still accepted. Who sees it follows the user's WhatsApp status privacy setting. WhatsApp must be open on this computer at posting time: the Kaption bot and cloud templates cannot post statuses. datetime must be in the future. Each post counts as one scheduled item in the plan's scheduling quota, and the mode's limits (per hour, per day, pending) still apply; scheduling is not a delivery confirmation.
Reading status posts is list_status_posts.
Actions: schedule: { action: "schedule", datetime: "2026-10-27T09:00:00-03:00", text: "Open today 9-18", background_color: "#25D366", font: 2 } schedule (photo/video): create_attachment_upload { name: "menu.jpg", mime: "image/jpeg", size: 245760 }, PUT the bytes to its uploadUrl, then { action: "schedule", datetime: "2026-10-27T09:00:00-03:00", attachment: { ref: "" }, caption: "New menu" } cancel: { action: "cancel", id: "" }
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Status item ID (cancel) | |
| font | No | Text status font index 0-7 (default 0) | |
| text | No | Text status (max 700 characters). Omit when posting an attachment. | |
| action | Yes | schedule or cancel | |
| caption | No | Caption for an image or video status (max 1024 characters) | |
| datetime | No | ISO 8601 date-time in the future to post at (required for schedule) | |
| attachment | No | One image or MP4 video for a photo/video status: { ref } from create_attachment_upload (preferred), or inline { name, mime, dataB64 } | |
| target_session | No | Session ID for multi-account routing | |
| background_color | No | Text status background as #RRGGBB (default #7ACCA5) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | The JSON-compatible result returned by the Kaption extension |