Webhook

Webhook — Step для отправки HTTP-запроса из ProCRM во внешнюю систему во время прохождения Flow.

Он позволяет передать данные из автоматизации на указанный URL.

Lead
 ↓
Webhook
 ↓
HTTP request
 ↓
External system
 ↓
Flow продолжается

Поддерживаемые методы

Webhook поддерживает два HTTP-метода:

Method	Назначение
GET	Отправляет запрос на указанный URL
POST	Отправляет запрос с возможностью передать Body

Выбор метода зависит от API или сервиса, которому отправляется запрос.

URL

В Step указывается URL, на который ProCRM должен отправить запрос.

Например:

https://example.com/webhook

В URL можно использовать Variables и другие поддерживаемые macros.

Например:

https://example.com/webhook?lead={{leadId}}

Перед отправкой запроса ProCRM подставит фактические значения.

GET

При использовании GET данные можно передавать непосредственно через URL.

Webhook
 ↓
GET
 ↓
https://example.com/webhook?lead={{leadId}}

Это позволяет формировать динамический запрос на основании данных текущего лида или Flow.

POST

При использовании POST Webhook может дополнительно содержать Body.

Webhook
 ↓
POST
 ├── URL
 └── Body
 ↓
External system

Body используется для передачи данных в теле HTTP-запроса.

Variables и macros

Webhook может использовать динамические значения в URL.

Например:

https://example.com/event?lead={{leadId}}&value={{variable}}

При выполнении Step placeholders заменяются соответствующими значениями.

Это позволяет использовать один Webhook Step для разных лидов без создания отдельного URL для каждого из них.

Успешный запрос

Для Webhook успешным считается ответ:

HTTP 200

То есть внешний сервис должен вернуть код 200, чтобы запрос считался успешно выполненным.

Что происходит при ошибке

Если внешний сервис возвращает ошибку, например:

HTTP 400
HTTP 404

ProCRM не выполняет автоматический повторный запрос.

Webhook
   ↓
HTTP 4xx
   ↓
No retry

Ошибка Webhook при этом сама по себе не останавливает дальнейшее прохождение Flow.

Webhook
   ↓
Request error
   ↓
Connection
   ↓
Next Step

Это важно учитывать при интеграциях, где успешная доставка данных во внешнюю систему критична.

Осторожно

Не рассчитывайте на автоматический retry Webhook при ошибке внешнего сервиса. Если запрос завершился ошибкой, ProCRM не отправляет его повторно автоматически.

Headers

Настройка собственных HTTP Headers в Webhook сейчас не поддерживается.

Если внешний API требует обязательные дополнительные Headers для авторизации или другого назначения, это ограничение необходимо учитывать при построении интеграции.

Webhook и дальнейший Flow

Webhook выполняет внешний запрос как действие Step.

После этого дальнейший маршрут определяется Connections.

Webhook
   ↓
HTTP request
   ↓
Connection
   ↓
Next Step

Сам Webhook не используется для выбора следующей ветки сценария.

Webhook Step и Webhooks & API

В ProCRM также присутствует раздел Webhooks & API в настройках Flow.

Это не то же самое, что Webhook Step.

Flow Settings
└── Webhooks & API
    → отдельный раздел настроек


MiniFlow
└── Webhook Step
    → HTTP-запрос во время сценария

Раздел Webhooks & API в Flow Settings находится в разработке.

Webhook Step уже используется как элемент автоматизации MiniFlow.

Пример

Допустим, при прохождении определённого этапа необходимо передать Lead ID во внешнюю систему:

AI Reply
   ↓
Webhook
   ↓
POST
   ↓
https://example.com/event
   ↓
Body с данными лида
   ↓
Connection
   ↓
Next Step

Webhook отправляет запрос, после чего Flow продолжает выполнение по настроенному маршруту.

Дальше: Note.