# Вебхуки и события

Коннекторы не только вызываются наружу — многие получают **входящие события** (новая сделка в CRM, входящее сообщение, смена статуса заказа). Эти события попадают в локальный журнал и могут запускать автоматические задачи.

## Webhook-URL

Коннекторы, поддерживающие входящие события, выставляют webhook-URL на каждый сервис, который вы регистрируете у провайдера. Получите его программно:

```bash
curl "$BASE/connectors/$SERVICE/webhook-url" \
  -H "Authorization: Bearer $SAMRESHUUU_API_KEY"
```

Дальше провайдер шлёт POST-события на этот URL; платформа валидирует и записывает их.

## Журнал событий

`query_events` — это инструмент только для чтения поверх **локального журнала** входящих webhook-событий, уже сохранённых платформой, — а не живой вызов внешнего сервиса. Используйте его, чтобы посмотреть, что пришло (например, последние сообщения или обновления сделок), не перезапрашивая источник.

## Запуск задач по событиям

Сохранённая [задача](/docs/agents) может запускаться автоматически при поступлении подходящего события. Установите `trigger_type: "webhook"` и опишите, на какие события реагировать:

<ParamTable rows={[
  { name: "trigger_type", type: "string", required: true, description: "Установите webhook для задач, управляемых событиями (альтернатива — schedule для задач по расписанию)." },
  { name: "trigger_config.service", type: "string", required: true, description: "Коннектор, чьи события запускают задачу." },
  { name: "trigger_config.event_types", type: "string[]", description: "На какие типы событий реагировать (например новое сообщение, сделка обновлена)." },
  { name: "filter_conditions", type: "object[]", description: "Дополнительные условия на полезную нагрузку события перед запуском задачи." },
]} />

Когда входящее событие совпадает, задача выполняется с этим событием на входе — превращая любой webhook коннектора в автоматизацию. См. Tasks API в [интерактивном эксплорере](/docs/api-explorer).