すべてのツール

teams_send_message

Microsoft Teams · macOS · Windows

効果: 送信. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

Microsoft Teams のチャットまたはチャネルへテキストメッセージを送信します。Microsoft Teams が起動しサインイン済みである必要があり、各呼び出しで Teams のローカル Cookie からトークンを読み直します。chat_id は必ず直前の teams_list_chats から取得し、捏造しないでください。書き込み操作なので、最初はプレビュー、confirm=true の2回目で実際に送信します。sent:true は会話からメッセージを読み戻して配信確認済みという意味です。直後の teams_search_messages や teams_read_chat_messages はローカル同期索引の遅延により空でも、送信失敗の証拠ではありません。status が 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

目的

Graph API 経由で Microsoft Teams チャットへメッセージを送信します。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?"
}