Можно связать Bitrix24 с внутренними системами и нестандартными сервисами.
API
Bitrix24 API, webhooks и кастомные интеграции
Разрабатываем интеграции, когда типового коннектора недостаточно: внутренние системы, ERP, внешние сервисы, BI и операционные приложения. Проектируем схему событий, повторяемость и контроль доступа.
REST APIInbound webhookOutbound webhookmiddleware
REST · события · очередиBitrix24
idempotencyповтор без дублей
queueочередь и ретраи
ACLконтроль прав и токенов
События CRMBitrix24 → внешняя система
Операционные данныевнешняя система → Bitrix24
Справочникидвусторонне или по master‑системе
Срокфиксируем после scopeсхема → тестовый контур → production
Передаём клиентуконтролируемый контуркарта обмена, правила retry, логи и чек-лист приёмки
Сценарий
Зачем это бизнесу
Когда стандартного приложения нет, мы проектируем собственный обмен: какие события слушаем, что сохраняем в очередь, как сопоставляем объекты, где хранится журнал и кто получает алерт при сбое.
Интеграция становится предсказуемой: есть схема событий, правила повторов и мониторинг.
Легче масштабировать обмен и добавлять новые сценарии поверх работающего контура.
Состав обмена
Для запуска описываем конкретные объекты, направление синхронизации и правила контроля. Ниже — типовая карта данных для этого пакета интеграции.
СущностьОписаниеНаправлениеКонтроль
События CRMсоздание/обновление лида, сделки, контактаBitrix24 → внешняя системалог + retry
Операционные данныестатусы, документы, сервисные действиявнешняя система → Bitrix24лог + retry
Справочникипользователи, категории, продукты, статусыдвусторонне или по master‑системелог + retry
Логи и алертыжурнал, retry, dead letter queue, уведомленияmiddlewareлог + retry
Кому подходит
- Есть собственная ERP/учётная система, склад, TMS, сервис‑деск или production‑приложение.
- Нужен нестандартный маршрут данных, которого нет в коробочных решениях.
- Важно держать под контролем безопасность, версионирование и поддержку обмена.
Технологический контур
ИнструментыBitrix24 REST APIwebhooksmiddlewaremessage queueobservability
01
Webhook, REST API или приложение
Webhook
Быстрый способ для ограниченного набора серверных действий и событий.
REST API
Используем API как транспорт, когда нужна своя серверная логика и контроль обмена.
Приложение
Нужно, когда важны интерфейс внутри Bitrix24, установка, права и тиражирование.
02
Что добавляем для production
✓
очередь запросов и ограничение нагрузки
✓
идемпотентность и защита от дублей
✓
retry с понятными правилами
✓
структурированные логи
✓
хранение секретов вне клиентского JS
✓
мониторинг и сценарий восстановления
Риски и внимание к деталям
Что важно продумать до запуска
!
Если не проектировать версии API и схему изменений, доработки быстро ломают старые сценарии.
!
Токены и доступы нельзя хранить в коде страницы или раздавать без сегментации прав.
!
Без очереди и повторов временная ошибка превращается в потерянное событие.
FAQ
Частые вопросы
Короткие ответы на вопросы, которые обычно появляются до оценки интеграции.
Когда нужен REST API, а когда достаточно вебхука?
Вебхуки удобны для простых интеграций и событий. Для приложения с пользовательской авторизацией, сложной логикой прав и несколькими порталами чаще нужен полноценный REST/OAuth-контур.
Зачем интеграции очередь?
Чтобы временная недоступность внешней системы не теряла событие. Очередь хранит событие, управляет повторами и позволяет отдельно разбирать ошибки.
Нужна оценка интеграции?
Опишите, какие системы нужно связать и какие данные важны. Вернёмся с вопросами, рисками и ориентиром по объёму.
