Вебхуки и события
Коннекторы не только вызываются наружу — многие получают входящие события (новая сделка в CRM, входящее сообщение, смена статуса заказа). Эти события попадают в локальный журнал и могут запускать автоматические задачи, так что вы реагируете на происходящее во внешнем сервисе, не опрашивая его.
Как проходит входящее событие
Регистрация webhook-URL
Для коннектора, поддерживающего входящие события, получите его webhook-URL и зарегистрируйте у провайдера (в настройках самого провайдера или в его консоли разработчика).
Провайдер шлёт POST-событие
Когда на стороне провайдера что-то происходит, он шлёт POST-событие на этот URL. Платформа валидирует запрос и записывает его в локальный журнал.
Отреагировать
Пусть сохранённая задача запускается автоматически в момент поступления подходящего события.
Webhook-URL
Коннекторы, поддерживающие входящие события, выставляют webhook-URL на каждый сервис, который вы регистрируете у провайдера. Получите его программно:
Дальше провайдер шлёт POST-события на этот URL; платформа валидирует и записывает их. Поддерживает ли конкретный коннектор входящие события, объявлено в его паспорте — прочитайте его через describe_service, прежде чем настраивать webhook.
Запуск задач по событиям
Сохранённая задача может запускаться автоматически при поступлении подходящего события. Установите trigger_type: "webhook" и опишите, на какие события реагировать:
| Field | Type | Description |
|---|---|---|
| trigger_typerequired | string | Установите webhook для задач, управляемых событиями (альтернатива — schedule для задач по расписанию или manual только для ручного запуска). |
| trigger_config.servicerequired | string | Коннектор, чьи события запускают задачу. |
| trigger_config.event_types | string[] | На какие типы событий этого сервиса реагировать (например message.received, deal.created). |
| trigger_config.all_events | boolean | true — реагировать на любое событие сервиса вместо перечисления. Задаётся вместо event_types, не вместе с ним; задача без того и другого не включается. |
| filter_conditions | object[] | Дополнительные условия на полезную нагрузку события перед запуском задачи. |
Когда входящее событие совпадает, задача выполняется с этим событием на входе — превращая любой webhook коннектора в автоматизацию.
Webhook или schedule
Триггер webhook реагирует на внешнее событие в момент его возникновения; триггер schedule запускается по cron-расписанию (минимальный интервал — пять минут). Выбирайте webhook, когда работа — это ответ на случившееся, и schedule, когда она должна идти по часам. См. Tasks API в интерактивном эксплорере.
FAQ
Какие коннекторы могут получать входящие webhook-события?
Коннекторы, которые заявляют поддержку входящих событий, выставляют webhook-URL на каждый сервис — типичные источники событий message, lead и deal — это мессенджеры и CRM: telegram, amocrm, bitrix24 и wazzup. Прочитайте паспорт сервиса через describe_service, чтобы узнать, поддерживает ли он входящие события.
Как запустить задачу автоматически при поступлении события?
Создайте задачу с trigger_type: "webhook" и trigger_config, указав service и event_types, на которые реагировать (либо all_events: true, чтобы слушать сервис целиком). Добавьте filter_conditions, чтобы сузить, какие полезные нагрузки запускают задачу. Когда приходит подходящее событие, задача выполняется с этим событием на входе.
Частые вопросы
Какие коннекторы могут получать входящие webhook-события?
Коннекторы, которые заявляют поддержку входящих событий, выставляют webhook-URL на каждый сервис — типичные источники событий message, lead и deal — это мессенджеры и CRM: telegram, amocrm, bitrix24 и wazzup. Прочитайте паспорт сервиса через describe_service, чтобы узнать, поддерживает ли он входящие события.
Как запустить задачу автоматически при поступлении события?
Создайте задачу с trigger_type webhook и trigger_config, указав service и event_types, на которые реагировать (либо all_events true, чтобы слушать сервис целиком). Добавьте filter_conditions, чтобы сузить, какие полезные нагрузки запускают задачу. Когда приходит подходящее событие, задача выполняется с этим событием на входе.