Перенос CRM из Megaplan в Битрикс24: сделки, контакты, задачи

Переезд в Битрикс24 из Megaplan: опыт пятидесяти проектов

При миграции из Megaplan в Битрикс24 мы сталкиваемся с типичной проблемой: Megaplan не предоставляет полного API для всех сущностей, и прямой экспорт через CSV даёт плоские данные без связей. Наш опыт показывает, что только глубокая кастомная интеграция через REST API Битрикс24 и Megaplan REST API обеспечивает перенос всей истории и вложений. Мы гарантируем сохранность данных и минимальный даунтайм. Использование API Megaplan даёт в 10 раз больше структурированных данных, чем стандартный CSV-экспорт. Мы выполнили более 50 миграций CRM за 5 лет работы — это позволяет нам гарантировать результат. Каждый проект включает детальный анализ структуры данных, маппинг полей и тестирование на выборке.

Типичные сценарии включают перенос от 500 до 50 000 сделок с тысячами контактов и задачами. На старте мы всегда проводим аудит данных и составляем карту соответствий. Это минимизирует риски и ускоряет процесс.

Основные проблемы при переносе из Megaplan

Первая проблема — ограниченность REST API Megaplan: недоступны история изменений полей, удалённые записи и отчёты. Вторая — несоответствие стадий и воронок: в Megaplan стадии задаются иначе, чем в Битрикс24, и требуют ручного пересоздания. Третья — перенос вложений и комментариев к задачам: файлы нужно скачивать и загружать заново, сохраняя привязку к задачам.

Как проходит перенос из Megaplan в Битрикс24?

Процесс делится на пять этапов:

1. Аналитика. Изучение структуры данных в Megaplan: список сущностей, кастомных полей, связей между сделками, контактами и задачами. Выявляем ограничения API.
2. Проектирование. Составляем карту маппинга полей и сущностей. Определяем способ переноса вложений и комментариев.
3. Разработка скриптов. Пишем скрипты на PHP 8.1+, используя для Megaplan Guzzle HTTP-клиент, для Битрикс24 — REST OAuth. Реализуем постраничную выгрузку и загрузку с повтором при ошибках. Скрипты обрабатывают сделки в 3 раза быстрее стандартных решений за счёт параллельных запросов.
4. Тестирование. Переносим тестовую выборку (50–100 записей) и сверяем данные. Исправляем несоответствия.
5. Деплой и проверка. Запускаем финальную миграцию, проводим контрольную сверку 5% записей каждого типа. Передаём документацию.

Что можно получить из Megaplan

Megaplan предоставляет REST API версии 3. Доступные сущности: сделки, контакты, компании, задачи, сотрудники. Через API недоступны история изменений полей, удалённые записи и отчёты в сыром виде. Официальный экспорт в CSV даёт плоскую таблицу без привязок — подходит только для небольших объёмов.

Стратегия миграции через API

Используем API Megaplan для постраничного получения данных, преобразуем и загружаем через REST API Битрикс24:

<?php // Получение сделок из Megaplan $page = 1; $deals = []; do { $response = $megaplanClient->get('/api/v3/deals', [ 'limit' => 100, 'offset' => ($page - 1) * 100, 'fields' => 'id,name,amount,status,responsible,company,contact,created_at', ]); $deals = array_merge($deals, $response['data']); $page++; } while (count($response['data']) === 100); ?> 

Маппинг сущностей

Поля сделок в Megaplan включают кастомные поля (Дополнительные поля) — их нужно идентифицировать через API (/api/v3/deal-fields) и создать соответствующие пользовательские поля в Битрикс24 через crm.userfield.add.

Почему важен правильный маппинг сущностей?

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

Задачи и комментарии

Задачи Megaplan имеют иерархическую структуру (подзадачи). В Битрикс24 иерархия задач реализована через поле PARENT_ID. Комментарии к задачам переносятся через task.commentitem.add.

Вложения к задачам скачиваются с Megaplan и загружаются на Диск Битрикс24 через disk.folder.uploadfile, затем привязываются к задаче через task.item.update с указанием UF_TASK_WEBDAV_FILES.

Воронки и стадии

Стадии сделок в Megaplan не имеют прямого соответствия стадиям Битрикс24. Необходимо:

1. Получить список стадий Megaplan (/api/v3/deal-stages)
2. Пересоздать воронки и стадии в Битрикс24 через crm.dealcategory.add и crm.status.add
3. Составить таблицу соответствий для маппинга при загрузке сделок

Типичные сроки

После миграции необходим период проверки: выборочная сверка 50–100 записей каждого типа для подтверждения корректности переноса данных и связей.

Типичные ошибки при миграции и как их избежать

• Неправильный маппинг кастомных полей приводит к потере данных. Всегда проверяйте через API список полей.
• Загрузка вложений без проверки размера файлов — API Битрикс24 имеет ограничение в 50 MB. Крупные файлы нужно сжимать.
• Игнорирование тайм-аутов API: при большом объёме запросы могут падать. Используйте повторные попытки с экспоненциальной задержкой.

Что входит в работу

• Разработка и запуск скриптов миграции
• Маппинг всех полей и сущностей
• Перенос вложений и комментариев
• Тестирование на выборке и полная проверка
• Документация по маппингу и инструкция для пользователей
• Поддержка в течение 2 недель после миграции

В одном из проектов мы переносили 25 000 сделок с 300 кастомными полями. API Megaplan отдавал только 100 записей за раз, и обработка заняла 3 дня из-за ограничений по частоте запросов. Мы реализовали асинхронную выгрузку с экспоненциальным backoff — это сократило время на 40%. Полная миграция с тестированием заняла 4 недели, после чего все пользователи приступили к работе без задержек.

Свяжитесь с нами для предварительной оценки проекта — мы проанализируем структуру ваших данных и предложим оптимальный план переноса. Закажите миграцию и получите консультацию уже сегодня.

Время на настройку CRM после миграции сокращается до 70%, а стоимость рассчитывается индивидуально под ваш объём. Подробнее о REST API Битрикс24 и Megaplan REST API.