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

Исходящий веб-перехватчик действует как бот и ищет сообщения в каналах с помощью @упоминания. Он отправляет уведомления внешней веб-службе и отвечает расширенными сообщениями, включая карточки и изображения. Это помогает пропустить процесс создания ботов с помощью Microsoft Bot Framework.

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


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

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

Возможности Описание
Конфигурация с заданная областью Веб-перехватчики имеют область действия на уровне группы. Обязательный процесс настройки для каждого из них добавляет исходящий веб-перехватчик.
Реактивный обмен сообщениями Пользователи должны использовать @mention для веб-перехватчика для получения сообщений. В настоящее время пользователи могут отправлять сообщения только исходящим веб-перехватчикам в общедоступных каналах, но не в пределах личных или частных областей.
Стандартный обмен сообщениями HTTP Ответы появятся в той же цепочке, что и исходное сообщение-запрос, и могут содержать все, что содержат сообщения Bot Framework. Например, форматированный текст, изображения, карточки и эмодзи. Хотя исходящие веб-перехватчики могут использовать карточки, они не могут использовать никакие действия с карточками, кроме openURL.
Поддержка метода API Teams Исходящие веб-перехватчики отправляют HTTP POST в веб-службу и получают ответ. Они не могут получить доступ к другим API, таким как извлечение списка сотрудников или списка каналов в команде.

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

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

  1. Выберите Teams в левой области.

    Канал Teams

  2. На странице Teams выберите необходимую команду для создания исходящего веб-перехватчика и выберите •••.

  3. Выберите Управление командой в раскрывающемся меню.

    Выберите управление

  4. Выберите Приложения на странице канала.

    Выбор приложения

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

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

  6. Введите следующие сведения на странице Создание исходящего веб-перехватчика :

    • Имя: заголовок веб-перехватчика и вкладка @mention .
    • URL-адрес обратного вызова: конечная точка HTTPS, которая принимает полезную нагрузку JSON и получает запросы POST от Teams.
    • Описание: подробная строка, которая отображается в карточке профиля и на панели мониторинга приложения уровня команды.
    • Изображение профиля: значок приложения для веб-перехватчика, который является необязательным.
  7. Нажмите Создать. Исходящий веб-перехватчик добавляется в канал текущей команды.

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

Откроется диалоговое окно Код проверки подлинности сообщений на основе хэша (HMAC). Это маркер безопасности, используемый для проверки подлинности звонков между Teams и назначенной внешней службой. Маркер безопасности HMAC не истекает и является уникальным для каждой конфигурации.

Примечание.

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

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

  • Сценарий: push-уведомления об изменении состояния на сервере базы данных канала Teams в ваше приложение.
  • Пример: у вас есть бизнес-приложение, которое отслеживает все операции создания, чтения, обновления и удаления (CRUD). Эти операции выполняются в записях сотрудников пользователями канала Управления персоналом Teams в клиенте Microsoft 365.

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

Ваша служба получает сообщения в стандартной схеме обмена сообщениями службы Azure Bot. Соединитель Bot Framework — это служба RESTful, которая позволяет обрабатывать обмен сообщениями в формате JSON с помощью протоколов HTTPS, как описано в API службы Azure Bot. Кроме того, вы можете использовать пакет SDK Microsoft Bot Framework для обработки и анализа сообщений. Дополнительные сведения см. в разделе с обзором службы Azure Bot.

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

Примечание.

  • Можно отправлять адаптивные карточки, карточки главного имиджевого баннера и текстовые сообщения в виде вложений с помощью исходящего веб-перехватчика.
  • Карточки поддерживают форматирование. Дополнительные сведения см. в разделе Форматирование карточек с помощью Markdown.
  • Адаптивная карточка в исходящих веб-перехватчиках поддерживает только действия карточки openURL.

Следующие части кода являются примерами отклика адаптивной карточки:

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


// This method is to read the request body content
string content;
using (var reader = new StreamReader(Request.Body))
    {
        content = await reader.ReadToEndAsync();
    }

var Card = new AdaptiveCard(new AdaptiveSchemaVersion("1.4"))
{
    Body = new List<AdaptiveElement>()
    {
        new AdaptiveTextBlock(){Text= $"Request sent by: {incomingActivity.From.Name}"},
        new AdaptiveImage(){Url=new Uri("https://c.s-microsoft.com/en-us/CMSImages/DesktopContent-04_UPDATED.png?version=43c80870-99dd-7fb1-48c0-59aced085ab6")},
        new AdaptiveTextBlock(){Text="Sample image for Adaptive Card.."}
    }
};

var attachment = new Attachment()
{
    ContentType = AdaptiveCard.ContentType,
    Content = Card
};

var sampleResponseActivity = new Activity
{
    Attachments = new [] { attachment }
};

return sampleResponseActivity;

Пример кода

Название примера Описание .NET Node.js
Исходящие веб-перехватчики Примеры создания пользовательских ботов для использования в Microsoft Teams. Просмотр View

Пошаговые инструкции

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

См. также