一. 關鍵資源類型 ??

通話記錄 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