1. Главная
  2. Разработка
  3. Битрикс24 · REST

Битрикс24 · REST

Разработка интеграций Битрикс24 для сквозного процесса

Связываем облачный или коробочный Битрикс24 с 1С, сайтами, внутренними системами, телефонией, сервисами документов и аналитикой. Разделяем локальную автоматизацию, приложение и серверный обмен, чтобы права и поддержка не терялись между компонентами.

  • amoCRM · официальный партнёр
  • Битрикс24 · бизнес-партнёр
  • Код и доступы передаваем

Сначала выбор пути

Разработка — третий вариант, а не первый

Проверяем задачу по возрастающей сложности. Это снижает стоимость владения и число компонентов, которые придётся поддерживать.

01 / Штатно

Настройка платформы

Поля, права, роботы, бизнес-процесс или стандартный webhook закрывают сценарий без нового продукта.

02 / Готово

Партнёрское решение

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

03 / На заказ

Собственная разработка

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

Типовые запросы

Что связываем с Битрикс24

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

01

1С и учёт

Заказы, товары, цены, остатки, документы, оплаты и статусы с учётом редакции и доработок конфигурации.

02

Сайт и личный кабинет

Обращения, заказы, статусы, документы и безопасный доступ клиента к нужной части процесса.

03

Производство и сервис

Смарт-процессы, заявки, согласования, фото, чек-листы и передача результата между отделами.

04

BI и управленческие отчёты

Выгрузка согласованных показателей в хранилище, Power BI или собственную панель без ручной таблицы.

05

Документооборот

Шаблоны, согласование, подпись, статусы и привязка актуальной версии к карточке CRM.

06

Внешний продукт

Локальное или тиражное приложение с интерфейсом внутри портала и серверной логикой на стороне разработчика.

Проектные решения

Что проектируем вокруг портала Битрикс24

Детали ниже определяют эксплуатацию выбранного формата и проверяются до оценки реализации.

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

Входящий webhook удобен для узкого внутреннего сценария, но он не становится приложением автоматически. Если нужен интерфейс, установка на несколько порталов, события пользователя или управляемое расширение прав, проектируем жизненный цикл OAuth-приложения и хранение настроек каждого портала.

Коробочная версия добавляет слой эксплуатации: версия REST-модуля, обновления продукта, локальные доработки и состояние серверного окружения. Перед изменением нужен тестовый контур и резервная копия, а после — регрессия интеграции на реальных ролях, а не только под администратором.

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

События Битрикс24 могут приходить быстрее, чем внешняя система успевает их обработать. Приёмный endpoint подтверждает доставку, нормализует контекст портала и помещает работу в очередь. Так длинный вызов контрагента не блокирует новые изменения карточек.

Batch сокращает сетевые обращения, но требует разбирать ответ каждой команды. Частичная ошибка не должна потеряться за общим успешным HTTP-ответом. В журнале сохраняем связь команды с объектом и повторяем только неисполненную часть.

Архитектура

Данные проходят через контролируемый маршрут

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

Источник
Битрикс24

Событие, пользовательское действие или плановая выборка.

Контроль
Приложение или сервис

Проверка, маппинг, очередь, защита от дублей, журнал и повтор.

Результат
1С · ERP · сайт · BI

Подтверждение операции, сохранённая связь объектов и сверяемый итог.

Если получатель временно недоступен, операция не должна исчезать или бесконечно создавать новые сущности. Она получает состояние, понятную причину ошибки и управляемый повтор.

Результат проекта

Передаём не только код, но и управляемую систему

Состав зависит от масштаба, но критичные решения, доступы и сценарии восстановления не остаются в переписке разработчика.

01

Карта портала

Редакция, облако/коробка, объекты, пользовательские поля, роботы, права и установленные приложения.

02

Модель авторизации

Вебхук для ограниченного сценария либо OAuth-приложение с требуемыми scope и жизненным циклом.

03

События и batch

Очередь входящих событий, ограничение запросов, групповые операции и контроль частичного результата.

04

Точки встраивания

Вкладка карточки, пункт меню, боковая панель или отдельная страница с проверкой прав пользователя.

05

Контроль коробки

Совместимость версии, резервная копия, тестовый контур и порядок обновления модуля при локальной установке.

06

Регламент поддержки

Кто отвечает за портал, приложение, внешний API, сервер и восстановление обмена.

Специфика задачи

Локальная интеграция, приложение или тиражный продукт

Одинаковый REST-метод не делает решения одинаковыми: отличается установка, авторизация, интерфейс и эксплуатация.

ФорматПодходитОграничениеЧто закладываем
ВебхукНебольшой внутренний сценарий с ограниченными правамиНе заменяет приложение и не подходит для каждой точки встраиванияМинимальные права, ротацию, журнал и отзыв доступа
Локальное приложениеОдин портал и собственный бизнес-процессНужен внешний обработчик и поддержка установкиOAuth, события, интерфейс, сервер и документацию
Тиражное приложениеПродукт для нескольких клиентов и МаркетплейсаМногопользовательская архитектура и требования публикацииИзоляцию клиентов, установку, биллинг, поддержку и обновления
Источники и границы. Возможности платформ сверены 2 октября 2026 года: Виджеты и точки встраивания Битрикс24 · История REST-модуля. Конкретные методы, тарифы, редакции и требования публикации повторно проверяем перед проектом.

Надёжность

Проверяем отказ до того, как он станет инцидентом

Демонстрация успешной операции — только начало приёмки. Интеграция должна предсказуемо вести себя при повторе, задержке и недоступности.

Duplicate

Повтор события

Тот же ID не создаёт вторую сделку, заказ, документ или платёж.

Timeout

Нет ответа

Операция остаётся в контролируемом состоянии и повторяется по правилам.

Partial

Частичный результат

Виден выполненный шаг, точка отказа и безопасное продолжение процесса.

Recovery

Восстановление

После сбоя можно сверить период и повторить только пропущенные операции.

Порядок работы

От контрольного примера до сопровождения

Для локальной задачи этапы компактные. Для критичной интеграции каждый этап имеет отдельный результат и принимающего сотрудника.

01

Обследование

Текущий процесс, системы, данные, ограничения и цена ошибки.

02

Проектирование

Вариант решения, карта данных, события, права и критерии приёмки.

03

Разработка

Контуры, код, конфигурация, журнал и тестовые данные.

04

Пилот

Обычный путь, исключения, роли, нагрузка и соседние процессы.

05

Эксплуатация

Передача, мониторинг, поддержка, обновления и план развития.

Форматы работы

Сначала регулярная ответственность, затем проект и разовые задачи

Интеграции живут вместе с процессом и API платформ. Поэтому приоритетный формат после запуска — сопровождение, а не ожидание следующего аварийного обращения.

Проектная разработка

Для подтверждённого типового запроса или нового интеграционного продукта с приёмкой.

оценка после обследования
  • требования и архитектура
  • итерации и демонстрации
  • тестирование отказов
  • передача кода и документации
Оценить проект

Пакет часов

Дополнительный формат для ограниченного списка разовых работ без новой архитектуры.

от 15 000 ₽
  • диагностика одного сбоя
  • локальный webhook или поле
  • проверка готового модуля
  • небольшая правка документации
Проверить границы задачи

Короткие ответы

Вопросы до старта

Точная оценка появляется после проверки систем и одного реального сценария. Ниже — границы, которые полезно знать заранее.

Чем вебхук отличается от приложения Битрикс24?

Вебхук — способ доступа к определённым REST-методам. Приложение имеет жизненный цикл установки, авторизацию, события и может встраивать интерфейс. Выбор зависит от задачи и количества порталов.

Работаете с коробочной версией?

Да, но до оценки проверяем редакцию, версию модулей, доработки ядра, окружение и процедуру обновления. Для изменений на сервере нужен резервный и тестовый контур.

Можно сделать своё рабочее место внутри Битрикс24?

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

Поддерживаете приложение после запуска?

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

Связанные направления

Выберите компонент, который соответствует задаче

Страницы кластера разделены по поисковому и проектному намерению, но в реальной архитектуре компоненты часто работают вместе.

Следующий шаг

Покажите одну операцию, которая сейчас выполняется вручную или теряется

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

  • Не просим готовое техническое задание для первого разговора
  • Отдельно обозначаем неизвестные и внешние зависимости
  • Не продаём разработку, если задача решается надёжнее без неё

Описать задачу

Проект с проверяемой приёмкойСпроектируем «Разработка интеграций Битрикс24 для сквозного процесса» с тестами и передачей результата

Зафиксируем операцию, данные, ошибки и критерии готовности до оценки разработки. Реализацию оформим проектом, а мониторинг и развитие — ежемесячным сопровождением.

Отправка формы ни к чему не обязывает. Сначала уточним границы задачи.