大网数据广告活动
Microsoft Graph 接口

使用云通信 API 管理机器人的电话号码

· 52CE 我爱测

了解如何使用 Microsoft Graph 云通信 API 创建可通过电话号码访问的机器人,以及如何分配、取消分配或更新机器人电话号码。

本文介绍如何使用 Microsoft Graph 中的云通信 API 创建可通过电话号码访问的机器人。 创建机器人时,熟悉以下术语会很有帮助:

  • 应用: 托管在 Azure 上的应用程序,也称为 机器人。

  • 应用程序实例: 可分配给机器人可以使用的电话号码的禁用用户对象。 这也称为 资源帐户。 这是将电话号码分配给机器人的唯一方法。

一个应用程序可以有多个应用程序实例,每个租户可以有多个应用程序实例,如下图所示。

显示具有一个或多个应用程序实例的租户的电话号码的图像

先决条件:注册机器人

若要开始,请按照说明 注册调用机器人。 需要在代码中使用机器人 ID、Microsoft 应用 ID 和 Microsoft 应用密码等配置值。

将以下权限添加到机器人。 租户管理员也需要同意这些权限:

  • Calls.AccessMedia.All
  • Calls.Initiate.All
  • Calls.JoinGroupCall.All
  • Calls.JoinGroupCallAsGuest.All

有关与呼叫相关的权限的详细信息,请参阅 “权限”参考。

将电话号码分配给机器人

向机器人分配电话号码涉及三个步骤:

  1. 创建应用程序实例。
  2. 将 Microsoft 365 许可证分配到应用程序实例。
  3. 将电话号码分配给应用程序实例 (仅租户管理员) 。

创建应用程序实例

如果尚未安装,租户管理员需要安装 Skype for Business Online Module for PowerShell。 租户管理员在运行 cmdlet 之前必须使用其凭据登录。

若要创建新的应用程序实例,租户管理员运行以下 cmdlet:

PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <user@contoso.com> -ApplicationId <app_id> -DisplayName <bot_display_name>

创建应用程序实例时,请使用同步 cmdlet:

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

有关详细信息,请参阅 New-CsOnlineApplicationInstance 和 Sync-CsOnlineApplicationInstance。

将 Microsoft 365 许可证分配到应用程序实例

将虚拟用户许可证分配到应用程序实例。 有关详细信息,请参阅 电话系统虚拟用户许可证。

将调用计划分配给应用程序实例。 有关详细信息,请参阅 Microsoft 365 的呼叫计划。

将电话号码分配给应用程序实例 (仅租户管理员)

在进行组织用户拨打和接听电话的设置之前,必须先为用户获取电话号码。 有关详细信息,请参阅 获取用户的电话号码。

要将电话号码分配到应用程序实例,租户管理员:

  1. 以租户管理员身份登录到 Teams 管理中心。

  2. 转到 Teams 管理员中心 > 语音 > 电话号码。

  3. 使用以下 cmdlet) 分配服务电话号码 (+11D 格式:

    PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <phone_number>

分配服务电话号码时,请使用同步 cmdlet:

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

有关详细信息,请参阅 Set-CsOnlineVoiceApplicationInstance 和 Sync-CsOnlineApplicationInstance。

取消分配机器人电话号码

使用以下 cmdlet 取消分配电话号码:

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber $null

Note: 目前,这仅适用于联机数字,而不适用于直接路由 (DR) 数字。 这是一个已知问题。

更新机器人电话号码

取消分配数字后,可以使用以下 cmdlet 将其他数字分配给机器人:

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <new phone_number>

另请参阅

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 ananmishr)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。