Перейти к содержимому
Все инструменты

m365_move_email

Microsoft 365 · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Используйте, когда пользователю нужно переместить письма его аккаунта Microsoft 365 / Outlook в другую папку на сервере Exchange, чтобы разложить, заархивировать или упорядочить их. Назовите сообщения через message_id (одно) или message_ids (до 50) из m365_list_emails, m365_search_emails или m365_read_email; либо целую переписку через conversation_id (из m365_list_emails или m365_search_emails): тогда перемещаются только её сообщения в source_folder (по умолчанию inbox), но никогда её копии в Sent Items, Drafts или других папках, если не указано all_folders=true. destination — id, имя или путь папки из m365_list_email_folders либо inbox, archive, deleteditems, junkemail. Сначала показывает предпросмотр — установите confirm=true, чтобы переместить. Сообщение считается перемещённым, только когда повторное чтение показывает его в целевой папке и больше не под прежним id; у перемещённого сообщения новый id (new_id). Нужно разрешение Microsoft 365 Mail.ReadWrite: аккаунт, подключённый до того, как оно запрашивалось, отвечает consent_required, пока не будет подключён заново. Для почты в приложении «Почта» на Mac используйте move_email.

Обязательные входные данные

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — 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"
}

Пример для документации

Пример документации для m365_move_email. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows

Назначение

Используйте, когда пользователю нужно переместить письма его аккаунта Microsoft 365 / Outlook в другую папку на сервере Exchange, чтобы разложить, заархивировать или упорядочить их. Назовите сообщения через message_id (одно) или message_ids (до 50) из m365_list_emails, m365_search_emails или m365_read_email; либо целую переписку через conversation_id (из m365_list_emails или m365_search_emails): тогда перемещаются только её сообщения в source_folder (по умолчанию inbox), но никогда её копии в Sent Items, Drafts или других папках, если не указано all_folders=true. destination — id, имя или путь папки из m365_list_email_folders либо inbox, archive, deleteditems, junkemail. Сначала показывает предпросмотр — установите confirm=true, чтобы переместить. Сообщение считается перемещённым, только когда повторное чтение показывает его в целевой папке и больше не под прежним id; у перемещённого сообщения новый id (new_id). Нужно разрешение Microsoft 365 Mail.ReadWrite: аккаунт, подключённый до того, как оно запрашивалось, отвечает consent_required, пока не будет подключён заново. Для почты в классическом приложении Outlook на этом ПК используйте outlook_move_email.

Обязательные входные данные

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — 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"
    },
    "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"
}

Пример для документации

Пример документации для m365_move_email. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "destination": "archive",
  "message_id": "demo-message-001"
}