Что такое REST API и вебхуки в Битрикс24 и зачем они нужны?
REST API Битрикс24 — это набор методов, через которые внешние программы читают и изменяют данные портала: создают лиды, обновляют сделки, ставят задачи. Входящий вебхук — адрес с секретным ключом для вызова этих методов без регистрации приложения. Исходящий вебхук отправляет уведомление на ваш сервер, когда в портале происходит событие, например создана сделка. Через них подключают сайты, 1С и собственные сервисы.
Настроить самому или доверить Emaya
Мы уже наступили на эти грабли — вам не придётся
Подберём настройку Битрикс24
3 вопроса — и вы знаете цену и срок. Бесплатный аудит портала при заявке из квиза.
Интервью с собственником и РОПом, аудит текущей CRM и источников заявок.
1–3 дняВоронки, роли, точки контроля. Согласуем до того, как что-то настраивать.
3–5 днейНастраиваем Битрикс24 и дописываем недостающие инструменты. Демо каждую неделю.
1–4 неделиОбучение, база знаний, поддержка. Дорабатываем, пока цифры не поедут вверх.
дальше — с вамиПодробнееразвёрнутое описание, этапы и нюансы
REST API простыми словами
Битрикс24 умеет «разговаривать» с другими программами. REST API — это список команд, например crm.deal.add (создать сделку) или tasks.task.add (создать задачу). Внешняя система отправляет запрос по интернету, Битрикс24 выполняет команду и возвращает результат. Так работают интеграции с сайтом, 1С, складом, телефонией и собственными приложениями.
Входящий вебхук
Входящий вебхук — это адрес вида https://ваш-портал.bitrix24.kz/rest/ID/ключ/метод. Администратор создаёт его в разделе разработчика и выбирает права: CRM, задачи, пользователи. Ваш сервис вызывает этот адрес и получает доступ к данным в пределах выданных прав. Подходит для интеграций одного портала: форма сайта создаёт лид, скрипт выгружает сделки в отчёт.
Исходящий вебхук
Исходящий вебхук работает наоборот: при событии в портале (создан лид, изменена сделка, добавлена задача) Битрикс24 отправляет запрос на адрес вашего сервера. Так внешняя система узнаёт об изменениях сразу, без постоянного опроса.
Вебхук или приложение
| Вебхук | Приложение | |
|---|---|---|
| Авторизация | Постоянный ключ | OAuth, токены пользователя |
| Для скольких порталов | Один | Любое число |
| Встройка в интерфейс | Нет | Да: меню, карточка CRM |
| Сложность | Низкая | Выше |
Если нужен интерфейс внутри Битрикс24 — вкладка в карточке сделки, пункт в левом меню, кнопка — делают локальное или тиражное приложение.
Что можно сделать через REST API
- Заявки с сайта и квизов сразу в CRM с UTM-метками.
- Синхронизация остатков и счетов с 1С или складом.
- Собственные отчёты и дашборды по данным CRM.
- Автоматическая настройка портала: поля, воронки, справочники.
- Приложения, которых нет в маркетплейсе.
Безопасность
- Выдавайте вебхуку только нужные права.
- Храните ключ на сервере, не в коде страницы сайта.
- Удаляйте вебхуки, которые больше не используются.
- Учитывайте лимиты частоты запросов и используйте batch.
Пример: заявка с сайта
- Клиент заполняет форму на сайте.
- Сервер сайта вызывает входящий вебхук с методом создания лида и передаёт имя, телефон и UTM-метки.
- В Битрикс24 появляется лид, роботы назначают ответственного и ставят задачу.
- Исходящий вебхук сообщает сайту или внешней системе, что лид создан, — например, для отчёта по рекламе.
Всё это занимает доли секунды и работает без участия людей.
Кому это нужно знать
Руководителю не обязательно разбираться в методах API. Важно понимать, что почти любые данные Битрикс24 можно связать с другими системами, а ключи вебхуков — это доступ к данным компании, который нужно контролировать, как пароли.
О том, какие инструменты мы пишем на REST API, — в разделе инструменты для Битрикс24 и в блоге.
Частые вопросы
Что такое REST API и вебхуки в Битрикс24 и зачем они нужны?
REST API Битрикс24 — это набор методов, через которые внешние программы читают и изменяют данные портала: создают лиды, обновляют сделки, ставят задачи. Входящий вебхук — адрес с секретным ключом для вызова этих методов без регистрации приложения. Исходящий вебхук отправляет уведомление на ваш сервер, когда в портале происходит событие, например создана сделка. Через них подключают сайты, 1С и собственные сервисы.
Есть ли ограничения на количество запросов?
Да, у REST API есть лимиты на частоту запросов. Для массовых операций используют пакетные запросы (batch) и очереди.
Что делать, если ключ вебхука попал в чужие руки?
Сразу удалить или перевыпустить вебхук в настройках портала и заменить ключ во всех системах, где он использовался.
b24tools — светофор и дни на стадии
Канбан лидов красится по дням на стадии — зависшие заявки видны сразу
Emaya · Для любых компаний на Битрикс24
Внедрение CRM для Ornex
CRM под шесть направлений бизнеса разворачивается в Битрикс24 одной командой
Ornex · Закуп в Китае, логистика, тендеры
Сделаем так же у вас
Короткий созвон — и вы знаете срок и цену. Или посчитайте сами за 2 минуты.