Как интегрировать 2ГИС в Битрикс24 и создать единую карту объектов

Компания, работающая с распределённой сетью объектов поставки, обратилась к специалистам «Факта» с задачей создать карту, которая автоматически наполняется данными из CRM.

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

При этом карта должна была взаимодействовать не только с типовыми элементами CRM, но и с пользовательскими сущностями. Изменение координат в связанных карточках компаний и сделок должно было отражаться на общей карте без повторного ручного ввода данных.

Стандартных инструментов коробочного Битрикс24 для реализации такого сценария оказалось недостаточно. Поэтому потребовалась разработка собственного модуля картографии с интеграцией внешнего сервиса.

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

Перед командой стояли четыре задачи:

• Геопозиционирование. Хранение и использование географических координат объектов.

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

• Синхронизация данных. Обновление информации о расположении объектов при изменении связанных записей CRM.

• Управление настройками. Возможность менять API-ключ картографического сервиса без непосредственного вмешательства разработчиков в код.

В качестве картографического сервиса по инициативе заказчика выбрали 2ГИС. Для интеграции использовали официальный API сервиса, а архитектуру решения проектировали с учётом возможности адаптации к другим картографическим API.

Решение потребовало доработки серверной и клиентской частей коробочного Битрикс24. Команда изучила существующие механизмы работы платформы с географическими данными, после чего разработала собственную интеграцию.

1. Проработали архитектуру картографического модуля

За основу исследования взяли подходы, используемые в картографических решениях на базе OpenStreetMap, и принципы взаимодействия стандартного модуля «Локация» в Битрикс24 с внешними сервисами.

Это позволило определить, как организовать работу с координатами и встроить стороннюю картографию в существующую архитектуру CRM.

2. Подключили API 2ГИС

Для отображения интерактивной карты интегрировали API 2ГИС. Это позволило использовать внешний картографический сервис внутри корпоративного портала, не ограничиваясь штатными возможностями платформы.

При этом карта стала частью рабочего интерфейса CRM, а не отдельным инструментом, в котором сотрудникам пришлось бы вести данные параллельно.

3. Доработали механизм управления API-ключом

Чтобы упростить дальнейшее обслуживание решения, специалисты модернизировали компонент intranet.settings.

В результате администраторы получили возможность добавлять и обновлять API-ключ картографического сервиса через интерфейс портала. Это снижает зависимость от разработчиков при выполнении типовых административных операций.

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

4. Подготовили клиентскую часть карты

Для сборки пользовательских JavaScript-модулей установили Bitrix CLI и настроили процесс подготовки фронтенд-компонентов.

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

5. Связали карту с сущностями CRM

Ключевой частью решения стала интеграция карты с данными CRM. Координаты объектов связываются с соответствующими записями системы. При изменении местоположения в связанной карточке компании или сделки информация на общей карте обновляется без необходимости повторного ручного заполнения.

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

В результате доработки коробочного Битрикс24 компания получила картографический инструмент, связанный с данными CRM и адаптированный под собственную структуру объектов.

Основные результаты проекта:

• Единое представление объектов. Географическая информация доступна на общей карте внутри корпоративной системы.

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

• Поддержка пользовательских сущностей. Картографический модуль учитывает структуру данных, созданную под задачи бизнеса.

• Упрощённое администрирование. API-ключ можно обновлять через интерфейс портала без изменения программного кода.

• Возможность дальнейшего развития. Архитектура решения позволяет рассматривать адаптацию к другим картографическим сервисам при условии совместимости API и доработки интеграционного слоя.

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

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

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

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