Все инструменты

teams_send_message

Microsoft Teams · macOS · Windows

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

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

macOS

Назначение

Отправляет текстовое сообщение в чат или канал Microsoft Teams. Требуется, чтобы Microsoft Teams был запущен и пользователь вошел в систему (при каждом вызове токен заново считывается из локальных cookie Teams). chat_id ОБЯЗАТЕЛЬНО должен быть получен из предыдущего вызова teams_list_chats — никогда не выдумывайте ids. Это операция записи: первый вызов возвращает предварительный просмотр, второй (с confirm=true) действительно отправляет сообщение. sent:true означает, что сообщение было считано обратно из разговора (доставка подтверждена) — доверяйте ЭТОМУ полю, а не последующему чтению: teams_search_messages и teams_read_chat_messages читают собственный локальный индекс синхронизации Teams, который может отставать от подтвержденной отправки на несколько минут (единственный наблюдавшийся случай: 3 мин, #2285). Нулевой результат связанного чтения сразу после отправки НЕ означает, что отправка не удалась. Ответ со статусом "sent_unconfirmed" означает, что сервер принял POST, но сообщение НЕ удалось проверить; попросите пользователя открыть сам Teams и проверить, прежде чем считать, что получатель уведомлен.

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

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

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

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

Каноническая техническая схема на английском — macOS
{
  "properties": {
    "chat_id": {
      "description": "Thread id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<uuid>@thread.tacv2' for group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview without making any network call.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments in v1.",
      "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. Первый вызов возвращает предварительный просмотр; для отправки задайте confirm=true.

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

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

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

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

Каноническая техническая схема на английском — Windows
{
  "properties": {
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "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?"
}