Создание прямых ссылок

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

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

Клиентская библиотека JavaScript в Microsoft Teams (TeamsJS) упрощает процесс навигации. Во многих сценариях, таких как переход к содержимому и сведениям на вкладке или запуск диалогового окна чата. TeamsJS предоставляет типизированные API- интерфейсы, которые обеспечивают улучшенный интерфейс и могут заменить использование глубоких ссылок. Эти API-интерфейсы рекомендуются для приложений Teams, которые могут выполняться на других узлах (Outlook, приложение Microsoft 365), так как они также позволяют проверить, поддерживается ли эта возможность этим узлом.

Примечание.

В этом разделе представлена версия 2.0.x клиентской библиотеки JavaScript (TeamsJS) Microsoft Teams. Если вы используете более раннюю версию, ознакомьтесь с обзором библиотеки TeamsJS , чтобы узнать о различиях между последней версией TeamsJS и более ранними версиями.

Схема, на котором показаны различные сценарии для глубоких ссылок.

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

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

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

Примечание.

Поведение прямых ссылок зависит от ряда факторов. В следующем списке описывается поведение прямых ссылок в сущностях Teams.

Вкладка:
✔ Напрямую переходит к URL-адресу прямой ссылки.

Бот:
✔ Прямая ссылка в тексте карточки: сначала открывается в браузере.
✔ Прямая ссылка добавлена к действию OpenURL в адаптивной карточке: прямой переход к URL-адресу прямой ссылки.
✔ Текст с разметкой Markdown гиперссылки в карточке: сначала открывается в браузере.

Чат:
✔ Разметка Markdown гиперссылки текстового сообщения: прямой переход к URL-адресу прямой ссылки.
✔ Ссылка, вставленная в общий чат: прямой переход к URL-адресу прямой ссылки.

Поведение навигации в приложении Teams, которое распространяется на Microsoft 365 (приложение Outlook/Microsoft 365), зависит от двух факторов:

  • Целевой объект, на который указывает прямая ссылка.
  • Узел, в котором запущено приложение Teams.

Если приложение Teams выполняется на узле, где нацелена прямая ссылка, приложение открывается непосредственно в узле. Однако если приложение Teams работает на узле, отличном от того, где настроена прямая ссылка, приложение сначала откроется в браузере.

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