Расширение приложения для собраний Teams в Outlook

2025-06-10

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

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

Примечание.

Кроме тогоconfigurableTabs, ваше приложение для собраний должно содержать по крайней мере одну возможность в личных область (например, staticTabs), чтобы оно было доступно в Outlook.

В следующей таблице показаны контексты приложений для собраний Teams, поддерживаемые в Outlook:

Контекст собрания Teams	Значение манифеста приложения	Значение TeamsJS	Поддержка Outlook
Представление сведений о собрании	`meetingDetailsTab`	`frameContext.content`	✔️
Представление чата собрания	`meetingChatTab`	`frameContext.content`	✔️
Представление боковой панели собрания	`meetingSidePanel`	`frameContext.sidePanel`	✔️
Представление этапа собрания	`meetingStage`	`frameContext.meetingStage`	❌

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

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

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

Клиент песочницы разработчика Microsoft 365 с включенной отправкой.
Тестовая среда с классическим приложением Outlook для Windows, установленным из Приложения Microsoft 365 Current Channel.
Установлен УзелJS (с npm).
Библиотека командной строки набора средств Teams версии 2, установленная из npm.
Visual Studio Code, установленных в среде разработки.
Расширение набора средств агентов Microsoft 365 для Visual Studio Code.

Для предварительного просмотра приложения для собраний Teams в Outlook можно создать новое приложение для собраний с помощью microsoft 365 Agents Toolkit (ранее известного как Набор средств Teams) или расширить существующее приложение для собраний Teams в Outlook.

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

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

Перейдите в Teams и войдите с помощью учетной записи клиента песочницы.
Выберите Календарь>Новое собрание и запланируйте собрание.
Откройте расширение Microsoft 365 Agents Toolkit в Visual Studio Code и выберите Просмотреть примеры.
Выберите My First Meeting App Create (Создать приложение> для первого собрания) и укажите папку для создания рабочей области.
Выберите F5 , чтобы выполнить отладку и запустить пример локально в Teams. Teams предложит установить приложение.
Нажмите Добавить.
Найдите и выберите собрание, которое вы запланировали ранее, и перейдите через диалоговое окно, чтобы выбрать Перейти.
Выберите пример конфигурации вкладки и нажмите кнопку Сохранить. Приложение доступно в представлении чата собрания.

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

Обновите манифест приложения.
Используйте клиентскую библиотеку JavaScript (TeamsJS) версии 2.5.0 или более поздней.
Настройка заголовков политики безопасности содержимого.
Обновите Microsoft Entra регистрации приложения для единого входа.
Отправьте обновленное приложение в Teams Администратор Center.

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

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

Обновите версию схемы манифеста приложения (ранее — манифест приложения Teams) до версии 1.13 или более поздней.

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

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

Использование TeamsJS версии 2.5.0 или более поздней

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

Если вам нужно обновить пакет npm TeamsJS с версии 1.x.x до последней версии TeamsJS версии 2.x.x, можно использовать набор средств агентов для выявления и автоматизации необходимых изменений кода. Дополнительные сведения см. в статье Библиотека TeamsJS.

Выполните следующие действия, чтобы обновить TeamsJS до последней версии с помощью набора средств агентов:

Откройте приложение в Visual Studio Code и выберите расширение Microsoft 365 Agents Toolkit.
В разделе Вид выберите Палитра команд... или CTRL+SHIFT+P.
Выполните команду Microsoft 365 Agents: Upgrade Teams JS SDK and code references.

Ссылки на @microsoft/[email protected] файлы package.json и *.js/.ts файлы и *.jsx/.tsx обновляются с помощью:

Инструкции импорта для [email protected].
Вызовы функции, перечисления и интерфейса для [email protected].
Новые "TODO" напоминания о комментариях помечают области, на которые могут повлиять изменения интерфейса контекста .
Новые "TODO" напоминания о комментариях для преобразования функций обратного вызова в обещания.

Примечание.

При обновлении до последней версии TeamsJS с помощью набора средств агентов код в HTML-файлах не обновляется. Html-файлы необходимо обновить вручную.

Настройка заголовков CSP для Outlook

Приложения вкладок Teams размещаются в элементах iframe в Outlook, как и в Teams. Если ваше приложение использует заголовки политики безопасности содержимого (CSP), добавьте outlook.office.com в качестве предка фрейма.

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

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

Войдите в портал Azure с помощью тестовой учетной записи клиента.
Откройте Регистрации приложений.
Выберите свое приложение.
Выберите Управление>Предоставление API.
В разделе Авторизованные клиентские приложения добавьте следующее Client Id значение:

Клиентское приложение Microsoft 365 Идентификатор клиента

Классическое приложение Outlook d3590ed6-52b3-4102-aeff-aad2292ab01c

Дополнительные сведения об идентификаторах клиентских приложений, используемых для расширения приложений Teams в Microsoft 365, см. в разделе Вкладки Teams в Microsoft 365 и Outlook.

Клиентское приложение Microsoft 365	Идентификатор клиента
Классическое приложение Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c

Вы можете отправить пользовательское приложение в Центр администрирования Teams и просмотреть приложение для собраний в Outlook.

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

Чтобы протестировать приложение в Microsoft 365 и Outlook, отправьте пакет приложения в Центр администрирования Teams.

Упаковайте манифест приложения Teams и значки приложений в ZIP-файл. Сведения о создании пакета приложения с помощью набора средств агентов см. в разделе Сборка пакета приложения.
Перейдите в Центр администрирования Teams и выберите Приложения> TeamsУправление приложениями.
Выберите Отправить новое приложение и выберите пакет приложения.

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

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

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

Откройте Outlook для Windows, выполнив вход с помощью тестовой учетной записи клиента. Если Outlook уже запущен, закройте и перезапустите его снова.
Откройте календарь>Новое собрание. Чтобы приложение для собраний запускалось в Outlook, убедитесь, что собрание является собранием Teams , так как другие собрания, запланированные из Outlook, не поддерживаются.
В окне планирования собраний выберите Все приложения. Загруженное приложение для собраний отображается среди установленных приложений для собраний.
Выберите приложение для собраний. Откроется диалоговое окно конфигурации, в котором пользователь настраивает все соответствующие параметры приложения для конкретного собрания.
Нажмите Добавить. Приложение для собраний отображается в разделе Приложения и на боковой панели окна планирования.

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

Сведения. Как приложение отображается в Microsoft Teams Store.
Параметры: обновите конфигурацию приложения для конкретного собрания.
Удалить: удалите приложение из собрания.

Приложение для собраний, работающее на боковой панели планировщика собраний Outlook

Пример кода

Название примера	Описание	Node.js
Приложение HelloWorld для собраний	Шаблон для приложений, использующих только в контексте собрания Teams.	Просмотр

См. также

Поддержка и обратная связь