MOD-INT-B24 — Интеграция с Битрикс24
Лицензия: Платный
Мост между Modula и порталом Битрикс24. Коннектор настраивается входящим вебхуком или локальным приложением, после чего модуль читает все поля сущностей портала — включая пользовательские UF_* — и позволяет собрать маппинг: какая сущность синхронизируется, в какую сторону (входящая, исходящая, двусторонняя) и как соотносятся поля.
Синхронизация ведётся джобами с полным и инкрементальным режимом и подробным отчётом со ссылками на источники. Расхождения не замалчиваются: конфликт попадает в отдельный список и закрывается вручную выбором стороны или собственного значения. Исходящая запись принципиально не удаляет ничего на портале — удаление доступно только явными инструментами b24.*.delete, и они помечены как необратимые. Отдельный блок — сотрудники: импорт из портала, авто-сопоставление с пользователями Modula и ручная связка, с возможностью полного сброса перед повторным сопоставлением. Миграция данных начинается с сухого прогона, показывающего, что именно будет создано и обновлено.
Возможности
- Коннектор через входящий вебхук или локальное приложение портала, проверка связи и областей доступа
- Чтение всех полей сущностей Битрикс24, включая пользовательские
UF_* - Маппинг сущностей с направлением синхронизации и политикой разрешения конфликтов
- Сопоставление полей с преобразованиями, включение и выключение отдельных маппингов
- Полная и инкрементальная синхронизация джобами со статусом и счётчиками
- Список конфликтов и их ручное закрытие выбором стороны или значения
- Прямая запись на портал: создание, изменение и удаление лидов, сделок, контактов, компаний и задач
- Подписка на события портала: исходящие вебхуки и привязка событий к обработчику приложения
- Импорт сотрудников, авто-сопоставление и ручная связка с пользователями Modula
- Миграция с сухим прогоном и подтверждением запуска
- Чтение зеркала сущностей с соблюдением прав вызывающего
- Сводный отчёт синхронизации со ссылками на джобы-источники
Основные MCP-инструменты
| Инструмент | Назначение |
|---|---|
int-b24__connector.configure | Настроить коннектор Битрикс24 |
int-b24__connector.test | Проверить связь, области доступа и лимиты |
int-b24__connector.list | Подключённые коннекторы и их состояние |
int-b24__b24.discover_fields | Прочитать все поля сущностей портала, включая UF_* |
int-b24__mapping.upsert | Маппинг сущности с направлением синхронизации |
int-b24__mapping.list | Карта сущностей и полей Битрикс24 ↔ CRM |
int-b24__mapping.set_enabled | Включить или выключить маппинг |
int-b24__fieldmap.upsert | Сопоставить поля с преобразованием |
int-b24__sync.run | Запустить синхронизацию (полную или инкрементальную) |
int-b24__sync.status | Статус и счётчики джоба |
int-b24__sync.report | Сводный отчёт со ссылками на источники |
int-b24__conflict.list | Открытые конфликты синхронизации |
int-b24__conflict.resolve | Закрыть конфликт выбранным разрешением |
int-b24__discrepancy.report | Отчёт о расхождениях данных |
int-b24__b24.entity.list | Прочитать записи сущности из зеркала |
int-b24__b24.entity.get | Одна запись зеркала по внешнему идентификатору |
int-b24__b24.deal.create | Создать сделку на портале |
int-b24__b24.deal.update | Изменить сделку на портале |
int-b24__b24.contact.create | Создать контакт на портале |
int-b24__b24.company.create | Создать компанию на портале |
int-b24__b24.lead.create | Создать лид на портале |
int-b24__b24.task.create | Создать задачу на портале |
int-b24__webhook.subscribe | Подписаться на события портала |
int-b24__b24.event.bind | Привязать события портала к обработчику приложения |
int-b24__users.import | Импортировать сотрудников из Битрикс24 |
int-b24__users.automatch | Авто-сопоставить сотрудников с пользователями Modula |
int-b24__users.link | Ручная связка сотрудника с пользователем |
int-b24__users.list | Сотрудники со статусом связки |
int-b24__migration.preview | Сухой прогон миграции |
int-b24__migration.run | Запустить миграцию (с подтверждением) |
Связанные модули
- MOD-CRM — целевые сделки, контакты и компании синхронизации
- MOD-ORG — пользователи, с которыми связываются сотрудники портала
- MOD-TASK — задачи, синхронизируемые с портальными
- MOD-INT-AMO — та же схема интеграции для amoCRM