使用 Microsoft Graph 通信 APIWorking with the communications API in Microsoft Graph

Microsoft Graph 通信 API 通过在应用和服务中启用核心通信功能,为你或你的组织与其他用户交互的方式添加了新的维度。The Microsoft Graph communications API adds a new dimension to how you or your organization can interact with other users by enabling core communication capabilities and features in your apps and services. 可使用此 API 接听电话、创建和检索会议坐标。You can use this API to create and receive calls as well as create and retrieve meeting coordinates.

可使用通信 API 构建服务应用程序(机器人),它们在通话中充当参与者,并代表用户创建和检索会议。You can use the communications API to build service applications (bots) that act like participants in a call, and that create and retrieve meetings on behalf of users. 此 API 提供了通话功能,还可用于创建和检索联机会议。This API provides calling functionality as well as the ability to create and retrieve online meetings. 可将服务应用程序(机器人)与此 API 搭配使用,其中机器人可在 VoIP 通话或 Microsoft Teams 会议中充当参与者等等。You can use service applications (bots) with this API, where the bot can act as a participant in your VoIP calls or Microsoft Teams meetings, for example.

授权Authorization

需要以下权限 之一才能访问通信 API。One of the following permissions is required to access the communications API. 需要由管理员授予这些权限。These permissions need to be granted by the administrator

方案Scenario 权限Permissions
通话Calling Calls.JoinGroupCallsasGuest.All, Calls.JoinGroupCalls.All, Calls.Initiate.All, Calls.InitiateGroupCalls.All, Calls.AccessMedia.AllCalls.JoinGroupCallsasGuest.All, Calls.JoinGroupCalls.All, Calls.Initiate.All, Calls.InitiateGroupCalls.All, Calls.AccessMedia.All
会议Meetings OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.AllOnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All
通话记录Call records CallRecords.Read.AllCallRecords.Read.All

常见用例Common use cases

下表列出了通信 API 的一些常见用例。The following table lists some of the common uses for the communications API.

用例Use cases REST 资源REST resources 另请参阅See also
创建并键入一对一通话和群组通话Creating and joining 1-1 and group calls 通话Call 通话方法Methods for calls
IVR 通话IVR calls IVR 方法Methods for IVR
通话控制(参与者)Call controls (participant) 参与者Participant
会议Meetings onlineMeetingonlineMeeting 会议方法Methods for meetings
检索通话记录Retrieving call records callRecordcallRecord Webhook 订阅Webhook subscriptions

通用属性Common properties

资源Resource 属性Properties
通话call 通话属性call properties
参与者participant 参与者属性participant properties
onlineMeetingonlineMeeting onlineMeeting 属性onlineMeeting properties
callRecordcallRecord callRecord 属性callRecord properties

最近更新What's new

了解此 API 集的最新功能和更新Find out about the latest new features and updates for this API set.

另请参阅See also