whatsapp_save_media

WhatsApp · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Guarda el contenido multimedia de un mensaje de WhatsApp (un documento como PDF, DOCX o XLSX, una imagen, un video o una nota de voz/audio) como un archivo en una carpeta local. chat_id y message_id vienen de whatsapp_read_messages o whatsapp_search_messages (un mensaje cuyo campo `media` está definido). Nunca reemplaza un archivo: si el nombre ya está ocupado, lo guarda como «name (2).ext» y lo indica.

Entradas obligatorias

chat_id
message_id

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para whatsapp_save_media. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows