Что такое веб-перехватчики и соединители?What are webhooks and connectors?

Веб-перехватчики и соединители — это простой способ подключения веб-служб к каналам и Microsoft Teams в Microsoft Teams.Webhooks and connectors are a simple way to connect your web services to channels and teams inside Microsoft Teams.

Исходящие веб-перехватчикиOutgoing webhooks

Исходящие веб-Перехватчики позволяют пользователям отправлять текстовые сообщения из канала в веб-службы.Outgoing webhooks allow your users to send text messages from a channel to your web services. После настройки пользователи смогут @mention исходящий веб-перехватчик и отправлять в службу сообщение.Once configured, your users will be able to @mention your outgoing webhook and send a message to your service. В течение пяти секунд для службы будет отправлен ответ на сообщение, который может содержать текст или карточку.Your service will have five seconds to send a response to the message, potentially containing text or a card.

Исходящие веб-перехватчики настраиваются отдельно для каждой группы, не могут быть включены в состав обычного приложения Teams.Outgoing webhooks are configured on a per-team basis, cannot be included as part of a normal Teams app. Они лучше всего подходят для выполнения рабочих нагрузок, относящихся к группам, которые не требуют сбора или обмена больших объемов данных.They are best suited for completing team-specific workloads that don't require large amounts of information to be collected or exchanged.

Ознакомьтесь со статьей Создание исходящего веб-перехватчика.See Create an outgoing webhook.

СоединителиConnectors

Соединители позволяют пользователям подписываться на получение уведомлений и сообщений от ваших веб-служб.Connectors allow users to subscribe to receive notifications and messages from your web services. Они предоставляют конечную точку HTTPS для службы, чтобы отправлять сообщения в виде карточек.They expose an HTTPS endpoint for your service to post messages to - typically in the form of cards.

Входящие веб-перехватчикиIncoming webhooks

Входящие веб-перехватчики это простейший тип соединителя.Incoming webhooks are the simplest type of connector. Для любого канала в группе (если они включены для этой команды) вы можете предоставить конечную точку HTTPS, которая будет принимать правильно отформатированный JSON и вставлять сообщения в этот канал.For any channel in team (if they are enabled for that team) you can choose to expose an HTTPS endpoint that will accept correctly formatted JSON and insert messages into that channel. Они являются быстрым и простым способом подключения канала к службе и лучше всего использовать для сценариев, уникальных для конкретной команды.They are a quick and easy way to connect a channel to your service, and are best used for scenarios that are unique to a particular team. Например, вы можете создать входящий веб-перехватчик в своем канале DevOps и настроить службы построения, развертывания и мониторинга для отправки оповещений.For example, you could create an incoming webhook in your DevOps channel and configure your build, deployment and monitoring services to send alerts.

Ознакомьтесь со статьей Создание входящего веб-перехватчика.See Create an incoming webhook.

Соединители Office 365Office 365 Connectors

Соединители Office 365 позволяют создавать настраиваемую страницу конфигурации для входящего веб-перехватчика и упаковывать их как часть приложения Teams.Office 365 Connectors allow you to create a custom configuration page for your incoming webhook, and package them as part of a Teams app. Затем вы можете распространить это приложение в широком смысле или даже в магазине приложений.You can then distribute that app more broadly, or even to our app store. Сообщения отправляются в основном с помощью карт соединителей Office 365, и их также можно добавлять к ограниченному набору действий с картой.You send messages primarily using Office 365 Connector cards, and have the ability to add a limited set of card actions to them as well. Хорошим примером является соединитель погоды, который позволяет пользователям выбрать место и время для получения обновлений о погоде завтра.A good example of this is a weather connector that allows users to choose a location and time of day to receive updates about tomorrow's weather. Они настраиваются на уровне канала, но устанавливаются на уровне группы.They are configured on a channel level, but are installed at a team level.

В разделе Create a a Office 365 Connector.See Create an Office 365 Connector.