在 Microsoft Graph (预览版中使用呼叫委派 API)

重要

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

了解如何使用呼叫委派 API 将通信工作流简化为自定义应用程序。 这些 API 支持查询和管理委托和委托人,以增强协作调用方案,例如共享线路外观和代理调用。

先决条件

若要访问这些 API,需要以下配置:

  • 权限:将委托的范围分配给应用程序以供访问。 使用以下 URL 使用管理员帐户登录并分配权限:

    https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={Client-App-ID}&response_type=code&scope=https://graph.microsoft.com/CallDelegation.Read
    
  • 策略:使用 PowerShell 在 Microsoft Teams 中分配AllowDelegation策略:

    Set-CsTeamsCallingPolicy -AllowDelegation $true
    

Teams 委派简介

Microsoft Teams 委派允许用户通过分配代理人来分担呼叫责任。 代理人可以执行诸如接听呼叫、代表他人进行呼叫和管理呼叫设置等作。 当助手或团队成员处理其他用户的通信时,此功能非常有用。

Microsoft Graph 使开发人员能够以编程方式管理委托人和委托。 常见方案包括:

  • 设置共享行外观。
  • 管理拨打和接听呼叫的权限。
  • 简化团队中的通信工作流。

谁是委托人?

委托人是授予其他用户 (委托) 代表他们执行某些作的能力的用户。 这些作可能包括拨打和接听呼叫、管理呼叫设置或加入活动呼叫。 委托人通常是在处理通信责任时需要帮助的用户。

谁是代理人?

委托是由委托人分配职责的用户。 代理人可以执行特定作,例如接听呼叫、发起呼叫以及代表委托人管理呼叫设置。 助理或团队成员通常使用此角色来促进无缝通信工作流。

常见用例

操作 返回类型 说明
列出所有委托 delegationSettings 集合 获取用户的所有委托的列表。
按 ID 获取委托 delegationSettings 获取有关特定委托的详细信息。
列出所有委托人 delegationSettings 集合 获取用户的所有委托人的列表。
按 ID 获取委托人 delegationSettings 获取有关特定委托器的详细信息。

后续步骤

使用 Microsoft Graph 中的调用委托 API 在 Teams 中查询和管理委托人和委托人。 了解详细信息:

  • 探索对你的方案最有帮助的资源和方法。
  • 尝试在 Graph 浏览器中使用 API。