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

Статья
09/24/2024

Важно!

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

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

Чтобы автоматически публиковать сообщения в чате или канале при получении запроса веб-перехватчика, используйте предопределенные шаблоны рабочих процессов или создайте рабочий процесс с нуля с помощью триггера При получении запроса веб-перехватчика Teams . Дополнительные сведения см. в статье Публикация рабочего процесса при получении запроса веб-перехватчика в Microsoft Teams.
Дополнительные сведения о триггере получения запроса веб-перехватчика Teams см. в разделе Microsoft Teams — webhook.

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

Создание соединителя Power Automate. Power Automate расширяет возможности широко используемых приложений рабочих процессов в Teams. Это масштабируемый и безопасный подход к программной передаче данных в Teams и из нее. Если вы используете этот метод, вы можете создавать шаблоны рабочих процессов для публикации оповещений из продукта в каналах Teams. Такой подход упрощает внедрение пользователем нового метода. Дополнительные сведения см. в статье Power Automate для корпоративных разработчиков, независимых поставщиков программного обеспечения и партнеров.
Обновление приложения Teams. Вы можете улучшить текущее приложение Teams. Например, можно разрешить пользователям настраивать упреждающие сообщения на основе событий триггера в системе. Дополнительные сведения см. в статье о том, как боты могут отправлять сообщения в каналы с помощью упреждающих сообщений.

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

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

Ограничения

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

Входящий веб-перехватчик позволяет внешним приложениям совместно использовать содержимое в каналах Microsoft Teams. Веб-перехватчики используются в качестве инструментов для отслеживания и уведомления. Веб-перехватчики предоставляют уникальный URL-адрес для отправки полезных данных JSON с сообщением в формате карта. Карточки — это контейнеры пользовательского интерфейса, включающие содержимое и действия, связанные с одной статьей. Вы можете использовать карточки в следующих функциях:

боты;
Расширения для обмена сообщениями
Connectors

Примечание.

Максимальный размер сообщения составляет 28 КБ. Если размер превышает 28 КБ, появляется сообщение об ошибке. Дополнительные сведения см. в разделе Ограничения и спецификации для Microsoft Teams.
Если за секунду было выполнено более четырех запросов, клиентское подключение будут ограничено до тех пор, пока окно не обновится в течение длительности окна фиксированной скорости. Логика повторных попыток с экспоненциальной задержкой может снизить ограничение скорости в случаях, когда запросы превышают ограничения в течение секунды. Чтобы избежать превышения ограничений скорости, см. раздел Ответы HTTP 429.

Основные функции входящих веб-перехватчиков

В следующей таблице представлены функции и описание входящего веб-перехватчика:

Возможности	Описание
Адаптивные карточки с использованием входящего веб-перехватчика	Адаптивные карточки можно отправить через входящие веб-перехватчики. Дополнительные сведения см. в статье Отправка адаптивных карточек с помощью входящих веб-перехватчиков.
Поддержка сообщений с действиями	Карточки сообщений с действиями поддерживаются во всех группах Microsoft 365, включая Teams. При отправке сообщений с помощью карточек необходимо использовать формат карточки сообщений с действиями. Дополнительные сведения см. в разделе Устаревшие интерактивные сообщения карта справочника и сообщения карта игровой площадке.
Поддержка независимых HTTPS-сообщений	Карточки предоставляют информацию четко и последовательно. Любые инструменты и структуры, которые способны отправлять HTTPS-запросы POST, могут отправлять сообщения в Teams через входящий веб-перехватчик.
Поддержка Markdown	Все текстовые поля в карточках сообщений с действиями поддерживают базовые функции Markdown. Не используйте в карточках разметку HTML. HTML игнорируется и обрабатывается как обычный текст.
Конфигурация в масштабе	Область действия входящего веб-перехватчика настраивается на уровне канала.
Определения безопасных ресурсов	Сообщения отформатированы в виде полезной нагрузки JSON. Эта декларативная структура обмена сообщениями предотвращает вставку вредоносного кода.

