Microsoft Teams & Skype for Business 通话记录 API：结构、日志与最佳实践一网打尽

在使用 Microsoft Teams 或 Skype for Business 时，通话记录 API 提供了关于组织内部呼叫与在线会议的使用情况以及诊断信息的详细数据。通过调用记录 API，开发者可以订阅通话记录、列出所有通话记录，并根据 ID 查询特定的通话记录。这些通话记录会在通话或会议结束后生成，并会被保留 30 天 📅。

调用记录 API 定义在 OData 子命名空间 microsoft.graph.callRecords 中，开发者可以通过该命名空间访问相关资源和功能。

💡 小贴士：
想让指标可衡量、团队节奏更透明？「开发任务管理系统 KPI」提示词可帮你基于 AI 超级提示词，快速制定与业务成果对齐的 KPI，兼顾用户参与度与交付质量！

一. 关键资源类型 📊

通话记录 API 提供了一系列资源类型，用于描述通话和会议的详细信息。这些资源类型包括但不限于：

通话记录：描述单次通话或会议的详细信息。
参与者信息：记录通话或会议中每位参与者的相关数据。
媒体流数据：提供通话中音频、视频或屏幕共享的质量指标。

这些资源类型为开发者提供了丰富的数据支持，帮助分析通话质量、参与者行为以及其他相关信息 📈。

二. 通话记录结构 🏗️

通话记录的结构化数据包含以下关键字段：

ID：唯一标识通话记录的标识符。
开始时间和结束时间：记录通话或会议的时间范围。
参与者列表：列出所有参与通话或会议的用户。
媒体类型：标识通话中使用的媒体类型，例如音频、视频或屏幕共享。
诊断信息：提供通话质量、连接问题等诊断数据。

通过这些结构化信息，开发者可以深入了解每次通话的具体情况，并对潜在问题进行分析和优化 🔍。

🛠️ 写完原型别忘了跑「代码优化」提示词，一键诊断性能瓶颈并给出改写建议，让批量拉取通话记录更快更稳！

三. PSTN 和直接路由日志 ☎️

对于使用公共交换电话网络（PSTN）或直接路由功能的组织，通话记录 API 还支持记录相关的日志数据。这些日志包括：

呼叫方向：标识呼叫是入站还是出站。
电话号码：记录涉及的电话号码。
路由信息：提供通话的路由路径数据。

这些日志数据对于分析 PSTN 呼叫的使用情况和优化路由配置非常有帮助 🛣️。

四. 相关内容 📚

要深入了解通话记录 API 的使用方法和最佳实践，请参考以下资源：

Microsoft Graph 通话记录 API 文档

通过这些资源，开发者可以快速上手通话记录 API，并将其集成到自己的应用程序中 🚀。

📖 想给新同事一份秒懂的接口文档？「代码文档生成器」可自动生成标准化函数描述、请求示例与错误码说明，让接入零阻力！

五. 实战代码片段 🧩

以下示例展示如何一次性拉取最近 7 天的通话记录并提取关键字段，开箱即用：

GET https://graph.microsoft.com/v1.0/communications/callRecords?$filter=startDateTime ge 2025-10-17T00:00:00Z&$top=50
Authorization: Bearer {access_token}
Accept: application/json

{
  "value": [
    {
      "id": "e4d6a0f4...",
      "startDateTime": "2025-10-20T09:12:34Z",
      "endDateTime": "2025-10-20T09:45:10Z",
      "participants": [
        {
          "user": { "displayName": "Alice" },
          "streams": [{ "mediaType": "audio", "quality": "Good" }]
        }
      ]
    }
  ]
}

🔍 上线前最后一步：跑「代码审查助手」，自动捕捉潜在漏洞、性能隐患与风格问题，给出可执行反馈，确保日志拉取逻辑万无一失！

六. 结语 🏁

Microsoft Graph 通话记录 API 为组织提供了详尽的通话与会议数据，从参与者质量到 PSTN 路由日志，一应俱全。借助结构化数据和 OData 查询，开发者可以快速构建监控大屏、质量预警或成本分析应用，让每一次通话都有迹可循、有据可依 📊。

🧩 懒得重复造轮子？直接让「代码生成」帮你一键输出完成特定功能的代码段，再按需微调即可，加速你的创意落地！

原文链接: https://learn.microsoft.com/en-us/graph/api/resources/callrecords-api-overview