WhatsApp — Clear chat
Input
name requiredExact chat/contact/group name to clear (from get_inbox).
keepStarred optionalKeep starred messages instead of clearing them too. With this set the chat does not end up empty, so the emptiness verification is skipped for that branch.
Default: falseOutput
cleared requiredrecipient requiredverified_empty optionalTrue when the chat was re-read after clearing and held no message rows. Null when keepStarred was set, since the chat legitimately keeps its starred messages.
messages_before optionalMessage rows present before clearing, as evidence the chat was non-empty and the clear actually did something.
FAQ
WhatsApp — Get conversation
Open a WhatsApp chat by its exact name (as returned by get_inbox) and return its messages in chronological order: sender, direction (sent/received), time, date, text and media type. `count` = how many recent messages to load (scrolls up for older). A message that was deleted for everyone is still returned, flagged with `deleted: true` and carrying no text, so it is never mistaken for a message that could not be read.
WhatsApp — Send message or attachment
Send a WhatsApp message to a chat picked either by its exact name (as returned by get_inbox) or by phone number in international format, which needs no saved contact. The message is either text, an attached image, video or document with an optional caption, or a saved contact's card. Confirms the send by inspecting the conversation afterwards — a delivery tick for text, a cleared upload for an attachment, the contact's own bubble for a card — and throws if WhatsApp flagged it as failed or left it stuck, rather than trusting the bubble appearing. Returns the message id, the account that sent it, and whether identical text was already in the conversation beforehand. Attachment bytes must be supplied inline, since they cannot be fetched from a URL at run time.
WhatsApp — Get inbox
List the WhatsApp chat list (inbox): for each chat its name, date/time label, read/unread status, unread message count and last-message snippet. Ordered top→down (most recent first). `count` caps how many chats to return.