Создание веб-перехватчиков и соединителей
Веб-перехватчики и соединители помогают подключить веб-службы к каналам и командам в 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-адрес веб-перехватчика.
Следующее действие
См. также
Platform Docs
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по