Вебхуки в Битрикс24: руководство по настройке и использованию

04.03.2026 Еще не оценен

Руководство по настройке и использованию вебхуков в Битрикс24

Вебхуки в Битрикс24 помогают настроить автоматический перенос данных из CRM в другие сервисы. Событие в системе запускает нужный сценарий, а дальше интеграция проходит без ручного участия. Это снижает нагрузку на команду, и процессы работают стабильно.

Вебхуки Битрикс 24

Принцип работы вебхука

принцип работы вебхука.png

Источник thecode.media

Вебхуки работают на основе HTTP-запросов между сервисами. Когда происходит определённое событие, например менеджер создаёт карточку сделки, система отправляет запрос на заданный адрес. Этот адрес указывает на обработчик — скрипт или сервис, который обрабатывает данные или получает их и запускает процесс.

Битрикс24 — источник или получатель событий, а ваш сайт или другой сервис — точка приёма или отправки данных. С этим механизмом вы можете автоматизировать триггерные сценарии: событие в одной системе инициирует запрос и приводит к выполнению действия в другой.

Типы вебхуков

В системе можно создать вебхук Битрикс24 двух типов — входящие и исходящие.

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

Битрикс24 входящий вебхук инициирует действие на стороне CRM из внешней системы.

Вы сможете:

автоматически создавать контакты, сделки и кампании;
обновлять поля сущностей по событию во внешней системе;
запускать роботов, бизнес-процессы по записям, другие события, которых более 100 в документации CRM.

Частый пример использования — заявки с формы на сайте. Посетитель заполняет форму, ваш сервер обрабатывает данные и вызывает входящий вебхук Битрикс24. В результате в CRM появляется лид с нужными полями, а менеджер получает уведомление и связывается с клиентом. Вебхуки масштабируются: можно подключить один и тот же сценарий к нескольким сайтам и отслеживать их по меткам.

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

Работают в обратную сторону — при событии внутри Битрикс24 система отправляет HTTP-запрос на внешний адрес. Так можно уведомлять другие сервисы о событии в CRM, задачах или других модулях.

Например, можно настроить Битрикс24 исходящий вебхук, который срабатывает, если вы поменяли стадию сделки или получили предоплату. Битрикс24 направляет данные вашему приложению, и оно выполняет нужное действие:

отправляет сообщение через SMS API или уведомление в мессенджер;
создаёт карточку во внешней системе поддержки;
запускает внутренний скрипт для расчёта показателей;
обновляет информацию в сторонней базе.

Настройка вебхуков в Битрикс24 помогает объединять сервисы в единую экосистему: CRM выступает источником событий, а внешние системы — исполнителями действий. Так вы выстраиваете цепочки: сделка перешла на этап → отправили уведомление → создали задачу → обновили показатели.

Как работают вебхуки в Битрикс24

Чтобы проектировать интеграции, важно понимать общую схему работы вебхуков и формат данных, которые они передают. Это помогает выстроить логику на стороне вашего сервера или приложения и избежать ошибок.

Схема работы

Общая схема для большинства сценариев:

В CRM происходит ожидаемое событие;
Система отправляет HTTP-запрос на ваш сервер, шлюз интеграций или любой другой обработчик, доступный по API;
Обработчик принимает запрос, проверяет данные и выполняет действие: создаёт запись события, отправляет уведомления, запускает скрипты;
Обработчик присылает ответ с результатом обработки или молча принимает запрос.

В этой схеме Битрикс24 вебхук — связующее звено: он передаёт данные на указанный адрес и доставляет запрос. Дальнейшая логика действий — на стороне обработчика.

Формат данных и особенности передачи

Вебхуки работают со стандартными HTTP-запросами и REST API — программным интерфейсом для обмена данными. Для входящих вебхуков внешняя система формирует запрос на специальный адрес: передаёт параметры в строке запроса или в теле POST-запроса. Часто это поля вида fields[...], идентификаторы сущностей, фильтры и прочие параметры, которые есть в документации конкретного REST-метода. В ответ Битрикс24 возвращает JSON-структуру с результатом — данными сущности или сообщением об ошибке.

Для исходящих вебхуков Битрикс24 сам отправляет POST-запрос. В теле запроса приходят служебные параметры: тип события, токен приложения и набор данных о сущностях: ID сделки, контакта, задачи, значения полей. На стороне вашего сервера система обрабатывает эти данные как обычные POST-параметры и при необходимости преобразует их во внутренние JSON-объекты.

Например, если вы обновили сделку, Битрикс24 через исходящий вебхук отправит обработчику JSON следующего вида:

