Ir para o conteúdo
Todas as ferramentas

m365_save_attachment

Microsoft 365 · 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.

Windows

Finalidade

Salva os anexos de um e-mail do Microsoft 365 em uma pasta: todos, ou um por attachment_id (os ids que m365_read_email lista). Se um anexo substituir um arquivo com o mesmo nome, o LMCP guarda antes uma cópia desse arquivo (na sua pasta de backups) e a resposta diz onde. Um item do Outlook anexado ou um link para um arquivo na nuvem não é um arquivo: não é salvo, e a resposta informa isso. Para o Outlook clássico, use outlook_save_attachment.

Entradas obrigatórias

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 declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "attachment_id": {
      "description": "Save only this attachment (an id m365_read_email lists). Omit it to save all of them.",
      "type": "string"
    },
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "id": {
      "description": "The email message ID from m365_list_emails, m365_search_emails or m365_read_email",
      "type": "string"
    },
    "path": {
      "description": "Folder to save the attachments to",
      "type": "string"
    }
  },
  "required": [
    "id",
    "path"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para m365_save_attachment. 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.

{
  "confirm": false,
  "id": "demo-item-001",
  "path": "C:\\Users\\demo\\Documents\\Attachments"
}