teams_call_history

Microsoft Teams · macOS · Windows

效果: 读取. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

列出该账户最近 50 个聊天中已结束的 Microsoft Teams 通话和会议，最新的在前，来自 Microsoft 365：通话类型（call、meeting 或 screenShare）、参与者、开始和结束时间以及时长。聊天之外的通话（电话、没有聊天的日历会议）不会列出，并且 Microsoft 不会说明是谁发起了通话或是否被接听：direction 和 answered 始终为空。可选的 since/until（YYYY-MM-DD）可缩小范围。查看最近的 50 个聊天，并在每个聊天中查看其最新的 50 条未删除的消息（最多读取 20 页、每页 50 条）。该账户无法读取的聊天（403 或 404）会被跳过，并计入 skipped_chats。当读取被截断（因达到该上限，或因调用超时）时，答复中会带有 truncated: true。需要用 connect_m365_account 连接工作或学校的 Microsoft 365 账户（个人 Microsoft 账户无法读取 Teams）。如果完全没有连接 Microsoft 365 账户，则改为读取这台 Mac 上 Teams 应用的本地缓存（需要完整磁盘访问权限，可能落后数小时或数天）；答复中的 source 会说明由哪一个提供了答复（graph 或 local_cache）。

必填输入

此平台的架构未声明必填输入，但仍可能存在可选选择器或运行时要求。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — 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"
    },
    "limit": {
      "description": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

文档示例

teams_call_history 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "limit": 5
}

Windows

用途

通过 Microsoft Graph（已连接的 Microsoft 365 账户）读取 Microsoft Teams 通话和会议历史，数据源自你最近 Teams 聊天中的通话结束事件。每个通话包含参与者、开始/结束时间、时长、通话类型和一个稳定的通话 id。可选的 since/until（YYYY-MM-DD）可缩小范围——例如每日采集器会拉取前一天的通话。查看最近的 50 个聊天，并在每个聊天中查看其最新的 50 条未删除的消息（最多读取 20 页、每页 50 条）。该账户无法读取的聊天（403 或 404）会被跳过，并计入 skipped_chats。当读取被截断（因达到该上限，或因调用超时）时，答复中会带有 truncated: true。