Создать расширения для сообщений

Статья
09/16/2024

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

Важно!

Расширения сообщений недоступны в облаках сообщества для государственных организаций (GCC), GCC-High и Министерства обороны (DOD).

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

На следующем рисунке показаны расположения, из которых можно вызывать расширения сообщений:

Примечание.

@mentioning Расширения сообщений в поле создания не поддерживаются.
Параметры расширения сообщений не поддерживаются для групповых чатов с внешними пользователями.

Компьютер
Мобильные устройства

Снимок экрана: расположение вызовов расширений сообщений на рабочем столе Teams.

Сценарии, в которых используются расширения для сообщений

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

Сведения о работе расширений для сообщений

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

Примечание.

Хотя веб-службу можно создать вручную, рекомендуется использовать пакет SDK Bot Framework для работы с протоколом.

В манифесте приложения (ранее называемом манифестом приложения Teams) определяется одно расширение сообщений с 10 разными командами. Каждая команда определяет тип, например действие или поиск, а также расположения в клиенте, из которых вызывается расширение сообщений. Расположения вызова включают область создания сообщения, панель команд и сообщение. При вызове веб-служба получает сообщение HTTPS с полезными данными JSON со всеми соответствующими сведениями. Ответ с полезными данными JSON, чтобы сообщить клиенту Teams о следующем взаимодействии, включаемом.

Типы команд расширения сообщений

Есть два типа команд расширения для сообщений: команда действия и команда поиска. Тип команды расширения для сообщений определяет элементы пользовательского интерфейса и потоки взаимодействия, доступные веб-службе. Некоторые взаимодействия, такие как проверка подлинности и конфигурация, доступны для обоих типов команд.

Команды действий

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

Команды действий активируются из области создания сообщений, командного поля или сообщения. При вызове команды из сообщения исходные полезные данные JSON, отправленные боту, включают все сообщение, из которого она была вызвана. На следующем рисунке отображается диалоговое окно действия расширения сообщения (называется модулем задач в TeamsJS версии 1.x):

Диалоговое окно действия расширения сообщения

Команды поиска

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

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

Примечание.

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

Развертывание ссылки

Примечание.

Распаковка ссылок поддерживается только для расширений сообщений на основе бота.

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

развернуть ссылку

распаковка ссылок