Поделиться через


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

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


Модели удостоверений пользователей

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

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

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

Функция Внешний пользователь Пользователь Teams
Целевая база пользователей Клиенты Предприятие
Поставщик удостоверений Любое Microsoft Entra ID
Показать имя Любой с суффиксом "(External)" Значение свойства "Отображаемое имя" пользователя Microsoft Entra.
Проверка подлинности и авторизация Пользовательский* Идентификатор Microsoft Entra и пользовательский*
Вызовы можно осуществлять через Пакеты SDK для звонков в Службах связи Пакеты SDK для звонков Служб коммуникации
Чат доступен через Пакет SDK чатов Служб коммуникации API Graph
Присоединяйтесь к собраниям Teams Да Да
Совершать и получать звонки от имени пользователей Teams нет Да
Поддержка ТСОП (PSTN) Не поддерживается для пользователей сервисов связи на собраниях Teams Телефонная система Microsoft Teams, план звонков, прямая маршрутизация, подключение оператора

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

Внешний пользователь

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

Первый сценарий позволяет пользователям приложения присоединяться к собраниям Microsoft Teams с помощью внешних учетных записей, аналогичных анонимным пользователям, которые присоединяются к собраниям с помощью веб-приложения Teams. Эта функция идеально подходит для бизнес-приложений для потребителей, которые объединяют сотрудников (знакомых с Teams) и внешних пользователей (с помощью пользовательского приложения) в интерфейс собрания.

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

Дополнительные сведения см. в статье Присоединение к собранию Teams.

В настоящее время пользователю Teams невозможно присоединиться к вызову, который был инициирован с помощью пакета SDK для вызовов Службы коммуникации Azure.

Пользователь Teams

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

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

Пользователи Teams проходят проверку подлинности с помощью идентификатора Microsoft Entra в клиентском приложении. Затем разработчики обменивают токены аутентификации из Microsoft Entra ID на токены доступа через SDK удостоверений службы связи. Этот обмен создает соединение между идентификатором Microsoft Entra и службами коммуникации. Рекомендуется реализовать обмен токенов в ваших внутренних службах в качестве учетных данных для запросов на обмен в Azure Communication Services. В серверных службах можно требовать любые другие методы проверки подлинности.

Опыт проведения собраний и звонков в Teams

Существует несколько способов, с помощью которых пользователи могут присоединиться к собранию Teams:

  • Через клиенты Teams как пользователи Teams с проверкой подлинности. сюда входят клиенты для настольных компьютеров, мобильных устройств и веб-клиенты Teams;
  • Через клиенты Teams как анонимные пользователибез проверки подлинности.
  • С помощью пользовательских приложений Служб коммуникации для внешних пользователей, используя модель аутентификации 'bring your own identity'.
  • Через пользовательские приложения Communication Services в качестве пользователей Teams, использующих модель проверки подлинности на основе удостоверений Teams.

Обзор различных сценариев взаимодействия в Службах коммуникации Azure

С помощью модели проверки подлинности удостоверений Teams приложение Служб коммуникации позволяет пользователям Teams присоединяться к звонкам с другими пользователями Teams, использующими клиенты Teams: Обзор сценариев взаимодействия в Службах коммуникации Azure

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

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

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

Цены

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

Если пользователь вашего приложения Azure проводит 10 минут в собрании с пользователем Microsoft Teams, то в сумме они используют 20 минут на звонки. 10 минут, затраченные с использованием пользовательского приложения и API и SDK Azure, выставляются на ваш ресурс. Однако 10 минут, потребляемых пользователем в собственном приложении Teams, охватывается соответствующей лицензией Teams и не измеряется в Azure.

Руководство по товарным знакам и бренду

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

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

Например:

"(Имя компании) (имя приложения), интегрированное с Microsoft Teams"

Teams в государственном облаке (GCC)

Сейчас взаимодействие в Службах коммуникации Azure не поддерживается для развертываний Teams с использованием облаков для государственных организаций Microsoft 365 (GCC).

Следующие шаги

Дополнительные сведения о взаимодействии внешних пользователей:

Дополнительные сведения о взаимодействии пользователейTeams: