REST API Битрикс24: доработки и интеграции без изменения ядра

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

Что доступно через API

• CRM: лиды, сделки, контакты, компании, смарт-процессы, счета, товары
• Задачи и проекты
• Чаты и уведомления
• Пользователи и структура компании
• Диск и файлы
• Телефония: регистрация звонков из внешних АТС
• Открытые линии и чат-боты
• Бизнес-процессы: запуск и собственные действия

Входящие вебхуки

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

Исходящие вебхуки и события

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

Приложения

Для более сложных задач создаются приложения: локальные — для одного портала, или публикуемые в маркетплейсе — для многих. Приложение может иметь интерфейс, встроенный в Битрикс24: вкладку в карточке сделки, пункт меню, виджет. Авторизация приложений идёт по протоколу OAuth 2.0.

Свои действия для роботов

Через API можно зарегистрировать собственных роботов и действия бизнес-процессов. Например, робот «Проверить контрагента», который вызывает внешний сервис и записывает результат в сделку. Для пользователей он выглядит как обычный робот в настройках стадии.

Ограничения

У API есть ограничения на интенсивность запросов. Массовые операции нужно выполнять пакетами с паузами, использовать пакетные методы, которые выполняют несколько команд за один запрос. Списки возвращаются постранично, и для выгрузки больших объёмов нужно правильно обрабатывать пагинацию. Конкретные значения ограничений описаны в документации разработчика.

Примеры интеграций

Telegram-бот создаёт лид с данными анкеты, а при смене стадии уведомляет клиента.

Учётная система получает сделку на стадии «Счёт» и возвращает номер документа и статус оплаты.

Сайт с личным кабинетом показывает клиенту статус его заявок из смарт-процесса.

BI-система регулярно выгружает сделки и активности для аналитики.

Правила разработки

• Выдавать вебхукам и приложениям только нужные права
• Хранить ключи в защищённом месте, не в публичном коде
• Логировать запросы и ошибки
• Повторять запросы при временных сбоях и не терять данные
• Ссылаться на идентификаторы полей и стадий, а не на названия
• Документировать интеграцию: что делает, где размещена, как перезапустить

Где размещать

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

Перед разработкой проверьте маркетплейс: для многих задач уже есть готовые приложения, и иногда выгоднее взять их, чем писать своё. Собственная интеграция оправдана, когда логика специфична для вашей компании или готовые решения не поддерживают нужную систему.

Если нужно разработать интеграцию или приложение для Битрикс24 через REST API, оставьте заявку — спроектируем и сделаем.