Настройка глубоких ссылок

  • Статья

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

Подробные ссылки в Teams можно использовать следующими способами:

  • Прямая ссылка на приложение
  • Прямая ссылка на чат
  • Прямая ссылка на команды и каналы
  • Прямая ссылка на рабочий процесс

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

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

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

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

  • Прямая ссылка на чат. Используйте прямую ссылку для перехода к беседе канала, сообщениям чата или файлу в канале.

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

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

  • Прямая ссылка на команды и каналы. Используйте прямую ссылку для перехода к определенной команде или каналу. Дополнительные сведения см. в разделе Прямая ссылка на канал.

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

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

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

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

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

Примечание.

Чтобы перенаправить пользователей из приложения Teams в его собственный интерфейс через прямую ссылку с протоколом , например , или , запустите прямую ссылку в новом окне, вызвав window.open метод или используя тег привязки с target="_blank".webex:mailto:tel:

Глубокие связи Teams поддерживают два типа обработчиков протоколов:

  1. HTTPS. Обработчик https:// протокола является обработчиком по умолчанию в большинстве URL-адресов. При использовании этого обработчика протокола в глубокой ссылке Teams он открывается в окне браузера, который предоставляет три варианта:

    1. Откройте прямую ссылку в классическом клиенте Teams, если он установлен
    2. Скачайте классический клиент Teams, если он не установлен
    3. Откройте прямую ссылку в веб-клиенте Teams.

    Снимок экрана: прямая ссылка, открытая в браузере.

    Примечание.

    Прямая связь должна начинаться с https://teams.microsoft.com/l/ , чтобы обеспечить правильную обработку в Teams. URL-адреса Teams, скопированные из адресной строки браузера, не работают как прямые ссылки в новом клиенте Teams.

  2. MSTEAMS. msteams:// Обработчик протокола пропускает экран выбора клиента в браузере и открывает прямую ссылку непосредственно в классическом клиенте Teams. Пользователи, у которых нет классического клиента Teams, могут не иметь доступа к подробным ссылкам с помощью msteams://. Всегда используйте https:// в глубоких ссылках, если только вы не уверены, что пользователи вашего приложения имеют настольном клиенте на своем устройстве.

    Предостережение

    Не добавляйте msteams: эту прямую https:// ссылку, например msteams:https://teams.microsoft.com/l/call/0/0 Teams не может проанализировать эту прямую ссылку как допустимый объект URL-адреса.

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

Интеграция веб-приложений