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
name requiredExact chat/contact/group name containing the message, as WhatsApp lists it in the chat list (an unsaved contact is titled by phone number).
scope required"everyone" works on your own messages within WhatsApp's ~2-day window, or (if you're a group admin) on any other member's message in that group; throws if not offered. "me" removes it from your view only.
messageId requiredMessage id (the id/data-id from get_conversation or search_messages; a short-form id without the fromMe_chatId_ prefix is also accepted).
Output
scope requireddeleted requiredmessageId requiredrecipient requiredExample output
Shape only: placeholder values generated from the output schema, not a real run.
{
"scope": "…",
"deleted": true,
"messageId": "abc123",
"recipient": "…"
}FAQ
Get WhatsApp 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.
Send WhatsApp 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.
Get WhatsApp 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.