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

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

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

Вебхук (webhook) — это механизм, при котором одна система отправляет POST-запрос на указанный URL другой системы в момент наступления определённого события. В отличие от классического API-опроса, где приложение регулярно спрашивает сервер «есть ли новые данные?», этот инструмент работает в режиме push: система сама уведомляет обработчика, как только что-то произошло.

В контексте Битрикс24 такой механизм используется для интеграции CRM с внешними системами: сервисами аналитики, мессенджерами (например, Telegram), таблицами Google Sheets, складскими программами и многим другим. Благодаря этому разработчикам не нужно создавать сложные приложения — достаточно настроить передачу данных по определённым событиям.

На практике чаще всего такую интеграцию применяют для следующих задач:

• уведомление внешнего сервиса о создании сделки или лида в CRM;
• передача данных о новых контактах в email-маркетинговые платформы;
• синхронизация заказов с внешними системами складского учёта;
• автоматизация задач на основе действий менеджера в карточке клиента;
• подмена номера телефона — например, phone подмена номера — для телефонии и колл-трекинга, где источником номеров телефонов выступает сам портал.

Виды вебхуков в Битрикс24

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

Входящий вебхук (Inbound Webhook)

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

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

Исходящий вебхук (Outbound Webhook)

Исходящий вебхук работает в обратном направлении: Битрикс24 сам отправляет данные на указанный адрес обработчика при наступлении определённого события. Например, при появлении нового лида система может автоматически отправить POST-запрос в ваш сервис аналитики или бот в Telegram.

Исходящий механизм — основа автоматизации. Он реагирует на события в CRM (добавление сделки, изменение статуса, входящий звонок) и мгновенно уведомляет внешние системы. Именно в этом сценарии вебхуки становятся настоящим инструментом автоматизации бизнес-процессов.

Как создать входящий вебхук в Битрикс24: пошаговая инструкция

Разберём процесс создания на практике. Важно: для выполнения этих действий у вас должны быть права администратора на портале Битрикс24.

1. Перейдите в меню Битрикс24 и откройте раздел «Приложения».

В левой панели навигации найдите пункт «Приложения» и нажав на него, перейдите в раздел управления интеграциями портала.

1. Выберите «Вебхуки».

В разделе приложений найдите соответствующий пункт. Здесь отображается список всех ранее созданных интеграций портала.

1. Нажмите кнопку создать и выберите тип «Входящий».

Нажмите кнопку «Создать» и в появившемся окне выберите нужный тип. Система предложит форму настройки.

1. Укажите название и настройте права доступа.

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

1. Сохраните и скопируйте ссылку.

После сохранения система сгенерирует уникальный URL. Это и есть адрес обработчика — ссылку нужно скопировать и использовать в вашем внешнем приложении для отправки запросов в Битрикс24.

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

Как создать исходящий вебхук в Битрикс24

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

1. Перейдите в «Приложения» → «Вебхуки» и нажмите кнопку создать.

Аналогично первым шагам из предыдущего раздела.

1. Выберите «Исходящий вебхук».

В форме создания выберите соответствующий тип.

1. Укажите URL обработчика.

В поле URL введите адрес вашего сервера или внешнего сервиса, который будет принимать и обрабатывать данные. Этот сервер должен уметь принимать POST-запрос и отдавать корректный ответ.

1. Добавьте события для отслеживания.

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

1. Укажите название и сохраните.

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

Активити вебхук: использование в бизнес-процессах

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

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

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

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

С помощью вебхуков можно реализовать самые разные сценарии. Вот наиболее популярные из них:

