App Logo
web.whatsapp.com

WhatsApp — Download media

Automatically download media on web.whatsapp.com. Download the file of one WhatsApp message (image, video, document, audio, voice note or sticker) to the computer running the browser, and return where it was saved: path (or url when the file is not on that computer), file name, type, size and, for images and videos, the width and height WhatsApp states. Give the message by its id from get_conversation; a bare key id also works with the chat's name. The file is checked byte for byte against WhatsApp's own fingerprint before it is saved. The chat is not opened, so nothing is marked as read. A message deleted for everyone, or one with no file (text, location), is refused with its kind named. If the browser is not linked to WhatsApp, or WhatsApp Web is open in another tab of the same browser, the run stops and says so.

Input

id required

The message id, as get_conversation returns it in `id` (false_<chat>_<key> or true_<chat>_<key>). A bare key id (the last part alone) also works when `name` is given.

name optional

The chat's name as get_inbox returns it. Needed only when `id` is a bare key id.

Default: ""

Output

kind required

WhatsApp's message type: image, video, document, audio, ptt (voice note) or sticker.

size required

Size of the saved file in bytes.

chatId required

The chat the message belongs to, as get_inbox returns it in `chatId`.

filename required

Name of the saved file. A document keeps the name it was sent with; it can carry a numbered suffix when a file of that name was already there.

mimeType required
messageId required
url optional

A link to the file, when it is not saved on the computer running the browser.

path optional

Where the file was saved on the computer running the browser.

imageWidth optional

Width WhatsApp states for an image, video or sticker; null otherwise.

imageHeight optional

FAQ

Download the file of one WhatsApp message (image, video, document, audio, voice note or sticker) to the computer running the browser, and return where it was saved: path (or url when the file is not on that computer), file name, type, size and, for images and videos, the width and height WhatsApp states. Give the message by its id from get_conversation; a bare key id also works with the chat's name. The file is checked byte for byte against WhatsApp's own fingerprint before it is saved. The chat is not opened, so nothing is marked as read. A message deleted for everyone, or one with no file (text, location), is refused with its kind named. If the browser is not linked to WhatsApp, or WhatsApp Web is open in another tab of the same browser, the run stops and says so.
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
You do not need one. "WhatsApp — Download media" drives the real web.whatsapp.com pages in a browser, so it works whether or not web.whatsapp.com offers an API for this.
Required: id. Optional: name.
It returns url, kind, path, size, chatId, filename, mimeType, messageId, 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

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.

web.whatsapp.com

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.

web.whatsapp.com

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.

Start building not clicking

Get started for free