Поделиться через

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

  • Статья

Важно!

Соединители Microsoft 365 (ранее называемые соединителями Office 365) скоро устареют, и создание новых соединителей Microsoft 365 скоро будет заблокировано. Дополнительные сведения о расписании и о том, как приложение "Рабочие процессы" обеспечивает более гибкий и безопасный интерфейс, см. в статье Прекращение использования соединителей Microsoft 365 в Microsoft Teams.

Как создать веб-перехватчик в Teams?

Если вы уже создали соединители Office 365:

Известные проблемы

  • Приложение workflows не может публиковать в частных каналах в качестве бота потока. Однако он может публиковаться от имени пользователя.
  • Рабочие процессы поддерживают только адаптивные карточки. Он не поддерживает более старый формат карта сообщений, используемый Office 365 соединителями. Поддержка использования формата карта сообщений в рабочих процессах становится доступной с середины октября. Дополнительные сведения см. в статье Преобразование сообщений соединителя карта формат в адаптивную карточку.
  • Рабочие процессы не предлагают сторонние соединители, такие как DataDog и Jenkins.
  • Рабочие процессы можно создавать только в среде по умолчанию.

Ограничения

Рабочие процессы связаны только с определенными пользователями (которые называются владельцами рабочего процесса), а не с командой Или каналом Teams. Рабочие процессы могут стать потерянными потоками при отсутствии владельца, если совладельцы не назначены. Чтобы обеспечить непрерывность бизнес-процесса, автоматизированного потоком, администраторы могут добавить одного или нескольких совладельцев и предоставить им полный контроль над рабочим процессом. Они также могут добавить проверку подлинности для подключений (если таковые имеются) и включить поток, если он был отключен. Дополнительные сведения см. в разделе Управление потерянными потоками.

Веб-перехватчики и соединители помогают подключить веб-службы к каналам и командам в 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.
• Триггер Express 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