Взаимодействие Teams: вызов

В рамках этой предварительной версии пакеты SDK Службы коммуникации Azure можно использовать для создания приложений, которые позволяют пользователям удостоверений (BYOI) запускать вызовы 1:1 с пользователями Teams. Цены на стандартные Службы коммуникации Azure применяются к этим пользователям, но дополнительная плата за возможность взаимодействия не взимается. Пользовательские приложения, созданные с помощью Службы коммуникации Azure для подключения и взаимодействия с пользователями Teams или голосовыми приложениями Teams, могут использоваться конечными пользователями или ботами, и нет различий в том, как они отображаются пользователям Teams в приложениях Teams, если не указано разработчиком приложения с отображаемым именем.

Чтобы включить вызов между пользователями служб коммуникации и клиентом Teams, разрешите клиенту через форму и включите подключение между клиентом и ресурсом Служб коммуникации.

Включение взаимодействия в клиенте Teams

Пользователь Microsoft Entra с ролью администратора Teams может запустить командлет PowerShell с модулем MicrosoftTeams, чтобы включить ресурс Служб коммуникации в клиенте.

1. Подготовка модуля Microsoft Teams

Сначала откройте PowerShell и проверьте существование модуля Teams с помощью следующей команды:

Get-module *teams* 

Если модуль не отображается MicrosoftTeams , сначала установите его. Чтобы установить модуль, необходимо запустить PowerShell от имени администратора. Затем выполните следующую команду.

	Install-Module -Name MicrosoftTeams

Вы будете проинформированы о модулях, которые будут установлены, которые можно подтвердить с помощью Y или A ответа. Если модуль установлен, но устарел, можно выполнить следующую команду, чтобы обновить модуль:

	Update-Module MicrosoftTeams

2. Подключение к модулю Microsoft Teams

После установки и готовности модуля можно подключиться к модулю MicrosftTeams с помощью следующей команды. Вам будет предложено выполнить вход в интерактивное окно. Учетная запись пользователя, которую вы собираетесь использовать, должны иметь разрешения администратора Teams. В противном случае вы можете получить access denied ответ в следующих шагах.

Connect-MicrosoftTeams

3. Включение конфигурации клиента

Взаимодействие с ресурсами Служб коммуникации управляется с помощью конфигурации клиента и назначенной политики. Клиент Teams имеет одну конфигурацию клиента, а пользователи Teams назначили глобальную политику или пользовательскую политику. Дополнительные сведения см. в разделе "Назначение политик" в Teams.

После успешного входа можно запустить командлет Set-CsTeamsAcsFederationConfiguration , чтобы включить ресурс Служб коммуникации в клиенте. Замените текст IMMUTABLE_RESOURCE_ID неизменяемым идентификатором ресурса в ресурсе связи. Дополнительные сведения см . здесь.

$allowlist = @('IMMUTABLE_RESOURCE_ID')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist

4. Включение политики клиента

Каждому пользователю Teams назначено значение, определяющее External Access Policy , могут ли пользователи Служб коммуникации вызывать этого пользователя Teams. Используйте командлет Set-CsExternalAccessPolicy, чтобы убедиться, что политика, назначенная пользователю Teams, имеет значение EnableAcsFederationAccess$true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Получение идентификатора пользователя Teams

Чтобы начать звонок с пользователем Teams или приложением Teams Voice, вам потребуется идентификатор целевого объекта. У вас есть следующие параметры для получения идентификатора:

• Пользовательский интерфейс идентификатора Microsoft Entra ID или с локальной синхронизацией синхронизации каталогов Microsoft Entra Connect
• Программно с помощью API Microsoft Graph

Совершение вызовов

С помощью пакета SDK для вызовов пользователь или конечная точка служб коммуникации может запустить вызов 1:1 с пользователями Teams, определяемым идентификатором объекта Microsoft Entra. Вы можете легко изменить существующее приложение, которое вызывает других пользователей Служб коммуникации для вызова пользователей Teams.

Управление вызовами — руководство по Службы коммуникации Azure | Документация Майкрософт

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

const acsCallee = { communicationUserId: '<Azure Communication Services User ID>' }
const call = callAgent.startCall([acsCallee]);

Вызов пользователя Teams с помощью microsoftTeamsUserId:

const teamsCallee = { microsoftTeamsUserId: '<Teams User AAD Object ID>' }
const call = callAgent.startCall([teamsCallee]);

События голосового и видеозвонка

События голосового и видеозвонка служб коммуникации вызываются для звонков между пользователем служб коммуникации и пользователями Teams.

Известные проблемы и ограничения

• В настоящее время эта функция недоступна в пакете SDK для вызовов .NET.
• Пользователи Teams должны находиться в режиме TeamsOnly. Skype для бизнеса пользователи не могут получать звонки от пользователей служб коммуникации 1:1.
• Эскалация вызова группы не поддерживается.
• Запись звонков служб коммуникации недоступна для вызовов 1:1.
• Расширенные возможности маршрутизации звонков, такие как переадресация звонков, прием групповых звонков, одновременный звонок и голосовая почта не поддерживаются.
• Пользователи Teams не могут настроить пользователей Служб коммуникации в качестве целевых объектов пересылки и передачи.
• Многие функции в клиенте Teams не работают должным образом во время вызовов 1:1 с пользователями служб коммуникации.
• Сторонние устройства для ip-телефонов Teams и Skype не поддерживаются.

Конфиденциальность

Взаимодействие между Службы коммуникации Azure и Microsoft Teams позволяет приложениям и пользователям участвовать в звонках и собраниях Teams. Вы несете ответственность за то, чтобы пользователи вашего приложения получали уведомления о включении записи или транскрибирования в вызове или конференции Teams.

Корпорация Майкрософт будет указывать через API Службы коммуникации Azure, что началось запись или транскрибирование. Этот факт необходимо сообщить пользователям в пользовательском интерфейсе приложения в режиме реального времени. Вы соглашаетесь на компенсацию корпорации Майкрософт по всем затратам и ущербам, возникшим из-за вашего сбоя в соответствии с этим обязательством.