App Logo
web.whatsapp.com

WhatsApp — Download media

Download the media of a WhatsApp message (image, document, audio/voice) by chat name + message id (the `id` from get_conversation / search_messages), returned as base64 plus filename, mimeType and size. Documents come back byte-for-byte — a file sent by send_message round-trips identically — and carry the filename WhatsApp itself saves them under. Images are read from the inline blob, which is WhatsApp's own rendition and may be smaller than a large original, so imageWidth/Height are reported rather than implying full fidelity. Audio/voice notes use the same path as documents but are unverified for lack of a fixture. Video, sticker, GIF and location messages are not supported: they are refused with their actual kind named, so check a message's `media` field from get_conversation if you are unsure what it holds.

Input

id required

WhatsApp message id - the data-id from send_media's messageId, or from get_conversation/search_messages. The message must be an image or a document/audio (voice note) message: video, sticker, GIF and location messages carry no supported file and are refused with their actual kind named. Check the message's `media` field from get_conversation first if you are unsure.

name required

Exact chat/contact/group name containing the message (the name field from get_inbox).

Output

size required

Byte size of the returned media.

base64 required
filename required
mimeType required
kind optional
imageWidth optional

Natural width of the rendition returned. For a large photo WhatsApp's inline blob can be smaller than the original upload.

imageHeight optional

FAQ

Download the media of a WhatsApp message (image, document, audio/voice) by chat name + message id (the `id` from get_conversation / search_messages), returned as base64 plus filename, mimeType and size. Documents come back byte-for-byte — a file sent by send_message round-trips identically — and carry the filename WhatsApp itself saves them under. Images are read from the inline blob, which is WhatsApp's own rendition and may be smaller than a large original, so imageWidth/Height are reported rather than implying full fidelity. Audio/voice notes use the same path as documents but are unverified for lack of a fixture. Video, sticker, GIF and location messages are not supported: they are refused with their actual kind named, so check a message's `media` field from get_conversation if you are unsure what it holds.
Required: name, id.
It returns kind, size, base64, filename, mimeType, imageWidth, imageHeight.
Yes. It acts as you on web.whatsapp.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the web.whatsapp.com cookies saved by the Reduck extension.
It only reads. It looks things up on web.whatsapp.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/web.whatsapp.com/download_media, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/web.whatsapp.com/download_media
It is part of Reduck's official curated catalogue.

Related scripts

web.whatsapp.com

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.

web.whatsapp.com

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.

web.whatsapp.com

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.

Start building not clicking

Get started for free