Когда покупатель оформляет заказ цветов в интернет-магазине, менеджеру важно увидеть его в CRM Битрикс24 без ручного переноса данных. Но если связь с Битрикс24 прервётся, одного запроса на создание сделки недостаточно: передача может завершиться ошибкой.
В одном из проектов специалисты ВЕБ Симфонии разработали модуль wbs24.b24sync, который передаёт новые заказы из 1С-Битрикс: Управление сайтом (БУС) в сделки Битрикс24 через входящий вебхук. Ключевая часть решения — очередь с повторными попытками отправки
Задача: создавать сделки по новым заказам
Заказчику требовалась односторонняя интеграция: при появлении нового заказа на сайте автоматически создавать сделку с данными заказа в Битрикс24. Обратная синхронизация, последующие изменения заказа и обновление его статуса в CRM на этом этапе не предусматривались.
Отдельным требованием стала устойчивость к временным сбоям: если первый запрос не прошёл, модуль должен повторять отправку до получения подтверждения создания сделки.
Как реализовали интеграцию
- Регистрация нового заказа. При установке модуля добавляется обработчик события создания заказа. Он проверяет, выбран ли сайт заказа в настройках интеграции, и помещает подходящий заказ в очередь.
- Фоновая обработка. Cron запускает обработчик раз в минуту. За один запуск он обрабатывает одну запись из очереди.
- Передача в Битрикс24. Обработчик отправляет данные заказа в CRM через входящий вебхук для создания сделки.
- Фиксация подтверждения. Если CRM вернула идентификатор сделки, запись в очереди помечается как отправленная.
- Повтор при ошибке. Если успешное подтверждение не получено, запись не считается завершённой и может быть обработана повторно.
В этой схеме заказ сначала фиксируется локально, а взаимодействие с внешним сервисом выполняется отдельно. Кратковременный сбой Битрикс24 не требует от покупателя повторно оформлять заказ.

Почему использовали очередь, а не отправку напрямую
При прямом обращении к CRM в момент оформления заказа возникают дополнительные зависимости: ответ удалённого сервиса может задержаться или не прийти. Очередь отделяет оформление заказа от внешнего API и даёт возможность повторить передачу без нового действия покупателя.
В нашем варианте период запуска задания — одна минута, а за один запуск обрабатывается одна запись. Это конкретная настройка разработанного модуля. При большом потоке заказов производительность очереди потребуется оценивать отдельно.
Что важно учесть при повторных запросах
Есть тонкость: отсутствие ответа ещё не всегда означает, что сделка не создана. Например, Битрикс24 может принять запрос и создать сделку, но соединение прервётся до получения её идентификатора на сайте. Повторный запрос в такой ситуации потенциально создаст дубликат.
Поэтому очередь с повторными попытками повышает надёжность доставки, но не равна гарантии отсутствия дублей. Для более строгой схемы требуется проверка уже созданной сделки по уникальному идентификатору заказа или другой механизм идемпотентности.
Результат и границы первой версии
Разработан модуль wbs24.b24sync с обработчиком новых заказов, настройкой выбора сайтов, очередью отправки, запуском по cron и фиксацией полученного ID сделки. Сопоставление полей заказа и полей сделки пока выполняется непосредственно в коде.
В качестве возможного следующего этапа предусмотрено развитие решения до более универсального модуля с интерфейсом сопоставления полей. Синхронизация статусов заказов не входит в текущую версию.
Что полезно проверить перед похожей интеграцией
- Какие сайты и типы заказов должны создавать сделки.
- Какие именно поля заказа нужно передать в CRM и где они будут храниться.
- Как система фиксирует успешный ответ и идентификатор сделки.
- Что происходит при ошибке API, истечении времени ожидания или недоступности Битрикс24.
- Как выявляются повторы, если сделка была создана, а подтверждение потерялось.
- Хватит ли скорости фоновой очереди для пикового числа заказов.
Вывод: интеграция заказов с CRM — это не только передача набора полей. Не менее важно продумать, как система ведёт себя при сбоях: хранит ожидающие записи, подтверждает результат и повторяет неудачные операции
Вопросы и ответы
Что происходит с заказом после оформления на сайте?
Модуль wbs24.b24sync проверяет, разрешена ли отправка с данного сайта, и добавляет новый заказ в очередь. Затем фоновое задание пытается создать сделку в Битрикс24.
Если Битрикс24 недоступен, заказ потеряется?
По описанной схеме заказ остаётся в очереди до успешного подтверждения создания сделки. Это позволяет повторять отправку после временного сбоя. При длительной ошибке необходимо контролировать очередь и причины отказов.
Как часто модуль отправляет заказы в CRM?
В реализованной конфигурации cron запускается раз в минуту и обрабатывает одну запись очереди за запуск. Это параметр конкретного решения, а не обязательное ограничение платформ.
Передаются ли изменения статуса заказа из магазина в Битрикс24?
Нет. Первая версия решает задачу создания сделки по новому заказу. Обновление существующих сделок при изменении заказов и их статусов не входило в согласованный объём.
Можно ли использовать модуль сразу на нескольких сайтах?
В модуле предусмотрена проверка сайта, с которого поступил заказ: отправка происходит для сайтов, выбранных в настройках. Набор полей сделки при этом задаётся в коде.
Может ли повторная отправка создать две сделки?
Да, такой риск существует, если Битрикс24 создал сделку, но сайт не получил ответ с её ID. Для строгой защиты от дубликатов нужна отдельная проверка по уникальному идентификатору заказа или иной механизм идемпотентности. Наличие такой проверки в данном модуле исходными материалами не подтверждено.
Можно ли настроить соответствие полей заказа и сделки без программиста?
В описанной версии — нет: сопоставление полей выполняется внутри кода. Интерфейс настройки соответствий рассматривается как возможное развитие модуля.
Нужна интеграция сайта с Битрикс24?
Хотите автоматически передавать заказы с сайта в CRM или решить более сложную задачу по интеграции и автоматизации бизнеса?
Расскажите нам о своей задаче через форму ниже. Специалисты ВЕБ Симфонии изучат её и предложат подходящий вариант реализации.

