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

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

Вебхуки работают по принципу «событие — действие»: когда в Битрикс24 происходит что-то важное (например, добавляется новый контакт), система автоматически отправляет уведомление на указанный внешний адрес. Это позволяет связать CRM с сайтом, телефонией, чат-ботами или любой другой системой, которая умеет принимать HTTP-запросы. На практике это означает, что вы можете полностью убрать рутинные операции: данные не нужно переносить вручную, а сотрудники получают информацию в тот момент, когда она становится актуальна. Профессиональное внедрение Битрикс 24 часто включает настройку вебхуков как один из ключевых этапов автоматизации, но даже базовые сценарии можно реализовать самостоятельно, следуя нескольким простым правилам.

Что такое вебхук и зачем он нужен

Вебхук — это программный код, с помощью которого можно отслеживать изменения на одном сайте и передавать данные об этом на другой. По сути, это просто HTTP-запрос, который Битрикс24 отправляет на заданный URL-адрес, когда происходит определенное событие. Представьте, что внутри CRM есть «почтовый ящик», который постоянно слушает сигналы извне, и «курьер», который бежит доставлять сообщения наружу, как только случается что-то важное.

Вебхуки бывают двух типов: входящие и исходящие. Входящие вебхуки позволяют внешним системам (ваш сайт, мобильное приложение, телефония) управлять Битрикс24: создавать лиды, обновлять сделки, добавлять задачи. Например, когда пользователь заполняет форму на сайте, ваш сервер может вызвать вебхук, и в CRM автоматически появится новый контакт с заполненными полями. Исходящие вебхуки, наоборот, отправляют данные из Битрикс24 во внешние системы. Скажем, когда менеджер переносит сделку в стадию «Оплачено», CRM может отправить уведомление в ваш складской или бухгалтерский сервис.

Настройка вебхука: пошаговая инструкция

Создать вебхук в Битрикс24 может практически любой пользователь. Всё делается в несколько кликов прямо в интерфейсе.

1. Перейдите в раздел «Разработчикам». В левом меню найдите пункт «Приложения» и выберите вкладку «Разработчикам».
2. Выберите тип вебхука. На вкладке «Готовые сценарии» перейдите в раздел «Другое» и выберите «Входящий вебхук».
3. Скопируйте или сгенерируйте URL. Система автоматически предложит готовый URL с уникальным секретным кодом. Это ваш «ключ» к API, который нельзя никому передавать.
4. Настройте права доступа. В блоке «Настройка прав» отметьте, к каким модулям CRM должен иметь доступ ваш вебхук (например, «Контакты», «Сделки»). Это ограничит возможный ущерб, если код случайно попадет в чужие руки.

Готовый URL для запроса выглядит примерно так: https://ваш-битрикс24.bitrix24.ru/rest/1/ваш_секретный_код/. Этот адрес и будет вашей точкой входа для вызова методов API из внешних систем.

Как использовать входящие вебхуки

Допустим, вы хотите автоматически создавать лиды в Битрикс24 с вашего лендинга. Для этого ваш сервер должен отправить POST-запрос на URL входящего вебхука, добавив в конце метода вызываемый метод и параметры.

Пример запроса для создания лида:

https://ваш-битрикс24.bitrix24.ru/rest/1/ваш_секретный_код/crm.lead.add.json?fields[TITLE]=Название&fields[NAME]=Имя&fields[PHONE][0][VALUE]=+7123456789

Здесь crm.lead.add — это метод API, а fields — параметры с данными нового лида.

Важно помнить, что запросы выполняются с правами пользователя, который создал вебхук. Поэтому, например, если вам нужно автоматически назначать ответственного, убедитесь, что у «владельца» вебхука есть права на изменение этих полей.

Настройка исходящих вебхуков и подписка на события

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

Схема такая:

1. Вы создаете обработчик на своем сервере — простой скрипт, который слушает POST-запросы по определенному адресу.
2. В Битрикс24 вы подписываетесь на нужное событие (например, onCrmDealAdd) и указываете URL вашего обработчика.
3. Теперь при создании новой сделки Битрикс24 отправит POST-запрос на ваш сервер с данными о ней.

Событий, доступных для подписки, десятки: onCrmDealAdd (добавление сделки), onCrmDealUpdate (обновление), onCrmContactAdd (добавление контакта) и многие другие.

Практический пример: автоматизация уведомлений

Представьте, что при переходе сделки в стадию «Успешно завершена» менеджер каждый раз вручную отправляет письмо в бухгалтерию и сообщение в склад. С вебхуками это можно автоматизировать.

Настройка такая:

• Создаете обработчик на своем сервере, который принимает POST-запросы.
• В Битрикс24 настраиваете исходящий вебхук на событие onCrmDealUpdate. Добавляете условие: срабатывать только тогда, когда стадия сделки изменилась на «Успешно завершена».
• В обработчике пишете код: отправьте письмо в бухгалтерию, создайте задачу на склад или отправьте уведомление в чат-бот.

В результате менеджер просто двигает сделку, а все остальные действия выполняются автоматически.

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

Иллюстрация к статье: Яндекс.Картинки