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

Веб-перехватчики и соединители помогают подключить веб-службы к каналам и командам в 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. Боты уведомлений могут обеспечить более настраиваемый интерфейс для удовлетворения различных бизнес-сценариев.

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

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

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

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

Примечание.

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

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

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

Следующее действие

См. также