Вебхуки и события
Коннекторы не только вызываются наружу — многие получают входящие события (новая сделка в CRM, входящее сообщение, смена статуса заказа). Эти события попадают в локальный журнал и могут запускать автоматические задачи.
Webhook-URL
Коннекторы, поддерживающие входящие события, выставляют webhook-URL на каждый сервис, который вы регистрируете у провайдера. Получите его программно:
Дальше провайдер шлёт POST-события на этот URL; платформа валидирует и записывает их.
Журнал событий
query_events — это инструмент только для чтения поверх локального журнала входящих webhook-событий, уже сохранённых платформой, — а не живой вызов внешнего сервиса. Используйте его, чтобы посмотреть, что пришло (например, последние сообщения или обновления сделок), не перезапрашивая источник.
Запуск задач по событиям
Сохранённая задача может запускаться автоматически при поступлении подходящего события. Установите trigger_type: "webhook" и опишите, на какие события реагировать:
| Field | Type | Description |
|---|---|---|
| trigger_typerequired | string | Установите webhook для задач, управляемых событиями (альтернатива — schedule для задач по расписанию). |
| trigger_config.servicerequired | string | Коннектор, чьи события запускают задачу. |
| trigger_config.event_types | string[] | На какие типы событий реагировать (например новое сообщение, сделка обновлена). |
| filter_conditions | object[] | Дополнительные условия на полезную нагрузку события перед запуском задачи. |
Когда входящее событие совпадает, задача выполняется с этим событием на входе — превращая любой webhook коннектора в автоматизацию. См. Tasks API в интерактивном эксплорере.