Управление номерами телефонов для ботов

В этой статье описывается, как использовать API облачных коммуникаций в Microsoft Graph для создания бота, доступ к которому можно получить по номеру телефона. При создании бота полезно ознакомиться со следующими терминами:

• Приложения: Приложение, размещенное в Azure, также называемое ботом.

• Экземпляр приложения: Объект отключенного пользователя, который может быть назначен номеру телефона, который может использоваться ботом. Это также называется учетной записью ресурса. Это единственный способ назначить номер телефона боту.

Одно приложение может иметь несколько экземпляров приложения, а каждый клиент может иметь несколько экземпляров приложения, как показано на следующем рисунке.

Предварительные требования: регистрация бота

Чтобы приступить к работе, следуйте инструкциям по регистрации вызывающего бота. Для использования в коде потребуются такие значения конфигурации, как идентификатор бота, идентификатор приложения Майкрософт и пароль приложения Майкрософт.

Добавьте следующие разрешения для бота. Администратор клиента также должен предоставить согласие на следующие разрешения:

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

Дополнительные сведения о разрешениях, связанных с вызовами, см. в справочнике по разрешениям.

Назначение номера телефона боту

Назначение номера телефона боту состоит из трех этапов:

1. Создайте экземпляр приложения.
2. Назначьте лицензии Microsoft 365 экземпляру приложения.
3. Назначьте номер телефона экземпляру приложения (только администратор клиента).

Создание экземпляра приложения

Если он еще не установлен, администратор клиента должен установить модуль Teams для PowerShell. Перед выполнением командлета администратор клиента должен выполнить вход, используя свои учетные данные.

Чтобы создать экземпляр приложения, администратор клиента выполняет следующий командлет:

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

Дополнительные сведения см. в разделе New-CsOnlineApplicationInstance.

Назначение лицензий Microsoft 365 экземпляру приложения

Назначьте лицензию виртуального пользователя экземпляру приложения. Дополнительные сведения см. в разделе Лицензия виртуального пользователя телефонной системы.

Назначьте план вызова экземпляру приложения. Дополнительные сведения см. в разделе Планы звонков для Microsoft 365.

Назначение номера телефона экземпляру приложения (только администратору клиента)

Прежде чем настраивать телефоны для пользователей в вашей организации, получите для них телефонные номера. Дополнительные сведения см. в разделе Получение номеров телефонов для пользователей.

Чтобы назначить номер телефона экземпляру приложения, администратор клиента назначает номер телефона службы (в формате +11D) с помощью следующего командлета:

PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Дополнительные сведения см. в разделе Set-CsPhoneNumberAssignment.

Отмена назначения номера телефона бота

Используйте следующий командлет, чтобы отменить назначение номера телефона:

PS C:\> Remove-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Обновление номера телефона бота

После отмены назначения номера боту можно назначить другой номер с помощью следующего командлета:

PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Связанные материалы

• Общие сведения об API Teams
• Пример бота для инцидентов
• Развертывание примера