whatsapp_save_media

WhatsApp · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Saves the media of one WhatsApp message (a document such as PDF, DOCX or XLSX, an image, a video, or a voice note/audio) as a file in a local folder. chat_id and message_id come from whatsapp_read_messages or whatsapp_search_messages (a message whose `media` field is set). It never replaces a file: if the name is taken, it saves as «name (2).ext» and says so.

Required inputs

chat_id — Chat ID of the message, from whatsapp_read_messages
message_id — message_id of the message that carries the media, from whatsapp_read_messages

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "account": {
      "description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat ID of the message, from whatsapp_read_messages",
      "type": "string"
    },
    "destination": {
      "description": "Folder to save the file into. Defaults to the Downloads folder.",
      "type": "string"
    },
    "message_id": {
      "description": "message_id of the message that carries the media, from whatsapp_read_messages",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "message_id"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "chat_id": "12025550123@s.whatsapp.net",
  "message_id": "3EB0DEMO0002"
}

Windows