Вебхук — это самый быстрый способ соединить 1С-Битрикс с внешней системой без разработки собственного модуля. Достаточно выпустить токен, указать событие или URL приёмника — и данные начинают ходить в реальном времени. Разбираем, где это работает, а где без кода уже не обойтись.
Что такое связка без разработки
Под «связкой без разработки» понимают обмен данными, при котором вы не пишете PHP-модуль, не создаёте агентов и не трогаете ядро. Вся логика собирается из готовых кирпичей: вебхука на стороне Битрикса и приёмника на стороне внешнего сервиса. Вебхук — это персональная точка доступа к REST API с ограниченным набором прав, привязанная к конкретному пользователю.
В экосистеме Битрикса вебхуки живут в модуле rest. Он есть в Битрикс24 «из коробки» и подключается к сайту на 1С-Битрикс (продукты «Малый бизнес», «Бизнес», «Энтерпрайз»). Именно модуль rest отвечает за скоупы, токены и вызов методов.
- Плюс подхода — скорость: рабочая связка собирается за часы, а не за недели.
- Минус — потолок сложности: как только нужна трансформация данных, дедупликация или сложная бизнес-логика, «без кода» превращается в «мало кода».
Входящие и исходящие вебхуки
Ключевое, что нужно понять до настройки, — направление потока данных. В Битриксе два типа вебхуков, и путать их нельзя.
| Тип | Кто инициирует | Что делает | Пример |
|---|---|---|---|
| Входящий (incoming) | Внешний сервис | Вызывает методы REST Битрикса по токену | CRM-система создаёт заказ в каталоге |
| Исходящий (outgoing) | Битрикс | Отправляет POST на ваш URL при событии | Новый лид ушёл в Telegram-бота |
Входящий вебхук — это URL вида https://ваш-домен/rest/1/xxxxxxxx/crm.deal.add.json. Внешняя система дергает его сама. Исходящий, наоборот, срабатывает на событие внутри портала (например, ONCRMLEADADD) и шлёт данные наружу.
- Нужно забирать данные из Битрикса по запросу — входящий вебхук.
- Нужно реагировать на событие в Битриксе — исходящий вебхук.
- Нужен двусторонний обмен — как правило, оба сразу.
Настройка вебхука по шагам
Разберём выпуск входящего вебхука в интерфейсе. Путь: Разработчикам → Другое → Вебхуки → Добавить вебхук → Входящий. Далее:
- Задайте набор прав (скоупов). Не выдавайте всё подряд — только нужные:
crm,catalog,user. - Скопируйте сгенерированный URL с токеном. Токен показывается один раз при создании.
- Проверьте вызов простым методом, например
profile, чтобы убедиться в правах.
Пример вызова методом cURL для создания сделки:
curl -X POST "https://portal.bitrix24.ru/rest/1/TOKEN/crm.deal.add.json" -d "fields[TITLE]=Заявка с сайта&fields[OPPORTUNITY]=15000"
Ответ придёт в JSON с result — ID созданной сущности. Исходящий вебхук настраивается похоже, но там вы выбираете событие и указываете URL обработчика — адрес, куда Битрикс отправит POST-запрос с полями события.
1 в URL — это ID пользователя, от имени которого работает вебхук. Все действия и права наследуются от него, поэтому заводите отдельного сервисного пользователя.Авторизация и безопасность
Вебхук — это фактически логин и пароль в одной строке. Утёкший URL даёт злоумышленнику все права привязанного пользователя. Поэтому к безопасности относимся серьёзно.
- Минимум прав. Скоупы выдаём по принципу наименьших привилегий. Вебхуку для приёма заявок не нужен доступ к пользователям и настройкам.
- Отдельный пользователь. Заведите сервисный аккаунт без прав администратора — при компрометации ущерб ограничен.
- HTTPS обязателен. Токен в URL по HTTP виден в открытом виде на каждом узле сети.
- Ротация. Периодически перевыпускайте токен и обновляйте его в подключённых сервисах.
- Проверка источника. Для исходящих вебхуков валидируйте
application_tokenна приёмнике, чтобы отсечь подделки.
Как собрать обмен без кода
Сам вебхук — только точка доступа. Чтобы связать два сервиса без программиста, между ними ставят коннектор или no-code платформу, которая умеет ходить в REST по HTTP.
- Готовые приложения Маркетплейс. Для типовых связок (мессенджеры, телефония, платёжки) часто есть готовое приложение — настройка сводится к вводу вебхука.
- No-code оркестраторы. Платформы-интеграторы принимают исходящий вебхук, преобразуют данные и вызывают входящий у другой системы.
- Формы и триггеры. Штатные веб-хуки CRM-форм и бизнес-процессов покрывают часть сценариев без внешних инструментов.
Такая схема закрывает 70–80% простых задач: «заявка с лендинга → сделка в CRM», «оплата → уведомление в Telegram», «новый заказ → строка в таблице».
Границы применимости
Честно обозначим, где вебхуки без разработки перестают справляться. Это поможет не загнать проект в тупик.
| Сценарий | Вебхук справится? |
|---|---|
| Единичные события, малые объёмы | Да |
| Сложная трансформация и маппинг полей | Частично |
| Дедупликация и разрешение конфликтов | Нет |
| Пакетная выгрузка тысяч товаров | Нет, нужен batch/CommerceML |
| Гарантированная доставка и повторы | Нет, нужна очередь |
REST Битрикса ограничивает частоту запросов (rate limit) и размер батча. При интенсивном потоке событий без буферизации и очереди начнутся потери. В этих случаях переходят к собственному модулю обмена или полноценной интеграции.
Итог
Вебхуки — это правильная точка старта: они позволяют за один день соединить сайт на 1С-Битрикс с CRM, мессенджером или таблицей без единой строки кода. Главное — держать в голове разницу между входящим и исходящим направлением, выдавать минимум прав и не публиковать токены.
Когда обмен перерастает событийную модель — появляются объёмы, конфликты и требования к надёжности — мы в B2Bsite проектируем полноценную интеграцию: собственный модуль обмена, очереди и идемпотентность. Начать можно с вебхуков, а вырасти до промышленной связки без потери наработок.
Частые вопросы
Чем вебхук отличается от полноценного приложения REST?
Вебхук привязан к конкретному пользователю и не требует авторизации по OAuth. Приложение работает от имени портала, поддерживает установку у клиентов и обновляемые токены. Для внутренних связок хватает вебхука, для тиражируемого продукта нужно приложение.
Можно ли настроить вебхук на обычном сайте 1С-Битрикс, а не в Битрикс24?
Да, если установлен модуль rest. Он входит в редакции для бизнеса и подключается к сайту. Механика вебхуков там та же, что и в Битрикс24.
Что делать, если токен вебхука попал в открытый доступ?
Немедленно удалите вебхук в настройках и выпустите новый. Все системы, которые им пользовались, нужно перенастроить на свежий URL. Старый токен после удаления перестаёт работать сразу.
Есть ли ограничение на количество запросов?
Да, REST Битрикса применяет rate limit на число вызовов в единицу времени. При превышении метод возвращает ошибку, поэтому интенсивный обмен буферизуют и распределяют во времени.
Как понять, что исходящий вебхук действительно сработал?
Битрикс отправляет POST на ваш URL и ожидает ответ. Настройте на приёмнике логирование входящих запросов и проверьте, что событие пришло с ожидаемыми полями и корректным application_token.
Нужно ли создавать отдельного пользователя под вебхук?
Настоятельно рекомендуется. Сервисный пользователь без прав администратора ограничивает ущерб при утечке токена и упрощает аудит действий интеграции в логах.
Подойдут ли вебхуки для обмена каталогом с 1С?
Для больших каталогов — нет. Выгрузку товаров, цен и остатков делают через CommerceML или пакетные методы. Вебхуки хороши для событий: новый заказ, смена статуса, уведомление.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.