使用 Microsoft Graph 中的云通信 API

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

Microsoft Graph 云通信 API 通过在应用和服务中启用核心通信功能,为你或你的组织与其他用户交互的方式添加了新的维度。 可使用此 API 接听电话、创建和检索会议坐标和查看用户的状态。

可使用云通信 API 构建服务应用程序(机器人),它们在通话中充当参与者,代表用户创建和检索会议并检查出席状态和活动。 此 API 提供了通话功能,还可用于创建和检索联机会议。 可将服务应用程序(机器人)与此 API 搭配使用,其中机器人可在 VoIP 通话或 Microsoft Teams 会议中充当参与者等等。

重要

不得使用云通信 API 来记录或以其他方式保存应用程序访问的通话或会议的媒体内容,或者从该媒体内容派生的数据。 请确保你遵守有关通信的数据保护和机密性方面的法律和法规。 有关详细信息,请参阅使用条款并咨询法律顾问。

授权

需要以下权限之一才能访问云通信 API。 需要由管理员授予这些权限。

方案 权限
通话 Calls.JoinGroupCallAsGuest.All、Calls.JoinGroupCall.All、Calls.Initiate.All、Calls.InitiateGroupCall.All、Calls.AccessMedia.All
会议 OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All
状态 状态.阅读,状态.阅读.全部
通话记录 CallRecords.Read.All

常见用例

下表列出了云通信 API 的一些常见用例。

用例 REST 资源 另请参阅
创建并键入一对一通话和群组通话 通话 通话方法
IVR 通话 IVR 方法
通话控制(参与者) 参与者
会议 onlineMeeting 会议方法
状态 状态 出席方式
检索通话记录 callRecord Webhook 订阅

通用属性

资源 属性
通话 通话属性
参与者 参与者属性
onlineMeeting onlineMeeting 属性
状态 状态属性
callRecord callRecord 属性