Ручной экспорт данных из 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: выявим узкие места и дадим рекомендации.