Робот «Вызвать веб-хук» — это способ на нужной стадии сделки отправить HTTP-запрос во внешнюю систему прямо из автоматизации CRM Битрикс24. Он превращает движение по воронке в триггер для 1С, ERP, платёжного шлюза или любого своего скрипта — без программиста и без выгрузок вручную.
Что делает робот «Вызвать веб-хук»
В автоматизации Битрикс24 есть два разных «вебхука», и их важно не путать. Входящий вебхук — это URL самого портала, по которому внешняя программа обращается к REST API Битрикс24 (создаёт сделку, читает контакт). Робот «Вызвать веб-хук» работает наоборот: он исходящий — портал сам отправляет запрос на адрес вашего внешнего сервиса, когда сделка доходит до заданной стадии.
По сути это HTTP-клиент внутри воронки. Вы указываете URL обработчика, набор параметров с данными сделки — и в момент срабатывания робот формирует запрос и отправляет его на сервер. Внешняя система принимает данные и делает свою работу: заводит заказ в 1С, резервирует товар на складе, дёргает стороннюю рассылку или ставит запись в очередь.
Когда он нужен, а когда нет
Робот-вебхук закрывает случаи, для которых нет готового штатного действия. Типичные задачи:
- Обмен с учётной системой — передать реквизиты и состав заказа в 1С, МойСклад или ERP при переходе в стадию «Оплачено».
- Вызов внешнего сервиса — генерация PDF на своём сервере, проверка контрагента по ИНН, запрос курса или тарифа.
- Нестандартные уведомления — отправка в сторонний SMS-шлюз, Telegram-бота или мессенджер, не подключённый к порталу штатно.
- Синхронизация с сайтом — обновить статус заказа в личном кабинете клиента на внешнем сайте.
Если же задача решается стандартными роботами — письмо, СМС через оператора Битрикс24, смена стадии, постановка задачи — берите их: они надёжнее и не требуют своего сервера. Вебхук оправдан там, где нужна логика вне портала.
Где найти и как добавить робот
Откройте CRM → нужную воронку → кнопку «Роботы» (раздел «Автоматизация»). Выберите стадию, на которой должен сработать вызов, и нажмите «Добавить». В каталоге действий робот лежит в группе Внешние сервисы под названием «Вызвать веб-хук».
Ключевые настройки в карточке робота:
- Обработчик — полный URL вашего скрипта, например
https://example.com/api/deal-handler.php. Только по HTTPS. - Условие выполнения — чтобы вызов уходил не для всех сделок, а по фильтру (сумма, источник, ответственный).
- Время выполнения — сразу или с задержкой/по расписанию, если внешняя система не должна получать запрос мгновенно.
- Параметры запроса — пары «имя–значение», в значения подставляются поля сделки через меню выбора.
Передача полей сделки в запрос
Данные из CRM подставляются в параметры через плейсхолдеры полей. В конструкторе значение выбирается из выпадающего списка, а в теле хранится как макрос вида {{ID}}, {{Название}}, {{Сумма}}, {{Ответственный}}. Доступны и пользовательские поля, и данные привязанных контакта/компании.
Пример набора параметров для передачи заказа во внешнюю систему:
| Параметр | Значение |
|---|---|
deal_id | {{ID}} |
amount | {{Сумма}} |
client_inn | {{ИНН}} (польз. поле) |
token | секретная строка |
Запрос уходит методом POST, параметры передаются как данные формы. Ваш обработчик читает их (в PHP — из массива $_POST) и работает с полученными значениями. Если внешней системе нужен именно JSON в теле — как правило, ставят промежуточный шлюз, который принимает форму от Битрикс24 и пересобирает её в нужный формат.
Разбор ответа и возвращаемые значения
Робот не только отправляет данные, но и умеет принять ответ внешней системы и использовать его дальше в воронке. Для этого в настройках робота описываются возвращаемые параметры — имена полей, которые сервис вернёт в ответе.
Внешний обработчик должен отдать ответ в формате, который Битрикс24 разберёт (обычно JSON), например: {"status":"ok","external_id":"A-1024"}. После этого значения становятся доступны в последующих роботах как результат этого действия — например {{~Вызвать веб-хук:external_id}}.
Это открывает связки: вебхук создал заказ в 1С и вернул его номер → следующий робот записывает этот номер в поле сделки и уведомляет менеджера. Так CRM и внешняя система остаются согласованными без ручной сверки.
Безопасность вызова
URL обработчика по факту открыт в интернет, поэтому его нужно защитить — иначе кто угодно сможет слать в вашу систему поддельные заказы.
- Секретный токен. Передавайте в параметрах статичный ключ и проверяйте его на стороне обработчика — запросы без верного токена отклоняйте.
- Только HTTPS. Робот работает по защищённому протоколу; проверьте, что у сервера валидный сертификат.
- Ограничение по IP. Если известны адреса, с которых Битрикс24 шлёт запросы, ограничьте доступ к обработчику на уровне веб-сервера.
- Валидация данных. Не доверяйте входящим значениям вслепую — проверяйте типы и диапазоны перед записью в 1С или БД.
И не кладите в параметры лишнее: передавайте внешней системе только те поля, которые ей реально нужны для работы.
Типичные ошибки и отладка
Когда вызов «не сработал», причина почти всегда в одном из пунктов ниже.
| Симптом | Вероятная причина |
|---|---|
| Робот выполнился, но данных нет | Обработчик недоступен, вернул ошибку 4xx/5xx или не читает POST |
| Робот вообще не запустился | Не выполнено условие или сделка перескочила стадию |
| Пустые значения в параметрах | Поле не заполнено в сделке на момент срабатывания |
| Возвращаемые значения не подставляются | Ответ не в JSON или имена полей не совпадают с настройкой |
Практический порядок диагностики: сначала проверьте журнал/историю робота в карточке сделки — там видно, отработал он или нет. Затем логируйте сырой входящий запрос на стороне обработчика: так вы увидите, что реально прислал Битрикс24. Для быстрой проверки удобно временно указать в URL тестовый приёмник (например, сервис-«эхо»), который просто показывает полученные параметры.
Итог
Робот «Вызвать веб-хук» — это мост между воронкой Битрикс24 и внешним миром: на нужной стадии портал сам отправляет данные сделки в 1С, ERP или свой сервис, а при желании принимает ответ и продолжает сценарий. Главное — защитить обработчик токеном и HTTPS, передавать только нужные поля и заранее продумать поведение при сбоях.
Мы в B2Bsite проектируем такие интеграции под конкретные процессы: описываем контракт обмена, поднимаем обработчик, связываем CRM с учётной системой и сайтом и отлаживаем сценарий до стабильной работы. Если нужен надёжный обмен между Битрикс24 и внешними системами — поможем собрать его без костылей.
Частые вопросы
Чем робот «Вызвать веб-хук» отличается от входящего вебхука?
Входящий вебхук — это URL портала, по которому внешние программы обращаются к REST API Битрикс24. Робот «Вызвать веб-хук» делает обратное: портал сам отправляет исходящий HTTP-запрос на адрес вашего сервиса при переходе сделки на стадию.
Каким методом робот отправляет запрос?
Запрос уходит методом POST, а параметры передаются как данные формы. Обработчик читает их из POST-данных, в PHP это массив $_POST.
Можно ли передать поля сделки в запрос?
Да. В параметрах значения подставляются через плейсхолдеры полей вроде {{ID}}, {{Сумма}} или {{Название}}, включая пользовательские поля и данные привязанных контакта и компании.
Как использовать ответ внешней системы?
В настройках робота описываются возвращаемые параметры. Если сервис вернёт их в ответе (обычно JSON), значения станут доступны следующим роботам как результат действия — например, для записи внешнего номера заказа в поле сделки.
Как защитить обработчик от посторонних?
Передавайте в параметрах секретный токен и проверяйте его на сервере, работайте только по HTTPS, при возможности ограничьте доступ по IP и валидируйте входящие данные перед записью.
Повторит ли робот вызов, если внешняя система недоступна?
По умолчанию нет — робот отправляет запрос один раз. Логику повторов и обработку сбоев нужно закладывать отдельно, например через задержку и проверку результата в следующем роботе.
Нужен ли программист для настройки?
Сам робот настраивается в интерфейсе без кода. Но на стороне внешней системы нужен обработчик, который принимает запрос и отвечает, — его обычно готовит разработчик.
Что делать, если данные не доходят до внешней системы?
Проверьте историю робота в карточке сделки, доступность и код ответа обработчика, заполненность передаваемых полей. Полезно временно залогировать сырой запрос на стороне сервиса, чтобы увидеть, что реально прислал Битрикс24.
Поможем с настройкой и поддержкой Битрикс24
Поможем с настройкой, доработкой и поддержкой Битрикс24.