使用 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 属性 |
| 状态 | 状态 |