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

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

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

Важно!

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

Примечание.

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

2. Выберите в раскрывающемся меню Соединители.

   

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

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

   

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

6. Нажмите кнопку Готово.

   

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

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

Примечание.

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

Пример

C#

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

url = {{Webhook_URL}};
HttpClient client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var content = new StringContent({{formatted_Card_Payload}}(Adaptive_Card_Json), System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync({{WebhookUrl}}, content);

JavaScript

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

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

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

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

1. Откройте канал и выберите ••• в правом верхнем углу.

2. Выберите в раскрывающемся меню Соединители.

3. Выберите Настроено в разделе УПРАВЛЕНИЕ.

4. Выберите 1 Настроено, чтобы просмотреть список текущих соединителей.

   

5. Выберите Управление для соединителя, который требуется удалить.

   

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

   

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

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

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

   

Пример кода

Название примера	Описание	.NET	Node.js	Манифест
Примеры ботов модуля задач-V4	В этом примере показано, как создавать модули задач с помощью платформы ботов версии 4 и вкладок teams.	Просмотр	Просмотр	Просмотр

См. также

• Веб-перехватчики и соединительные линии
• Создание исходящих веб-перехватчиков
• Создание соединителей для Группы Microsoft 365
• Создание и отправка сообщений
• Создание ботов для Teams
• Расширения для сообщений
• Действия карточек
• Интеграция веб-приложений
• Поделиться в Teams из веб-приложений
• Безопасный доступ и данные в Azure Logic Apps