使用 Microsoft Graph 中的云通信 API

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

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

重要

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

授权

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

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

常见用例

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

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

通用属性

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