Распространение расширения сообщений Teams в Microsoft 365

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

• Расширения сообщений на основе поиска. Позволяет пользователям выполнять поиск во внешней системе и делиться результатами в области создания сообщений клиента.

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

Примечание.

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

Пользователи Outlook mobile в Android и iOS могут получать и выполнять действия с карточками из приложений, которые были отправлены им пользователями в Outlook в Интернете и Outlook для Windows.

Расширение сообщений Teams в Microsoft 365 также поддерживает распаковку ссылок , на котором отображаются карточки для запуска Stageview и диалоговых окон.

Предварительные условия

Чтобы расширить расширение сообщений Teams в Outlook, убедитесь в следующем:

• Проверьте поддержку расширений сообщений в Outlook для настольных компьютеров, веб-приложений и мобильных устройств Для Windows. См. таблицу поддержки в разделе Расширение приложений Teams в Microsoft 365.
• Клиент изолированной программы для разработчиков Microsoft 365. Для расширения сообщений на основе действий зарегистрируйте клиент разработчика для целевых выпусков Microsoft 365.
• Тестовая среда с приложениями Microsoft 365, установленными из Приложения Microsoft 365 Current Channel.
• Microsoft Visual Studio Code с расширением Teams Toolkit (необязательно)

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

Чтобы расширить расширение сообщений Teams в Outlook, можно либо создать новое приложение расширения сообщений с помощью набора средств Teams, либо расширить существующее приложение расширения сообщений Teams в Outlook.

Создание приложения расширения сообщений для Outlook

Вы можете создать приложение расширения сообщений Teams для Outlook с помощью расширения Набора средств Teams для Visual Studio Code. Чтобы создать приложение расширения сообщений для Outlook, убедитесь в следующем:

• Отправка приложения в Microsoft Teams
• Предварительный просмотр расширения сообщений в Outlook

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

Расширение сообщений на основе поиска

1. Откройте Visual Studio Code.

2. Выберите Палитра команд... под параметром Вид или CTRL+SHIFT+P.

3. Выберите Teams: Создать новое приложение.

4. В раскрывающемся списке выберите Расширение сообщений .

5. Выберите Настраиваемые результаты поиска , чтобы скачать пример кода для расширения сообщений на основе поиска Teams с помощью последней версии манифеста приложения (ранее — манифест приложения Teams).

   

   Вы также можете скачать пример кода из области слева, в разделе РАЗРАБОТКА выберите Просмотреть примеры. Откроется вкладка Примеры , в поле поиска введите Соединитель поиска NPM.

   

6. Выберите предпочтительный язык программирования.

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

8. Выберите Палитра команд... под параметром Вид или CTRL+SHIFT+P.

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

10. Выберите подписку и группу ресурсов.

11. Выберите Подготовка. Кроме того, можно выбрать Пункт Подготовка в разделе ЖИЗНЕННЫЙ цикл расширения.

12. Выберите Палитра команд... под параметром Вид или CTRL+SHIFT+P.

13. Введите Teams: Развертывание , чтобы развернуть пример кода в подготовленных ресурсах в Azure и запустить приложение. Кроме того, можно выбрать Развернуть в разделе ЖИЗНЕННЫЙ цикл расширения.

14. Нажмите Развернуть.

Расширение сообщений на основе действий

1. Откройте Visual Studio Code.

2. Выберите Палитра команд... под параметром Вид или CTRL+SHIFT+P.

3. Выберите Teams: Создать новое приложение.

4. В раскрывающемся списке выберите Расширение сообщений .

5. Выберите Сбор входных и обрабатываемых данных формы , чтобы скачать пример кода для расширения сообщений на основе действий Teams с помощью последнего манифеста приложения (ранее — манифест приложения Teams).

   

6. Выберите предпочтительный язык программирования.

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

8. Выберите Палитра команд... под параметром Вид или CTRL+SHIFT+P.

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

10. Выберите подписку и группу ресурсов.

11. Выберите Подготовка. Кроме того, можно выбрать Пункт Подготовка в разделе ЖИЗНЕННЫЙ цикл расширения.

12. Выберите Палитра команд... под параметром Вид или CTRL+SHIFT+P.

13. Введите Teams: Развертывание , чтобы развернуть пример кода в подготовленных ресурсах в Azure и запустить приложение. Кроме того, можно выбрать Развернуть в разделе ЖИЗНЕННЫЙ цикл расширения.

14. Нажмите Развернуть.

Теперь вы можете отправить приложение в Teams и просмотреть расширение сообщений в Outlook. Сведения о сборке пакета приложения с помощью набора средств Teams см. в разделе Сборка пакета приложения.

Расширение существующего приложения расширения сообщений Teams в Outlook

Чтобы расширить существующее приложение расширения сообщений Teams в Outlook, убедитесь в следующем:

• Обновите манифест приложения.
• Добавьте канал Microsoft 365 для приложения.
• Обновление Microsoft Entra регистрации приложения для единого входа.
• Отправьте обновленное приложение в Teams.
• Предварительный просмотр расширения сообщений в Outlook

Обновление манифеста приложения

Обновите версию схемы манифеста приложения (ранее — манифест приложения Teams) или более позднюю, 1.13 чтобы разрешить запуск расширения сообщений Teams в Outlook.

Откройте манифест приложения и обновите $schema и manifestVersion следующими значениями:

{
"$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
"manifestVersion" : "1.16"
}

Набор средств Teams можно использовать для проверки манифеста приложения и выявления любых ошибок.

Указание требований к среде выполнения узла (предварительная версия для разработчиков)

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

Дополнительные сведения см. в статье Указание требований к среде выполнения узла Microsoft 365 в манифесте приложения.

