WebhookToolkit24

Входящие и исходящие вебхуки Bitrix24

Обзор

Входящий вебхук — постоянная ссылка вида https://ваш-портал.bitrix24.ru/rest/1/код/, по которой внешние системы вызывают REST-методы без OAuth. Создаётся в разделе разработчика портала.

Исходящий вебхук (обработчик событий) — URL вашего сервера, на который Bitrix24 отправляет уведомления при событиях (новый лид, сделка и т.д.). Регистрация через REST: event.bind (в контексте локального приложения).

Робот CRM / автоматизация — вкладка «Установка БП»: регистрация правила через bizproc.robot.add. Нужны права администратора и HTTPS-обработчик на домене, с которым согласовано приложение (см. документацию Bitrix24).

Загрузка профиля…

Полезные ссылки

Робот автоматизации (bizproc.robot)

Методы доступны только в контексте установленного локального приложения. Обычно требуется администратор портала. URL HANDLER должен быть доступен снаружи (HTTPS); по правилам Bitrix24 он должен быть на том же домене, что и приложение — уточните для вашего сценария в документации.

В репозитории приложения есть файл-пример обработчика robot-handler.example.php — скопируйте на свой сервер и укажите путь ниже.

Регистрация с USE_SUBSCRIPTION = N: процесс не ждёт ответа от сервера. Для возврата данных в БП нужны USE_SUBSCRIPTION = Y, RETURN_PROPERTIES и вызов bizproc.event.send в обработчике — это настраивается отдельно по документации.

bizproc.robot.list

—

Входящий вебхук

Вставьте базовый URL вебхука (со слэшем в конце). Данные сохраняются в браузере (localStorage).

Итоговый URL

—

Прямой вызов из браузера к URL портала часто блокируется CORS. Ниже — вызов тем же методом через сессию приложения (как в iframe Bitrix24).

Ответ

—

Зарегистрированные обработчики

event.get / event.bind работают в контексте локального приложения. event.unbind — только у администратора портала.

Событие Handler URL auth_type
Нажмите «Обновить список»

Привязать обработчик (event.bind)

Тест запросов

Для Bitrix REST при GET параметры метода передаются в URL (query), а не в теле. Либо выберите POST и оставьте JSON в теле — так работает типичный вызов входящего вебхука.

Результат

—