{
  "event": "ONCRMDEALUPDATE",
  "event_handler_id": "201",
  "data": {
    "FIELDS": {
      "ID": "759"
    }
  },
  "ts": "1736912442",
  "auth": {
    "access_token": "m2f4t81qv0nz7rj5cse9g0y4pw3b1hdk",
    "expires_in": "3600",
    "scope": "crm,crm_lead,crm_deal",
    "domain": "example-company.bitrix24.ru",
    "server_endpoint": "https://oauth.bitrix24.com/rest/",
    "status": "T",
    "client_endpoint": "https://example-company.bitrix24.ru/rest/",
    "member_id": "f91a2b43e7650db22156a50a890bd997",
    "refresh_token": "v1a7e8q0s44kmtu39b9j4zps8f0qyz32",
    "application_token": "b6bd8e13a1cf42e3b258eb9bb948fa7e"
  }
}

Обработчик может:

взять значение data.FIELDS.ID, чтобы запросить полные данные сделки через REST API;
опираться на блок auth, чтобы проверить источник события или выстроить дальнейшие запросы к Битрикс24.

Для сложных сценариев дополните схему: создайте небольшое Битрикс24 локальное приложение или микросервис, который работает посредником между CRM и внешними сервисами. Такой слой проверяет данные, преобразует формат, ставит задачи в очередь и обращается к другим API. Это облегчает поддержку, и вы сможете постепенно усложнять сценарии, а не переписывать каждую интеграцию с нуля.

Почему стоит выбрать виртуальную АТС МТС Exolve.png

Примеры использования вебхуков на практике

Автоматизация CRM-процессов

Используйте вебхуки, чтобы ускорить работу с лидами и сделками.

Например:

Создавайте заявки из форм на сайте. Посетитель заполняет форму, и сайт отправляет данные во входящий вебхук Битрикс24 — в CRM появляется лид с пометкой источника. Далее менеджер получит уведомление автоматически поставить задачи смежным отделам и отправить потенциальному клиенту по SMS API подтверждение.
Обновляйте контакты из учётной системы. Если вы ведёте основную базу клиентов в 1С, система будет периодически обновлять данные в CRM: телефоны, e-mail, статусы договоров, суммы. Интегрируйте CRM с телефонией МТС Exolve, чтобы подгружать в Битрикс24 историю и аналитику звонков.
Синхронизируйте данные с почтой. При переходе сделки на определённый этап система отправит данные в почтовый сервис — чтобы обновить сегмент или запустить рассылку.

Интеграция с мессенджерами и таск-менеджерами

Вебхуки передают важные события из CRM в каналы, где общается команда.

Уведомления в Telegram или другие мессенджеры
Исходящий Битрикс24 вебхук отправляет данные боту — по событию сделки, изменению стадии или суммы. Бот уведомляет отдел продаж в общем чате или отправляет индивидуальное сообщение менеджерам. Команда может быстро реагировать даже с телефона.

Создание задач в таск-менеджере
Вебхуки создают задачи для менеджеров по событиям в Битрикс24: новой заявке, запросу клиента или повторным обращениям.

Создание встреч в календаре
При назначении встречи с клиентом CRM отправляет данные в календарь. Менеджер видит все события в едином расписании.

Вебхуки — связующее звено между системами, логика действий остаётся на внешних обработчиках. С таким подходом проще менять сценарии: перестраивать CRM не нужно — достаточно адаптировать обработчик.

Лучшие практики работы с вебхуками

Безопасность и защита данных

Если вебхуки передают личные данные клиентов или служебную информацию, соблюдайте базовые меры защиты:

проверяйте формат и значения входящих данных;
используйте HTTPS для всех конечных точек, чтобы снизить риск перехвата трафика;
минимизируйте права пользователя, от имени которого работает вебхук;
используйте дополнительную проверку запросов — по подписи, IP-адресу или токенам в заголовках.

Чем больше интеграций, тем важнее документировать, какие вебхуки за что отвечают и у кого есть доступ к их настройке.

Оптимизация очередей, логов и мониторинга

Следите не только за кодом, но и за инфраструктурой:

используйте очереди или фоновые задания для обработки сложных сценариев, чтобы не зависеть от времени ответа одного запроса;
сохраняйте в логах ключевые события: успешные вызовы, ошибки, тайм-ауты, неожиданное содержимое параметров;
настраивайте мониторинг: оповещения при росте числа ошибок, задержек, недоступности конечных точек.

При большом числе интеграций помогает единый стандарт: формат адресов, правила именования, структура логов и алертов.

Заключение

Вебхуки в Битрикс24 — инструмент для интеграции CRM с внешними системами. Сервис автоматически создаёт контакты, синхронизируется с учётными системами, отправляет уведомления и работает по другим сценариям.

При системном подходе вебхуки станут устойчивым элементом архитектуры: от первых простых интеграций до сценариев, где Битрикс24 связывает между собой десятки сервисов и внутренних приложений.

Оцените статью: