Создание веб-перехватчиков и соединителей

Веб-перехватчики и соединители помогают подключить веб-службы к каналам и командам в Microsoft Teams. Веб-перехватчики — это определяемый пользователем обратный вызов HTTP, который уведомляет пользователей о любых действиях, выполненных в канале Teams. Это способ для приложения получать данные в режиме реального времени. Соединители позволяют пользователям подписаться на получение уведомлений и сообщений от веб-служб. Они предоставляют службе конечную точку HTTPS для публикации сообщений в виде карточек.

Важно!

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

• В GCC-High среде доступен только тип соединителя Входящие веб-перехватчики, и администраторам клиента необходимо вручную отправить, чтобы отобразить приложение на странице соединителей.

• Вы можете создать приложение Teams бота уведомлений, отличное от входящих веб-перехватчиков. Они выполняются аналогично, но бот уведомлений имеет больше возможностей. Дополнительные сведения см. в статье Создание бота уведомлений с помощью JavaScript или пример уведомления о входящих веб-перехватчиках. Чтобы приступить к работе, скачайте и изучите Набор средств Teams. Дополнительные сведения см. в документах Teams Toolkit.

Исходящие веб-перехватчики

Веб-перехватчики содействуют интеграции Teams с внешними приложениями. С помощью исходящих веб-перехватчиков можно отправлять текстовые сообщения из канала в веб-службу. После настройки исходящих веб-перехватчиков пользователи могут отправлять @mention сообщения в веб-службу. Служба отвечает на сообщение в течение 10 секунд текстом или карта. Дополнительные сведения см. в статье Создание исходящих веб-перехватчиков.

Примечание.

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

Connectors

Соединители позволяют пользователям подписаться на получение уведомлений и сообщений от веб-служб. Они предоставляют службе конечную точку HTTPS для публикации сообщений в каналах Teams, обычно в виде карточек.

Примечание.

Соединители не могут обновлять сообщения или отправлять сообщения в качестве ответов на существующие сообщения.

Входящие веб-перехватчики

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

Бот уведомлений или входящий веб-перехватчик

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

	API уведомлений	Бот уведомлений	Входящий веб-перехватчик
Что это такое?	Веб-API RESTful	Приложение Teams	Функция Teams
Требуется установка	Да	Да	Нет
Подходящие сценарии	• Уведомлять пользователей о срочной или критической информации. • Отображение полнофункционированного содержимого, требующего действий пользователя, в области main Teams. • Получение уведомлений операционной системы со звуком. • Локализованный текст предварительного просмотра в действии.	• Периодически получать регулярные уведомления и сообщения, например получать ежедневное уведомление о задачах команды. • Получать уведомления и сообщения на основе реальных событий. Например, как только товарищи по команде отправляют файлы, вы получите уведомления.	Обмен данными с внешними приложениями и получение уведомлений и сообщений из других приложений.
Конфигурация области	• Один пользователь • Список пользователей • Пользователи в чате • Пользователи в команде	• Канал Teams • Групповой чат • Личный чат	Канал Teams
Процесс сообщения	Приложение Teams выполняет вызов REST API для активации уведомления в действии в Teams. Вызов API передает прямую ссылку для загрузки содержимого в области main.	Бот уведомлений работает как приложение Teams. Вы можете определить бизнес-логику для обработки данных и отображения данных в настраиваемом формате.	Веб-перехватчик — это функция Teams, а не приложение Teams, поэтому он получает и отображает данные только без обработки.
Получение контекста Teams	Приложение может использовать API Graph для работы с данными Microsoft 365.	Бот уведомлений может извлекать контекст Teams, например сведения о канале или пользователе и сообщения.	Нет
Отправка адаптивной карточки	Нет	Да	Да
Отправка приветственного сообщения	Да	Да	Нет
Поддерживаемый триггер	Поддерживаются все триггеры.	Поддерживаются все триггеры. Если вы используете Набор средств Teams, вы можете быстро получить проект шаблона со следующими триггерами: • Триггер времени, размещенный в функциях Azure. • Переуспокоить триггер HTTP, размещенный в службе приложений Azure. • Триггер HTTP, размещенный на Функции Azure.	Поддерживаются все триггеры.
Средства сборки	Краткое руководство по Microsoft Graph	• Обзор набора средств Teams для Visual Studio Code • Обзор набора средств Teams для Visual Studio • Интерфейс командной строки набора средств Teams • Пакет SDK TeamsFx	Инструменты не требуются.
Требуется облачный ресурс	приложение Microsoft Entra	Azure Bot Framework	Ресурсы не требуются.
Учебник	• Отправка уведомлений о веб-канале действий пользователям в Microsoft Teams • Отправка уведомления о веб-канале действий	Создание бота уведомлений с помощью JavaScript	Пример уведомления о входящих веб-перехватчиках

Соединители для Группы Microsoft 365

Соединители для Группы Microsoft 365 позволяют создать настраиваемую страницу конфигурации для входящего веб-перехватчика и упаковать их как часть приложения Teams. Сообщения отправляются в основном с помощью карточек соединителей для Группы Microsoft 365 и могут добавлять к ним ограниченный набор действий карта. Например, соединитель погоды, позволяющий пользователям выбирать расположение и в любое время суток получать обновления о погоде завтрашнего дня. Они настраиваются на уровне канала, но устанавливаются на уровне команды. Дополнительные сведения см. в статье Создание соединителей для Группы Microsoft 365.

Примечание.

Соединитель для приложения Группы Microsoft 365 Teams можно распространить в AppStore.

Создание и отправка сообщений

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

См. также

Сопоставление возможностей приложения и функций Teams