Добавление канала Microsoft 365 для приложения

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

Чтобы пользователи могли взаимодействовать с расширением сообщений из Outlook, необходимо включить канал Microsoft 365 для ресурса бота Azure приложения расширения сообщений.

Примечание.

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

1. Перейдите на портал Microsoft портал Azure или Bot Framework (если вы уже там зарегистрированы), перейдите к ресурсу бота.

2. Из раздела Параметры>Каналы.

3. В разделе Доступные каналы выберите Канал Microsoft 365 .

   

4. Нажмите Применить.

   

5. Убедитесь, что канал Microsoft 365 указан вместе с Microsoft Teams в области "Каналы " бота.

Обновление регистрации приложения Microsoft Entra для единого входа

Примечание.

Этот шаг можно пропустить, если вы создаете приложение для Outlook с помощью Teams Toolkit, так как сценарий не предполагает Microsoft Entra проверки подлинности единого входа.

Microsoft Entra единый вход (SSO) для расширений сообщений работает в Outlook так же, как и в Teams. Однако необходимо добавить несколько идентификаторов клиентских приложений в Microsoft Entra регистрации приложения бота на портале Регистрация приложений клиента.

1. Войдите на портал Azure с помощью учетной записи клиента песочницы.

2. Выберите Регистрация приложений.

3. Выберите имя приложения, чтобы открыть его регистрацию.

4. Выберите Управление>Предоставление API.

5. В разделе Авторизованные клиентские приложения убедитесь, что перечислены все следующие Client Id значения:

   Клиентское приложение Microsoft 365	Идентификатор клиента
   Настольные компьютеры и мобильные устройства	1fec8e78-bce4-4aaf-ab1b-5451cc387264
   Веб-приложение Teams	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
   Microsoft 365 web	4765445b-32c6-49b0-83e6-1d93765276ca
   Microsoft 365 desktop	0ec893e0-5785-4de6-99da-4ed124e5296c
   Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Классическое приложение Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Web Access	bc59ab01-8403-45c6-8796-ac3ef710b3e3
   Outlook Mobile	27922004-5251-4030-b22d-91ecd9a37ea4

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

Отправьте обновленное расширение сообщения (пакет приложения) в Teams. После завершения в установленных приложениях в области создания сообщений появится расширение сообщения.

1. Создайте файл .zip с манифестом приложения и значками приложения.

2. Перейдите в Microsoft Teams и войдите с помощью учетной записи клиента песочницы.

3. Выберите Приложения>Управление приложениями>Отправка приложения.

   

4. Выберите параметр Отправить пользовательское приложение , выберите файл .zip и установите (добавьте) его в клиент Teams.

   

После его отправки через Teams расширение сообщений будет доступно в Outlook для классических приложений и в Интернете.

Предварительный просмотр расширения сообщений в Outlook

Вот как протестировать расширение сообщений, работающее в Outlook в Интернете. Чтобы просмотреть приложение, запущенное в Outlook в Интернете, выполните следующие действия.

1. Войдите в outlook.com , используя учетные данные тестового клиента.

2. ВыберитеСоздать сообщение.

3. Выберите Приложения на ленте.

   

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

Отладка

При отладке расширения сообщений можно определить источник (исходящий из Teams и Outlook) запросов бота по полю channelId объекта Activity . Когда пользователь выполняет запрос, ваша служба получает стандартный объект Bot Framework.Activity. Одно из свойств объекта Activity — , channelIdкоторое имеет значение или m365extensions, в зависимости от того, откуда msteams исходит запрос бота. Дополнительные сведения см. в статье Пакет SDK для расширений сообщений на основе поиска и пакет SDK для расширений обмена сообщениями на основе действий.

Ограничения

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

• Расширения сообщений в Outlook поддерживаются только в контексте compose . В манифесте приложения Teams контексты расширения сообщений, такие как commandBox и message , не поддерживаются в Outlook.

• Расширения сообщений на основе действий, которые отправляют карточки в поле создания, поддерживаются в Outlook. Однако использование ботов для доставки карточек не поддерживается. В этом сценарии вы можете преобразовать расширение сообщений для отправки карточек в поле создания в Outlook.

• Вы не можете вставить более пяти адаптивных карточек в сообщение электронной почты.

• Действия карточек типа messageBack, imBack, invokeи signin не поддерживаются. openURLявляется единственным поддерживаемым действием карта.

• Поддерживаются действия адаптивной карточки. Поддерживается Action.Submit запуск только stageview и taskmodule .

Примечание.

При тестировании приложения с распаковкой ссылок убедитесь, что после тестирования приложение удаляется вручную. Если несколько приложений отслеживают один и тот же домен, приложение, установленное в последнее время, не может быть вызвано для развертывания ссылки в Outlook, как в Teams.

Используйте каналы сообщества разработчиков Microsoft Teams, чтобы сообщать о проблемах и оставлять отзывы.

Пример кода

Название примера	Описание	Node.js
Соединитель поиска NPM	Пример приложения Набора средств Teams для создания приложения расширения сообщений. Работает в Teams и Outlook.	Просмотр
Разблокирование ссылок Teams	Простое приложение Teams для демонстрации распаковки ссылок. Работает в Teams и в Outlook.	View
Вкладка в представлении этапов	Пример приложения вкладки Microsoft Teams для демонстрации вкладки в Stageview. Работает в Teams, Outlook, приложении Microsoft 365.	Просмотр
Расширение сообщений на основе действий Teams для Microsoft 365	Пример приложения Набора средств Teams для создания приложения расширения сообщений. Работает в Teams и Outlook.	Просмотр

Следующий этап

Публикация приложений Teams для Outlook и приложений Microsoft 365