WhatsApp unofficial API: delete a message
TL;DR
About
Most people want this a minute after sending something to the wrong chat. Say you sent a client the wrong invoice PDF an hour ago. Your agent pulls the last 20 messages, finds that bubble and deletes it for everyone, so the client sees a deleted-message placeholder instead of the file. In a group where you are an admin, the same call removes a member's spam link. Everyone is only offered for about two days after sending, and an admin deleting someone else's message gets an extra warning that the author will see who did it. After the click, the run checks that the message no longer appears in the chat. For scope me it also waits 12 seconds and reloads, because a local delete can come back if it has not been saved yet. Deleting is permanent, so confirm with the user before using everyone.
Input
scope required"everyone" removes it for all participants: your own recent messages, or any member's message in a group you administer. "me" removes it from your own view only.
messageId requiredThe message's id, as get_conversation, get_inbox or send_message returns it.
Output
scope requireddeleted requiredTrue once the app shows the message deleted at that scope.
messageId requiredchatId optionalExample output
Shape only: placeholder values generated from the output schema, not a real run.
{
"scope": "…",
"chatId": "abc123",
"deleted": true,
"messageId": "abc123"
}FAQ
Get WhatsApp conversation
Read the most recent messages of one WhatsApp chat, oldest first. Give the chat by its `chatId` from get_inbox. Each message gives its id, type, sender (in groups), time, text or caption, whether it was deleted for everyone, the delivery status of your own messages, file details for media, and its reactions with counts. `complete` is true when the start of the chat's history was reached. Reading does not open the chat, so nothing is marked as read and the other person gets no read receipt. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab. If the browser is not linked to WhatsApp, the run stops and says so. An unknown chatId stops the run with an error.
Send WhatsApp message or attachment
Send a WhatsApp message to a chat, given by its `chatId` from get_inbox, or to a phone number in international format that has no chat yet. The message is a text, an image, a video or a document with an optional caption, or a saved contact's card. Returns the new message's id, which delete_message and react_to_message take, with the time, the delivery status and the account that sent it. The run succeeds only when WhatsApp's server has acknowledged the message, and fails if WhatsApp marks it as failed. With dry_run, the chat is opened and the message prepared, and nothing is sent. Confirm the recipient with the user before sending. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab.
Get WhatsApp inbox
List the chats of the WhatsApp chat list, in the order the list shows them, most recent first. Pick the same tab as the app: all chats, unread, favorites, groups, or archived. Each chat gives its id, its name, when it was last active, its unread count, whether it is pinned, muted, a favorite or marked unread by hand, and its last message with id, type, sender, time and text. `total` tells how many chats the tab holds, so a result cut by `count` is visible. Reading the list does not open a chat and marks nothing as read. If WhatsApp Web is open in another tab of the same browser, the run stops and asks to close that tab, because taking the session would disconnect it. If the browser is not linked to WhatsApp, the run stops and says so.