Вебхуки в Битрикс24 — это инструмент для интеграции и автоматизации процессов с помощью REST API. Они позволяют обмениваться данными между Битрикс24 и внешними сервисами, а также оптимизировать рабочие процессы внутри системы. В этой статье мы подробно расскажем, как создать входящий и исходящий вебхук, настроить его для автоматизации задач, приведем несколько практических примеров использования и расскажем о методах GET и POST.
Что такое вебхуки в Битрикс24
Вебхуки — это механизм, который позволяет отправлять и получать данные через REST API Битрикс24. С их помощью можно интегрировать Битрикс24 с другими приложениями или автоматизировать бизнес-процессы внутри системы.Их существует два типа:
- Входящие вебхуки: для получения данных из внешних систем в Битрикс24.
- Исходящие вебхуки: для отправки данных из Битрикс24 в другие системы.
Это мощный инструмент для работы с различными модулями Битрикс24, такими как CRM, задачи и другие, а также для интеграции с внешними сервисами.
Как создать входящий вебхук
Возможность создавать вебхуки и приложения можно только по подписке Битрикс24 Маркетплейс.Для создания выполните несколько простых шагов:
-
Перейдите в раздел Маркет разработчикам в настройках вашего портала. Откройте Приложения → Разработчикам → Готовые сценарии → Другое → Входящий вебхук.
URL формируется из нескольких ключевых компонентов:
Базовый адрес портала - указывает на ваш экземпляр Битрикс24 (например: doc-test-b24.bitrix24.ru)
Сегмент /rest - обозначает, что запрос будет обрабатываться через REST API
ID - цифровой код (например /1), который соответствует: Аккаунту создателя вебхука и учётной записи, от имени которой будут выполняться операции
Уникальный токен - случайно сгенерированная строка (в примере: 173glortu42lvpju), которая выступает в качестве секретного ключа, обеспечивает безопасность подключения и генерируется системой при создании вебхука
В запросах можно указывать фильтры, сортировку и другие параметры. Например, чтобы получить задачи, назначенные на конкретного пользователя, можно использовать фильтрацию по ID пользователя или по дате.
Далее проверьте работу вебхука. Нажмите кнопку «Выполнить», чтобы убедиться в корректной настройке.
3. Настройте права доступа. Ограничьте доступ, разрешив выполнение запросов только доверенным инструментам.
После настройки система сгенерирует уникальный URL, который нужно использовать для отправки данных из внешних систем в Битрикс24.
Примеры использования вебхуков
Для вывода всех задач используйте метод task.list. Он позволяет получить перечень активных задач с их основными параметрами, такими как статус, исполнитель и сроки выполнения.Новые задачи добавляются методом task.add. При формировании запроса укажите:
- Родительскую задачу (если требуется). Связь с родительской задачей устанавливается через параметр PARENT_ID, где указывается ID основной задачи. Его можно получить через task.list или при создании задачи.
- Группу или проект. Для привязки задачи к проекту укажите GROUP_ID — идентификатор группы, который доступен через методы sonet_group.add (создание) или sonet_group.get (получение списка групп).
Для интеграции с CRM и другими модулями полезен метод lists.element.add. Например, он позволяет автоматически создавать элементы списков при изменении сделки. Этот механизм особенно удобен для настройки сложных бизнес-процессов, таких как формирование заказов или контроль этапов работы.
Таким образом, комбинация методов task.list, task.add и lists.element.add позволяет гибко управлять задачами и данными, автоматизируя рутинные операции в Битрикс24. Для успешной реализации важно корректно передавать идентификаторы связанных объектов (задач, групп) в параметрах запросов.
Методы GET и POST
Выбор метода HTTP-запроса зависит от того, что именно вы хотите сделать:
- GET используется для получения данных (например, для запроса списка задач).
- POST используется для отправки данных (например, для создания или изменения задач).
Параметры можно передавать как в адресной строке (для GET), так и в теле запроса (для POST).
Как настроить в Битрикс24 исходящий вебхук
-
Перейдите в раздел разработки: Приложения → Разработчикам → Готовые сценарии → Другое → Исходящий вебхук.
-
В открывшейся форме укажите следующие параметры:
- Название вебхука, которое поможет вам идентифицировать его.
- URL обработчика, то есть внешний ресурс, куда будут отправляться данные.
- Событие, которое будет запускать вебхук.
Требования к URL обработчика:
Указанный адрес должен быть:
- Доступен из публичной сети (не используйте localhost или внутренние адреса)
- Оснащен валидным SSL-сертификатом (самоподписанные сертификаты не поддерживаются)
- Протестирован через внешние сервисы проверки доступности
Реализация обработчика:
На стороне вашего сервера необходимо разместить код, который будет:
- Проверять токен для подтверждения источника запроса.
- Обрабатывать полученные данные и выполнять нужные действия в ответ на событие.
Примеры использования:
- Автоматическое создание задач.
- Синхронизация данных с внешними системами.
- Отправка уведомлений при изменении статусов и другие сценарии.
Для успешной реализации рекомендуется внимательно изучить документацию по REST API Битрикс24 и протестировать работу вебхука в тестовом окружении перед внедрением.
Отладка и мониторинг
- Журнал вызовов: Доступен в разделе Разработчикам → Вебхуки → История вызовов. Показывает статус (успех/ошибка), время выполнения и данные запроса.
- Тестовые данные: В интерфейсе вебхука есть кнопка «Отправить тестовые данные» для проверки обработчика без реальных событий.
Тестирование вебхуков
Для тестирования вебхуков можно использовать браузер или специализированные инструменты, такие как Insomnia. Эти инструменты позволяют удобно настроить запросы с методами POST и GET, передавая параметры в JSON-формате.
Если запрос корректный, вы получите ответ в формате JSON, который можно использовать для дальнейшей работы.
Вебхуки в Битрикс24 — это не просто технология, а ключевой инструмент для создания гибких и эффективных бизнес-решений.
Они позволяют:✔ Автоматизировать рутинные операции – от создания задач до обработки данных в CRM, экономя время сотрудников.
✔ Интегрировать Битрикс24 со сторонними сервисами – платежными системами, ERP, мессенджерами и другими платформами.
✔ Реализовывать нестандартные сценарии – например, автоматическое создание сделок при заказе на сайте или оповещение в Telegram о важных событиях.
✔ Обеспечивать мгновенную реакцию системы – работают в реальном времени, без задержек на опрос API.
Использование вебхуков снижает нагрузку на сотрудников, минимизирует ошибки и повышает эффективность работы с данными. Если вашей компании нужна точечная автоматизация без сложных доработок – вебхуки в Битрикс24 станут оптимальным решением.
Начните с простых сценариев (например, автоматическое создание задач), а затем расширяйте интеграции, используя весь потенциал REST API Битрикс24.
Если вам нужна помощь в настройке вебхуков или интеграции с Битрикс24, вы можете обратиться в ProfiCRM. Свяжитесь с нами по телефону +7 495-256-29-09 или через специальную форму на сайте для получения профессиональной помощи и консультаций.
