Вопросы интеграции Teams

  • Статья

Вы можете сделать веб-приложения совместимыми с социальными функциями и функциями совместной работы Teams, правильно интегрировав их с Teams.

Различные типы приложений, которые можно интегрировать с Teams:

  • Автономные приложения. Автономное приложение — это одностраничное или большое сложное приложение. Пользователь может применять некоторые его аспекты в Teams.
  • Приложения для совместной работы: приложение, уже созданное для социальных функций и функций совместной работы, присущих Teams.
  • SharePoint: страница SharePoint, которую вы хотите отобразить в Teams.

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

Ознакомьтесь с возможностями платформы Teams

Сценарии интеграции: автономные приложения, приложения для совместной работы, SharePoint

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

Общие функции приложения Возможности платформы Teams
Встроенная веб-страница, домашняя страница или веб-представление Вкладки
Вкладки, расширенные в Microsoft 365
Делитесь ярлыками и расширениями Расширения для сообщений
Расширения сообщений для Outlook
Ярлыки и расширения действий Расширения для сообщений
Чат-боты Боты
Уведомления канала Боты
Входящие веб-перехватчики
Соединители для Группы Microsoft 365
Внешние службы сообщений Боты
Исходящие веб-перехватчики
Модальные Диалоговые окна (называемые модулями задач в TeamsJS версии 1.x)
Карточки с богатым содержимым Адаптивные карточки

Определить подмножество функциональности

Сценарии интеграции: автономные приложения

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

Ниже приведены необходимые условия для интеграции приложения с Teams.

  1. Сопоставьте варианты использования приложения с возможностями платформы Teams..
  2. Определите точки входа приложения.. Это для личного использования, для совместной работы или для того и другого?

Требования и параметры SharePoint

Сценарии интеграции: SharePoint

Чтобы интегрировать существующую страницу SharePointв качестве вкладки Teams, необходимо учитывать следующее:

  • Это должна быть современная страница SharePoint.
  • Поддерживаются только личные вкладки. Вы не можете интегрировать свою страницу в качестве вкладки канала.

Кроме того, вы можете создать вкладку Teams с помощью SharePoint Framework.

Стремитесь к мультиклиентности

Сценарии интеграции: автономные приложения, приложения для совместной работы, SharePoint

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

Просмотр API

Сценарии интеграции: автономные приложения, приложения для совместной работы

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

Узнайте, как получить контекст для вкладки Teams или бота.

Варианты проверки подлинности

Сценарии интеграции: автономные приложения, приложения для совместной работы, SharePoint

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

В Teams есть механизмы единого входа (SSO) с идентификатором Microsoft Entra для сторонних приложений. В нем также содержатся рекомендации по потокам проверки подлинности для других поставщиков удостоверений, использующих такие стандарты, как OAuth и OpenID Connect, известные как OIDC.

Важно!

Сейчас сторонние приложения доступны в облаке государственного сообщества (GCC), но недоступны для GCC-High и Министерства обороны (DOD). Сторонние приложения для GCC по умолчанию отключены. Чтобы включить сторонние приложения для GCC, см. раздел Управление политиками разрешений приложений и Управление приложениями.

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

Подробнее о Проверке подлинности Teams

Следуйте рекомендациям по проектированию Teams

Сценарии интеграции: автономные приложения, приложения для совместной работы

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

Развернуть глубокие связи

Сценарии интеграции: автономные приложения, приложения для совместной работы, SharePoint

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

Будьте разумны при обмене сообщениями с пользователями

Сценарии интеграции: автономные приложения, приложения для совместной работы, SharePoint

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

Боты также позволяют отправлять упреждающие сообщения отдельным пользователям или каналам. Упреждающие сообщения — это незапрашиваемые сообщения, инициированные внешним событием, а не сообщения, отправленные боту. Например, бот отправляет приветственное сообщение, когда он установлен или новый пользователь присоединяется к каналу.

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

Не спам пользователей с чрезмерными сообщениями. Если возможности Teams поддерживают это, пользователи могут настроить параметры уведомлений для приложения. Ниже приведен пример сообщения уведомления: Не присылайте мне сообщения без запроса.

Используйте SharePoint для хранения файлов и данных

Сценарии интеграции: автономные приложения, приложения для совместной работы, страницы SharePoint.

При создании группы коллекция веб-сайтов SharePoint также подготавливается для поддержки хранения файлов и данных для этой группы. Приложение должно использовать эту функцию, если оно взаимодействует с файлами. Используйте коллекцию веб-сайтов для хранения необработанных данных в списках SharePoint и Microsoft Excel.

Дополнительные ресурсы