Примечание.

Боты Teams, расширения для обмена сообщениями, входящий веб-перехватчик и Bot Framework поддерживают адаптивные карточки. Адаптивная карточка — это открытая платформа кросс-карта, которая используется на всех платформах, таких как Windows, Android и iOS. Соединители Teams не поддерживают адаптивные карточки. Однако можно создать поток, который публикует адаптивные карточки в канале Teams.
Дополнительные сведения о карточках и веб-перехватчиках см. в статье Адаптивные карточки и входящие веб-перехватчики.

Создание входящего веб-перехватчика

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

Новая версия Teams
Классическая версия Teams

В клиенте New Teams выберите Teams и перейдите к каналу, в который нужно добавить входящий веб-перехватчик.
Выберите Дополнительные параметры ••• в правой части имени канала.
Выберите Управление каналом.

Для участников, которые не являются администраторами канала, параметр Управление каналом доступен в разделе Открыть сведения о канале в правом верхнем углу канала.
Нажмите Изменить.
Найдите Входящий веб-перехватчик и выберите Добавить.

Откроется диалоговое окно Входящие веб-перехватчики.
Нажмите Добавить.

Примечание.

Если вы уже добавили входящий веб-перехватчик, появится параметр Настроить . Выберите Настроить , чтобы создать входящий веб-перехватчик.
Укажите имя веб-перехватчика и при необходимости отправьте изображение.
Нажмите Создать.
Скопируйте и сохраните уникальный URL-адрес веб-перехватчика, присутствующий в диалоговом окне. URL-адрес сопоставлен с каналом, и его можно использовать для отправки сведений в Teams.
Нажмите кнопку Готово. Веб-перехватчик теперь доступен в канале Teams.

В следующем графическом представлении приведены шаги по созданию входящего веб-перехватчика:

В графическом представлении показаны шаги по созданию входящего веб-перехватчика.

Важно!

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

Вы можете создавать и отправлять интерактивные сообщения через входящий веб-перехватчик или соединитель для Группы Microsoft 365. Дополнительные сведения см. в статье Создание и отправка сообщений.

Примечание.

В Teams выберите Параметры>Разрешения участников>Разрешать участникам создавать, обновлять и удалять соединители, чтобы любой участник команды мог добавлять, изменять или удалять соединители.

Пример справочника по коду

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.0""
      }
    }
  ]
}";

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

Пример справочника по коду

var formatted_Card_Payload = {
        "type": "message",
        "attachments": [
            {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "contentUrl": null,
                "content": {
                    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
                    "type": "AdaptiveCard",
                    "version": "1.2",
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "Submitted response:"+ response
                        }
                    ]
                }
            }
        ]
    }

var webhookUrl = "https://xxxxx.webhook.office.com/xxxxxxxxx";

axios.post(webhookUrl , formatted_Card_Payload )
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

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

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

Новая версия Teams
Классическая версия Teams

В клиенте New Teams щелкните значок Teams и перейдите к каналу, в котором нужно удалить входящий веб-перехватчик.
Выберите Дополнительные параметры ••• в правой части имени канала.
Выберите Управление каналом.
Нажмите Изменить.
В левой области выберите Настроено.
В разделе Входящий веб-перехватчик выберите 1 Настроено.
Выберите Управление.
Нажмите кнопку Удалить.

Откроется диалоговое окно Удаление конфигурации.
Установите необходимые флажки.
Нажмите кнопку Удалить.

Веб-перехватчик теперь удален из канала Teams.

Пример кода

Название примера	Описание	.NET	Node.js
Входящий веб-перехватчик	В этом примере показано, как реализовать и использовать входящий веб-перехватчик.	Просмотр	Просмотр

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

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

Основные функции входящих веб-перехватчиков

Создание входящего веб-перехватчика

Пример

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

Пример кода

См. также

Дополнительные ресурсы