Перенос 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.