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

teams_send_message

Microsoft Teams · macOS · Windows

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

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

macOS

Назначение

Отправляет текстовое сообщение в чат Microsoft Teams от имени подключённого рабочего или учебного аккаунта Microsoft 365 (connect_m365_account) через Microsoft 365. chat_id ОБЯЗАТЕЛЬНО брать из teams_list_chats того же аккаунта — никогда не выдумывайте id. Это операция записи: первый вызов возвращает предпросмотр с перечнем участников чата (или с сообщением, что их не удалось прочитать: chat_unresolved), второй вызов (с confirm=true) действительно отправляет. Перед подтверждением покажите пользователю этих участников, особенно когда participants_state не равен "resolved" или has_external_members равно true. sent:true означает, что Microsoft приняла сообщение; teams_search_messages читает поисковый индекс Microsoft, который может отставать от отправки, поэтому поиск без результатов сразу после отправки НЕ доказывает, что отправка не удалась.

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

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

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

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

Каноническая техническая схема на английском — 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"
    },
    "chat_id": {
      "description": "Chat id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<id>@thread.v2' for a group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview and sends nothing: the preview reads who is in the chat (`chat`: title, participants, participant_count, participants_state, has_external_members), or says chat_unresolved when that could not be read.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

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

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

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

Назначение

Отправляет сообщение в чат Microsoft Teams через Graph API. Требует connect_m365_account. chat_id должен быть получен из teams_list_chats. Первый вызов возвращает предпросмотр с перечнем участников чата (или с сообщением, что их не удалось прочитать: chat_unresolved); для отправки установите confirm=true. Перед подтверждением покажите пользователю этих участников, особенно когда participants_state не равен "resolved" или has_external_members равно true.

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

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

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

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

Каноническая техническая схема на английском — 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"
    },
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview and sends nothing: the preview reads who is in the chat (`chat`: title, participants, participant_count, participants_state, has_external_members), or says chat_unresolved when that could not be read.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

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

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

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}