whatsapp_save_media

WhatsApp · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Salva a mídia de uma mensagem do WhatsApp (um documento como PDF, DOCX ou XLSX, uma imagem, um vídeo ou uma nota de voz/áudio) como arquivo em uma pasta local. chat_id e message_id vêm de whatsapp_read_messages ou whatsapp_search_messages (uma mensagem cujo campo `media` está definido). Nunca substitui um arquivo: se o nome já estiver em uso, salva como «name (2).ext» e avisa.

Entradas obrigatórias

chat_id
message_id

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para whatsapp_save_media. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows