App Logo
web.whatsapp.com

WhatsApp — Delete message

Delete a specific message (by messageId) in a chat, for yourself or for everyone. "everyone" works on your own recent messages within WhatsApp's ~2-day window, or — if you're a group admin — on any other member's message in that group too; fails loudly if the option isn't offered. Verifies the message was actually removed (not just an optimistic UI change) before returning. Deletion, especially scope:"everyone", is irreversible and visible to other participants (an admin deleting someone else's message even shows them "You deleted this message as admin"). Calling agents should get explicit user confirmation before invoking this with scope:"everyone", and before deleting any message the calling user did not author themselves.

Input

name required

Exact 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 required

Message 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 required
deleted required
messageId required
recipient required

Start building not clicking