• Интеграция с Telegram. При появлении нового лида в CRM Битрикс24 исходящий вебхук мгновенно отправляет сообщение боту в корпоративный чат — менеджер сразу получает уведомление.
• Выгрузка в Google Sheets. Каждая новая сделка или контакт из CRM автоматически добавляется в таблицу для отчётов и аналитики — без ручного труда.
• Phone подмена номера телефона на телефон. Например phone подмена номера: при входящем звонке система передаёт номера телефонов в колл-трекинг, где источником номеров является сам корпоративный портал Битрикс24.
• Синхронизация с сайтом. Входящий запрос принимает данные из форм на сайте и создаёт лидов в Битрикс24 автоматически, без участия менеджера.
• Передача данных в облачный сервис. Можно интегрировать Битрикс24 с облачными решениями: складскими системами, ERP, сервисами email-рассылок и другое.

Вебхуки и REST API Битрикс24: в чём разница

Вебхуки в Битрикс24 тесно связаны с REST API портала. По сути, входящий тип — это упрощённый способ вызова методов REST API без необходимости создавать полноценное приложение с OAuth-авторизацией.

Когда вы создаёте входящий вебхук, система генерирует уникальный URL, в котором уже зашит ключ доступа (id пользователя и токен авторизации). Благодаря этому можно вызывать методы API напрямую, передавая нужные параметры в строке запроса или теле POST-запроса.

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

Вместе с тем важно понимать ограничения: инструмент привязан к конкретному пользователю и действует с его правами. Если этот пользователь будет удалён с портала, интеграция перестанет работать. Для продакшн-решений рекомендуется создавать вебхуки от имени технического аккаунта, а для более сложных задач — регистрировать полноценные приложения через Bitrix24 REST.

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

Разберём наиболее частые проблемы, с которыми сталкиваются при настройке интеграций в Битрикс24:

• Неверный URL обработчика. Сервер, который ранее создали для приёма данных, должен быть доступен из интернета. Локальный адрес (например, localhost) не подойдёт — запрос просто не достучится до обработчика.
• Недостаточно прав. Если вебхук создан с ограниченными правами, он не сможет выполнять нужные действия. Например, не получится создать сделку в CRM, если у него нет доступа к соответствующему разделу.
• Обработчик не возвращает корректный ответ. Для исходящих запросов и активити вебхука сервер должен отдавать HTTP 200. Если ответ некорректный, Битрикс24 посчитает отправку неудачной.
• Пользователь, которому принадлежит интеграция, удалён с портала. В этом случае она перестаёт работать. Решение — пересоздать вебхук от имени активного пользователя.
• Превышен лимит запросов. Битрикс24 ограничивает количество API-запросов в секунду. При высоких нагрузках нужно предусмотреть очередь на стороне вашего сервиса.

Советы по работе с вебхуками в Битрикс24

Чтобы интеграции работали надёжно и эффективно, придерживайтесь нескольких простых правил.

• Давайте понятные названия. Когда интеграций накапливается много, сложно понять, которую из них ранее создали для конкретной задачи. Используйте описательные имена, например: «Форма сайта → CRM лид» или «CRM сделка → Google Sheets».
• Логируйте входящие запросы. На стороне вашего сервера сохраняйте все входящие вебхуки — это поможет быстро найти ошибку и понять, какие данные приходят от Битрикс24.
• Не публикуйте URL вебхука. Ссылка содержит ключ авторизации. Если она попадёт в открытый доступ, злоумышленники смогут отправлять данные в ваш Битрикс24 или читать информацию из CRM.
• Используйте готовые решения. Если интеграция стандартная (например, с Telegram или Google Sheets), проверьте маркетплейс Битрикс24 — там есть готовые приложения, которые настраиваются без программирования.
• Регулярно проверяйте список. Удаляйте те интеграции, которые больше не используются — это упорядочивает интерфейс портала и снижает риски безопасности.

Заключение

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

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

Если вы только начинаете работать с интеграциями, рекомендуем стартовать с входящего типа — он проще в настройке. Для автоматизации реакций на события в CRM переходите к исходящим вебхукам. А для встраивания в бизнес-процессы используйте активити вебхук. Подробнее о других возможностях API и интеграций читайте в нашем блоге.