Ручний експорт даних з HubSpot в CSV з наступним імпортом в Бітрікс24 часто призводить до втрат: порушуються зв'язки між контактами та угодами, фрагментується історія комунікацій, кастомні поля залишаються порожніми. При цьому організації несуть ризики — втрачені дані можуть коштувати до 30% виручки. Ми переносимо дані через HubSpot API v3 та Бітрікс24 REST API безпосередньо, зберігаючи структуру зв'язків та історію. Команда має 5+ років досвіду та понад 50 завершених проектів. Отримайте консультацію щодо вашого проекту — ми оцінимо обсяг даних та запропонуємо оптимальний план міграції без втрати даних.
Чому міграція з HubSpot в Бітрікс24 складніша, ніж здається?
HubSpot API v3 надає доступ до всіх об'єктів: contacts, companies, deals, tickets, engagements. Але структура зв'язків відрізняється. HubSpot використовує асоціації з множинними зв'язками, Бітрікс24 — більш пласку модель з однією основною компанією для контакту. Без пріоритизації мультизв'язків можна втратити дані. Крім того, HubSpot дозволяє створювати довільні властивості для кожного об'єкта, які необхідно мапити на користувацькі поля. Документація HubSpot API описує понад 20 типів полів, і кожен вимагає точного зіставлення.
Як мігрувати контакти та угоди?
Експорт через HubSpot API виконується курсорною пагінацією:
$after = null; $contacts = []; do { $params = ['limit' => 100, 'properties' => 'firstname,lastname,email,phone,company']; if ($after) $params['after'] = $after; $response = $hubspot->get('/crm/v3/objects/contacts', $params); $contacts = array_merge($contacts, $response['results']); $after = $response['paging']['next']['after'] ?? null; } while ($after); Імпорт в Бітрікс24 — через REST API: crm.contact.add, crm.company.add, crm.deal.add. Мапінг полів стандартний (email, phone, name). Важливо враховувати, що телефон в Бітрікс24 зберігається як масив, тому множинні номери потрібно передавати через PHONE з типом WORK або MOBILE.
Таблиця мапінгу об'єктів
| HubSpot | Бітрікс24 | Особливості |
|---|---|---|
| Contact | Контакт | email → EMAIL, phone → PHONE (масив) |
| Company | Компанія | Прив'язка через COMPANY_ID |
| Deal | Угода | Pipeline → напрям угод |
| Ticket | Лід або тікет helpdesk | Залежить від процесів |
| Owner | Користувач Бітрікс24 | Мапінг по email |
| Engagement (note) | Коментар таймлайна | crm.timeline.comment.add |
| Engagement (email) | Справа «Лист» | crm.activity.add |
| Engagement (call) | Справа «Дзвінок» | crm.activity.add |
Що робити з кастомними полями?
HubSpot дозволяє створювати довільні властивості для кожного об'єкта. Схему отримуємо через /crm/v3/properties/contacts. Для кожного кастомного поля створюємо користувацьке поле в Бітрікс24 через crm.userfield.add. Типи зіставляються:
| HubSpot fieldType | Бітрікс24 USER_TYPE_ID |
|---|---|
text |
string |
number |
double |
date |
date |
datetime |
datetime |
checkbox |
boolean |
select, radio |
enumeration |
textarea |
string |
Які ризики при міграції та як їх уникнути?
Основний ризик — втрата зв'язків між об'єктами через різницю в моделях даних. Для мінімізації ми використовуємо багатоетапне тестування: спочатку переносимо невелику вибірку (100–500 записів), перевіряємо коректність мапінгу та зв'язків, потім запускаємо повне перенесення. Додатково налаштовуємо логування помилок для кожного виклику REST API. Якщо якийсь запис не створюється через дублікат або некоректне поле, ми фіксуємо його та обробляємо окремо. Гарантія цілісності підтверджується сертифікованими спеціалістами з багаторічним досвідом.
Обсяг робіт з міграції
У міграцію входить повний експорт через HubSpot API (контакти, компанії, угоди, активності, асоціації), створення користувацьких полів в Бітрікс24, мапінг та перенесення історії комунікацій (листи, дзвінки, зустрічі), налаштування напрямів угод та стадій, багатоетапне тестування після перенесення, передача документації з мапінгу та навчання команди.
Процес роботи
- Аналіз вихідної схеми: збираємо список об'єктів, кастомних полів, асоціацій.
- Проектування мапінгу: визначаємо відповідність полів та типів.
- Розробка скриптів міграції на PHP з використанням HubSpot API та Бітрікс24 REST API.
- Тестове перенесення на невеликій вибірці (100–500 записів) для перевірки.
- Повне перенесення даних, включаючи історію комунікацій.
- Фінальне тестування: звірка кількості записів, вибіркова перевірка угод та контактів.
- Деплой та навчання користувачів.
Типові терміни та гарантії
| Масштаб | Термін |
|---|---|
| до 10 000 контактів, базові дані | 2–3 тижні |
| 10 000–50 000 записів, активності | 4–8 тижнів |
| 50 000+ записів, вся історія | 2–4 місяці |
Ми гарантуємо цілісність даних та мінімальний даунтайм. Перенесення через API HubSpot на порядок швидше за ручний експорт в CSV. Зв'яжіться з нами для оцінки вашого проекту — підберемо оптимальний план міграції без втрат. Також ви можете замовити аудит поточної CRM: виявимо вузькі місця та дамо рекомендації.