За кулисами разработки:
метод интеграции сервисов с Битрикс24
Дата публикации: 05 августа 2025
Привет! Меня зовут Антон Бугерко. Я руковожу проектами по разработке в IT-Solution — платиновом партнере «1C-Битрикс», интеграторе Битрикс24 и крупнейшем разработчике приложений для данной платформы.
В этой статье я расскажу о технологии интеграции Битрикс24 со сторонними сервисами, которая применяется в IT-Solution, а также поделюсь кейсами решения бизнес-задач наших клиентов.
В этой статье я расскажу о технологии интеграции Битрикс24 со сторонними сервисами, которая применяется в IT-Solution, а также поделюсь кейсами решения бизнес-задач наших клиентов.
Наиболее частые запросы владельцев порталов Битрикс24 — это интеграции со сторонними службами доставки, транспортными компаниями, ERP, сайтами и прочими сервисами.
Существует два типа лицензий Битрикс24 — облачная и коробочная. Варианты решения задачи интеграции очень схожи для обоих типов.
Существует два типа лицензий Битрикс24 — облачная и коробочная. Варианты решения задачи интеграции очень схожи для обоих типов.
Метод надежный, но работает не всегда, так как нужного приложения может просто не быть среди 4000+ решений на маркете. Также стоит учитывать, что тиражные приложения создаются для массового использования и не могут учесть индивидуальные особенности всех отраслей бизнеса.
Первый: Найти готовое решение в Битрикс24 Маркетплейс
Метод подходит только для коробочного Битрикс24 и таит множество подводных камней, о которых я расскажу чуть позже. Владельцы облачных лицензий могут перейти на «коробку» и уже там внедрять уникальный модуль, но это дорого и долго. Особенно эту задачу усложняет то, что с 1 сентября 2023 года прием заявок на бэкап для переноса портала из облака в коробочную версию прекращен.
Второй: Разработать уникальный модуль интеграции или обратиться к подрядчику
На мой взгляд, это самое правильное решение для облачных и коробочных порталов. При разработке локального приложения появляется возможность реализовать систему, которая будет отвечать всем особенностям внутренней кухни компании, но при этом оказывать минимальное влияние на стабильность портала.
Компания IT-Solution разработала технологию интеграции Битрикс24 со сторонними сервисами — «Интеграционный сервер». За последние 10 лет на ее основе было реализовано свыше 200 проектов. Далее расскажу об основных компонентах системы.
Компания IT-Solution разработала технологию интеграции Битрикс24 со сторонними сервисами — «Интеграционный сервер». За последние 10 лет на ее основе было реализовано свыше 200 проектов. Далее расскажу об основных компонентах системы.
Третий: Разработать и внедрить локальное приложение
Что включает в себя технология
Интеграционный сервер — инфраструктура, разработанная с использованием фреймворка Django, в которой есть все необходимое для реализации двусторонних интеграций Битрикс24 со сторонними платформами:
1. Приложение на Django + Python, набор библиотек для работы с конкретной задачей и собственные разработки для взаимодействия с Битрикс24.
Среди других фреймворков Django оказался наиболее оптимальным вариантом благодаря подробной документации, поддержке ООП, большому сообществу и постоянному внедрению новых функций. Подробнее о причинах выбора я расскажу ниже.
2. Базы данных на PostgreSQL для работы с данными, токенами приложения и логами.
3. Система получения и автоматического обновления SSL (acme + letsencrypt).
4. Сервисы запуска и перезагрузки приложения, а также системы, необходимые для работы сервера (uWSGI + Supervisor).
5. Сервис работы с системой контроля версий Git, перезагрузки и обновления приложения на сервере до новой версии релиза из административной панели.
6. Настройки регулярных задач через планировщик cron.
7. Система логирования разных уровней и каналов: файлы логов сервера, логи в базе данных приложения, уведомления в Telegram.
1. Приложение на Django + Python, набор библиотек для работы с конкретной задачей и собственные разработки для взаимодействия с Битрикс24.
Среди других фреймворков Django оказался наиболее оптимальным вариантом благодаря подробной документации, поддержке ООП, большому сообществу и постоянному внедрению новых функций. Подробнее о причинах выбора я расскажу ниже.
2. Базы данных на PostgreSQL для работы с данными, токенами приложения и логами.
3. Система получения и автоматического обновления SSL (acme + letsencrypt).
4. Сервисы запуска и перезагрузки приложения, а также системы, необходимые для работы сервера (uWSGI + Supervisor).
5. Сервис работы с системой контроля версий Git, перезагрузки и обновления приложения на сервере до новой версии релиза из административной панели.
6. Настройки регулярных задач через планировщик cron.
7. Система логирования разных уровней и каналов: файлы логов сервера, логи в базе данных приложения, уведомления в Telegram.
Почему был выбран именно Django + Python
Основатель «IT-Solution» Евгений Хлобыстин начинал как программист 1С, поэтому высокоуровневый язык был просто ближе и удобнее. Первые решения в компании писали на чистом PHP. Так как фреймворки уровня Laravel еще не появились, начали искать более удобный инструмент.
Как я говорил выше, Django оказался наиболее оптимальным вариантом благодаря документации, ООП и постоянному внедрению новых функций. Дополнительным аргументом стал опыт разработки приложения для VK на стеке Django + uwsgi, которое успешно справлялось с нагрузкой до 3000 пользователей одновременно. После этого кейса отказываться от Django + Python уже не хотелось.
При разработке фронтенда мы столкнулись с трудностями и пробовали уйти от использования чистого JavaScript. Экспериментировали с разными фреймворками, но в итоге остановились на Vue.js, поскольку он реактивный, прост в использовании и совместим с Django + Python.
Эффективность стека подтверждается тем, что многие разработчики тиражных и локальных приложений для Битрикс24 со временем переняли наш опыт и используют эту технологию в своих решениях.
Как я говорил выше, Django оказался наиболее оптимальным вариантом благодаря документации, ООП и постоянному внедрению новых функций. Дополнительным аргументом стал опыт разработки приложения для VK на стеке Django + uwsgi, которое успешно справлялось с нагрузкой до 3000 пользователей одновременно. После этого кейса отказываться от Django + Python уже не хотелось.
При разработке фронтенда мы столкнулись с трудностями и пробовали уйти от использования чистого JavaScript. Экспериментировали с разными фреймворками, но в итоге остановились на Vue.js, поскольку он реактивный, прост в использовании и совместим с Django + Python.
Эффективность стека подтверждается тем, что многие разработчики тиражных и локальных приложений для Битрикс24 со временем переняли наш опыт и используют эту технологию в своих решениях.
Внутренняя архитектура решения
На изображении представлены схема и ключевые компоненты сервера, а также их взаимодействие с Битрикс24 и сторонними системами.
Примеры использования технологии
На основе технологии специалисты IT-Solution реализовали множество интеграций облачного и коробочного Битрикс24 со сторонними сервисами. Ниже — несколько кейсов для демонстрации возможностей нашего решения.
Интеграция Битрикс24 с транспортной компанией
Во время тестирования калькулятора мы столкнулись с казусом. Для расчета кратчайшего расстояния от адреса клиента до терминалов использовалась формула декартова расстояния d = √((x₂ - x₁)² + (y₂ - y₁)²). Вследствие этого система считала расстояние фактически сквозь Землю.
Поняв причину и в очередной раз убедившись, что Земля — эллипсоид, мы воспользовались формулой гаверсинусов:
a = sin²(Δφ / 2) + cos(φ₁) * cos(φ₂) * sin²(Δλ / 2)
c = 2 * atan2(√a, √(1 − a))
d = R * c
Где:
φ — широта,
λ — долгота,
R — радиус Земли (≈ 6371 км)
Формула в виде метода модели:
Поняв причину и в очередной раз убедившись, что Земля — эллипсоид, мы воспользовались формулой гаверсинусов:
a = sin²(Δφ / 2) + cos(φ₁) * cos(φ₂) * sin²(Δλ / 2)
c = 2 * atan2(√a, √(1 − a))
d = R * c
Где:
φ — широта,
λ — долгота,
R — радиус Земли (≈ 6371 км)
Формула в виде метода модели:
Указанные данные выгружаются на сервер, который обрабатывает их, производит необходимые запросы к API «ПЭК» на получение координат, цен и сроков доставки, исходя из габаритов товаров в Сделке. После того как данные получены, сервер производит расчеты, а их результаты выводятся на карту и в таблицу.
Заказчик обратился в IT-Solution за разработкой решения для интеграции, которая позволит создавать заявки на доставку и отслеживать их статусы в Битрикс24, не заходя на сайт транспортной компании. Также потребовался специфический функционал: расчет ориентировочной стоимости и сроков доставки до ближайших к адресу клиента пунктов выдачи.
Решение первой задачи было реализовано достаточно стандартно. Для запуска процесса формирования заявки нужно открыть соответствующий пункт меню карточки Сделки в CRM. При открытии раздела запускается окно локального приложения на базе интеграционного сервера.
Большинство данных в заявке заполняются автоматически на основании информации в Сделке. Вручную указываются только адрес склада, дата отправки и адрес терминала отгрузки или получателя. Далее система отправляет заявку на сервер, где она обрабатывается и по API передается в сервис транспортной компании.
Решение первой задачи было реализовано достаточно стандартно. Для запуска процесса формирования заявки нужно открыть соответствующий пункт меню карточки Сделки в CRM. При открытии раздела запускается окно локального приложения на базе интеграционного сервера.
Большинство данных в заявке заполняются автоматически на основании информации в Сделке. Вручную указываются только адрес склада, дата отправки и адрес терминала отгрузки или получателя. Далее система отправляет заявку на сервер, где она обрабатывается и по API передается в сервис транспортной компании.
Для расчета сроков и стоимости доставки до ближайших к клиенту терминалов отгрузки был реализован специальный раздел в карточке Сделки, где необходимо указать адрес клиента.
def get_distance(self, latitude: float, longitude: float) -> float:
lat1 = math.radians(latitude)
lon1 = math.radians(longitude)
lat2 = math.radians(self.latitude)
lon2 = math.radians(self.longitude)
return 2 * self.R * math.asin(math.sqrt(math.sin((lat2 - lat1) / 2) ** 2 + math.cos(lat1) * math.cos(lat2) * math.sin((lon2 - lon1) / 2) ** 2))Также отмечу, что по умолчанию Django работает синхронно. Это не очень удобно, когда нужно быстро обработать много запросов к API. Чтобы ускорить работу приложения, можно использовать асинхронные библиотеки, такие как asyncio + aiohttp или httpx, но в данном случае мы обошлись ThreadPoolExecutor.
Подробное описание кейсов
Функция получения информации о стоимости и сроках доставки ТК ПЭК» в рамках Битрикс24.
Автоматизация формирования заявок на доставку грузов транспортной компанией «ПЭК».
Интеграция Битрикс24 с несколькими сервисами
Таким образом, мы получили инструмент, который позволяет отслеживать маршруты сотрудников во время командировок в рамках одного окна.
Для наглядности приведу пример получения данных из Яндекс GO и их последующего отображения на интерактивной карте.
В случае с другими источниками данных для выгрузки применяются аналогичные методы, но с определёнными нюансами. Например, для получения координат из адреса используется геокодер от Яндекса.
- Список сотрудников в корпоративном аккаунте Яндекс GO передается в локальное приложение.
- На стороне приложения пользователь выбирает нужных сотрудников с помощью фильтров, после чего выполняется запрос к API Яндекса на получение списка поездок.
- Полученные данные о поездках обрабатываются и передаются в локальное приложение для отображения на карте.
- Для соединения точек маршрутов между собой используется ymaps.Polyline.
В случае с другими источниками данных для выгрузки применяются аналогичные методы, но с определёнными нюансами. Например, для получения координат из адреса используется геокодер от Яндекса.
В компании заказчика сотрудники регулярно направляются в командировки по всей России для встречи с клиентами. Задача заключалась в создании отчета, в котором будут содержаться все данные по расходам и маршрутам передвижения сотрудников в командировках.
Основные источники данных для отчета:
1. Данные по отелям и аэропортам выгружены из собственной базы данных, где сохраняется история согласования командировок, билеты и листы бронирования.
2. Расположение объектов клиентов, к которым направлялись сотрудники, выгружено из карточек компаний Битрикс24.
3. Данные о поездках на такси выгружены из корпоративного аккаунта в Яндекс Go по API Яндекса.
Основные источники данных для отчета:
1. Данные по отелям и аэропортам выгружены из собственной базы данных, где сохраняется история согласования командировок, билеты и листы бронирования.
2. Расположение объектов клиентов, к которым направлялись сотрудники, выгружено из карточек компаний Битрикс24.
3. Данные о поездках на такси выгружены из корпоративного аккаунта в Яндекс Go по API Яндекса.
Система инвентаризации по QR-коду
Почему я назвали ссылку «специальной»? Дело в том, что в нее зашит ID элемента смарт-процесса, чтобы по нему можно было определить, какое оборудование необходимо найти в системе. Проблема: если добавить просто ID, будет возможность перебором найти информацию о другом оборудовании. Так как QR-код будет использоваться не только сотрудниками, но и клиентами, это было недопустимо. Поэтому с помощью django.core.signing.Signer формируется защищенная от подбора ссылка с информацией, скрытой криптографической подписью.
Организация предоставляет оборудование в аренду. Ранее для учета техники, которая была передана клиентам, компания ограничивалась заключением договоров. В документах указывались даты выдачи техники, инвентарные номера, а также контактные данные лиц, которые несут ответственность за технику. С ростом количества заказов этих договоров стало так много, что отследить текущее местоположение техники было крайне сложно.
Изначально заказчик пробовал решать эту проблему самостоятельно с помощью обычной инвентаризации. Но для этого использовали тонны макулатуры, которую менеджеры возили от склада до клиента, а затем сдавали в архив.
Мы начали свою работу с того, что разработали простое приложение для генерации большого количества элементов смарт-процессов.
Смарт-процессы — инструмент, позволяющий создать новые элементы CRM и настраивать их под уникальные задачи. Для каждого процесса можно настроить карточку со своим набором полей, отдельные воронки, стадии в канбане, права доступа, связь с задачами, календарем и другими элементами.
Изначально заказчик пробовал решать эту проблему самостоятельно с помощью обычной инвентаризации. Но для этого использовали тонны макулатуры, которую менеджеры возили от склада до клиента, а затем сдавали в архив.
Мы начали свою работу с того, что разработали простое приложение для генерации большого количества элементов смарт-процессов.
Смарт-процессы — инструмент, позволяющий создать новые элементы CRM и настраивать их под уникальные задачи. Для каждого процесса можно настроить карточку со своим набором полей, отдельные воронки, стадии в канбане, права доступа, связь с задачами, календарем и другими элементами.
Каждый сгенерированный элемент — это карточка устройства в смарт-процессе «Оборудование». В них вносится информация по технике, а также автоматически генерируется специальная ссылка на страницу оборудования в Битрикс24 для формирования QR-кода.
secret = Signer().sign(inventory_id)
url = f'{self.BASE_URL}/inventory/{secret}'При установке техники на объект специалист с помощью смартфона сканирует QR-код, который ведет на карточку оборудования в Битрикс24, и вносит данные по объекту установки, дату и прочую информацию.
При этом, если QR-код отсканирует пользователь, который не авторизован на портале Битрикс24 компании-заказчика, откроется карточка с контактной информацией и формой заявки на сервисное обслуживание.
После заполнения карточек работники склада генерируют QR-коды ссылок, распечатывают их и наклеивают на соответствующее оборудование.
Почему мы используем такой метод и на облаке, и на коробке Битрикс24?
Несмотря на то, что описанный выше метод интеграции изначально разрабатывался для облачной версии Битрикс24, в 99% случаев мы используем его и в случае с коробочными порталами.
Дело в том, что «1С-Битрикс» регулярно повышает версию PHP для обеспечения безопасности и высокой производительности своих продуктов. Последствия — после обновления коробки самописные модули могут перестать работать, так как обновленный PHP, например, не поддерживает какой-нибудь запрос. В свою очередь, на решения, построенные на базе отдельного сервера, это никак не повлияет.
Дело в том, что «1С-Битрикс» регулярно повышает версию PHP для обеспечения безопасности и высокой производительности своих продуктов. Последствия — после обновления коробки самописные модули могут перестать работать, так как обновленный PHP, например, не поддерживает какой-нибудь запрос. В свою очередь, на решения, построенные на базе отдельного сервера, это никак не повлияет.
Итог
Выделю три основных преимущества данной технологии интеграции.
Универсальность
Интеграцию можно реализовать на любых тарифах и типах лицензий Битрикс24 (за исключением облачного тарифа «Бесплатный»). Единственное условие — наличие подписки «Битрикс24 Маркетплейс».
Автономность
Благодаря автообновлению SSL-сертификатов и встроенным сервисам управления приложением интеграция способна работать автономно в течение нескольких лет. После внедрения наша команда подключается к порталу клиента преимущественно для реализации новых функций. Редкие сбои, как правило, связаны с проблемами на удаленном сервере либо с изменениями на портале, которые клиент внес самостоятельно.
Многозадачность
Один сервер может поддерживать несколько интеграций, что существенно снижает стоимость и ускоряет разработку при подключении дополнительных сервисов к Битрикс24 в будущем.
Универсальность
Интеграцию можно реализовать на любых тарифах и типах лицензий Битрикс24 (за исключением облачного тарифа «Бесплатный»). Единственное условие — наличие подписки «Битрикс24 Маркетплейс».
Автономность
Благодаря автообновлению SSL-сертификатов и встроенным сервисам управления приложением интеграция способна работать автономно в течение нескольких лет. После внедрения наша команда подключается к порталу клиента преимущественно для реализации новых функций. Редкие сбои, как правило, связаны с проблемами на удаленном сервере либо с изменениями на портале, которые клиент внес самостоятельно.
Многозадачность
Один сервер может поддерживать несколько интеграций, что существенно снижает стоимость и ускоряет разработку при подключении дополнительных сервисов к Битрикс24 в будущем.
Упростите ведение бизнеса для себя и своих сотрудников
Отправьте заявку, мы свяжемся
с вами в ближайшее время и обсудим детали вашего вопроса.
с вами в ближайшее время и обсудим детали вашего вопроса.
Смотрите также
Смотрите также