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

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

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

  2. Выберите Дополнительные параметры ••• в правой части имени канала.

  3. Выберите Управление каналом.

    Снимок экрана: параметр Управление каналом в разделе Дополнительные параметры для Teams 2.1.

  4. Нажмите Изменить.

    Снимок экрана: параметр

  5. Найдите Входящий веб-перехватчик и выберите Добавить.

    Снимок экрана: параметр Добавить для добавления входящего веб-перехватчика.

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

  6. Нажмите Добавить.

    Снимок экрана: параметр

    Примечание.

    Если вы уже добавили входящий веб-перехватчик, появится параметр Настроить . Выберите Настроить , чтобы создать входящий веб-перехватчик.

  7. Укажите имя веб-перехватчика и при необходимости отправьте изображение.

  8. Нажмите Создать.

    Снимок экрана: поля имени и изображения, которые необходимо заполнить для создания веб-перехватчика.

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

  10. Нажмите кнопку Готово. Веб-перехватчик теперь доступен в канале Teams.

    Снимок экрана: уникальный URL-адрес веб-перехватчика.

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

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

Важно!

Вы можете создать приложение 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);

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

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

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

  2. Выберите Дополнительные параметры ••• в правой части имени канала.

  3. Выберите Управление каналом.

    Снимок экрана: параметр Управление каналом в разделе Дополнительные параметры.

  4. Нажмите Изменить.

    Снимок экрана: параметр

  5. В левой области выберите Настроено.

  6. В разделе Входящий веб-перехватчик выберите 1 Настроено.

    Снимок экрана: настройка для просмотра списка текущих соединителей.

  7. Выберите Управление.

    Снимок экрана: управление соединителем, который требуется удалить.

  8. Нажмите кнопку Удалить.

    Выберите удалить

    Откроется диалоговое окно Удаление конфигурации.

  9. Установите необходимые флажки.

  10. Нажмите кнопку Удалить.

    Снимок экрана: удаление входящего веб-перехватчика из канала Teams.

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

Пример кода

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

См. также