m365_move_email

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

Use quando o usuário quiser mover e-mails da sua conta do Microsoft 365 / Outlook para outra pasta no servidor Exchange, para arquivar ou organizar. Indique as mensagens com message_id (uma) ou message_ids (até 50), de m365_list_emails, m365_search_emails ou m365_read_email; ou uma conversa inteira com conversation_id (de m365_list_emails ou m365_search_emails): então só as mensagens dela em source_folder (padrão inbox) são movidas, nunca as cópias em Itens Enviados, Rascunhos ou outras pastas, a menos que all_folders=true. destination é um id, nome ou caminho de pasta de m365_list_email_folders, ou inbox, archive, deleteditems, junkemail. Mostra uma prévia primeiro — defina confirm=true para mover. Uma mensagem só conta como movida quando uma segunda leitura a mostra no destino e não mais no id antigo; uma mensagem movida recebe um novo id (new_id). Precisa da permissão Mail.ReadWrite do Microsoft 365: uma conta conectada antes de ela ser pedida responde consent_required até ser conectada de novo. Para e-mails do app Mail do Mac, use move_email.

Entradas obrigatórias

destination

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.

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 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"
    },
    "all_folders": {
      "description": "With conversation_id: true moves its messages from every folder, Sent Items and Drafts included (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Set to true to move (default: shows a preview only).",
      "type": "boolean"
    },
    "conversation_id": {
      "description": "Move the messages of this conversation that are in source_folder.",
      "type": "string"
    },
    "destination": {
      "description": "The folder to move them to: an id, name or path from m365_list_email_folders, or inbox, archive, deleteditems, junkemail.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to move.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 50 messages to move.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source_folder": {
      "description": "With conversation_id: the folder its messages are moved from (default inbox). An id, name or path.",
      "type": "string"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para m365_move_email. 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,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows