App Logo
web.whatsapp.com

Download a WhatsApp voice note

Automatically download a WhatsApp voice note on web.whatsapp.com. Download one WhatsApp voice note, or audio message, to a file on the computer running the browser, and return where it was saved. Give the message by its id from get_conversation, where a voice note has the type ptt and an audio file the type audio. Returns the file's path and name, its audio format, size and duration, the chat it belongs to and when it was sent. The file is checked byte for byte against WhatsApp's own fingerprint of it before it is saved. The note is not played and the chat is not opened, so the sender does not see it as played and nothing is marked as read. Any other kind of message is refused with its kind named: images and documents go through download_media. 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

messageId required

The voice note's message id, as get_conversation returns it in `id` (also get_inbox's lastMessage.id and search_messages' ids), e.g. false_<chat>_<key>. The message must be a voice note (type ptt) or an audio message (type audio); any other type is refused with its kind named.

Output

size required

Size of the saved file in bytes.

type required

ptt for a voice note recorded in WhatsApp, audio for an audio file sent as a message.

chatId required

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

filename required

Name of the saved file. It can carry a numbered suffix when a file of that name was already there.

mimeType required

Audio format as WhatsApp gives it, e.g. audio/ogg; codecs=opus.

messageId required
at optional

When it was sent, ISO datetime.

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.

fromMe optional
durationSeconds optional

Length of the recording, as WhatsApp states it.

FAQ

Download one WhatsApp voice note, or audio message, to a file on the computer running the browser, and return where it was saved. Give the message by its id from get_conversation, where a voice note has the type ptt and an audio file the type audio. Returns the file's path and name, its audio format, size and duration, the chat it belongs to and when it was sent. The file is checked byte for byte against WhatsApp's own fingerprint of it before it is saved. The note is not played and the chat is not opened, so the sender does not see it as played and nothing is marked as read. Any other kind of message is refused with its kind named: images and documents go through download_media. 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_voice_note, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/web.whatsapp.com/download_voice_note
You do not need one. "Download a WhatsApp voice note" 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: messageId.
It returns at, url, path, size, type, chatId, fromMe, filename, mimeType, messageId, durationSeconds.
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_voice_note, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/web.whatsapp.com/download_voice_note
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