Как интегрировать стороннюю CRM с Битрикс24: маппинг и дедупликация

При переносе 50 000 контактов из Salesforce в Битрикс24 менеджеры потеряли связи сделок с контактами — знакомая ситуация? Каждая CRM имеет собственную модель данных, логику связей и специфику полей. Битрикс24 — тоже. Главная задача миграции: сохранить целостность данных и историю отношений. Наша команда имеет более 10 лет опыта в таких проектах, поэтому мы знаем все подводные камни.

Компании выбирают Битрикс24 из-за интеграции с 1С и единой экосистемы для продаж и поддержки. Перенос данных — сложный процесс, требующий глубокого понимания обеих систем. Наш опыт гарантирует, что после переноса менеджеры увидят полную историю отношений с клиентами, как будто всегда работали в Битрикс24.

Как избежать потери данных при переносе?

Самая частая ошибка — прямой экспорт таблиц без учёта ссылочной целостности. Например, сделка ссылается на контакт, а контакт — на компанию. Если создать сделку раньше компании, Битрикс24 вернёт ошибку. Поэтому мы строго соблюдаем порядок: компании → контакты → сделки → активности. Каждый этап фиксируется в маппинг-файле.

Структура данных Битрикс24

Прежде чем мигрировать, нужно понять, куда кладутся данные. Ключевые сущности Битрикс24:

Связи: контакт привязан к компании через b_crm_company_contact, сделка — к контакту через b_crm_deal_contact.

Инструменты переноса

REST API Битрикс24 — официальный и наиболее надёжный метод. Поддерживает пакетные запросы (batch), что критично при переносе тысяч записей:

$batchCalls = [];
foreach ($contacts as $contact) {
    $batchCalls['create_contact_' . $contact['id']] = [
        'method' => 'crm.contact.add',
        'params' => [
            'fields' => [
                'NAME'       => $contact['first_name'],
                'LAST_NAME'  => $contact['last_name'],
                'EMAIL'      => [['VALUE' => $contact['email'], 'VALUE_TYPE' => 'WORK']],
                'PHONE'      => [['VALUE' => $contact['phone'], 'VALUE_TYPE' => 'WORK']],
                'COMPANY_ID' => $companyMapping[$contact['company_id']] ?? null,
                'UF_CRM_SOURCE_ID' => $contact['id'],
            ],
        ],
    ];
}

$result = $b24->callBatch(array_slice($batchCalls, 0, 50));

Согласно документации Битрикс24, один batch-запрос может содержать до 50 команд. Прямая запись в БД — для облачного Битрикс24 недоступна. Для коробочной версии — ускоряет массовый импорт, но требует ручной перестройки индексов и осторожности с триггерами. REST API медленнее, но безопаснее: в 2-3 раза медленнее при пакетной записи, зато даёт полный контроль и возможность отката. REST API безопаснее прямого SQL в 3 раза, хотя и медленнее.

Прямой SQL не стоит использовать в облаке, так как облачный Битрикс24 не предоставляет доступ к базе данных. Даже в коробочной версии мы рекомендуем REST API для отслеживания и отката.

Почему маппинг полей — самая трудоёмкая часть?

Каждое поле источника нужно сопоставить с полем Битрикс24. Пример маппинга из HubSpot (см. HubSpot - Wikipedia):

Нестандартные поля HubSpot переносятся в пользовательские поля Битрикс24 (UF-поля). Их нужно создать заранее через crm.contact.userfield.add.

Что делать с дубликатами?

Сторонние CRM часто содержат дубли контактов (один человек под разными email). Перед миграцией — дедупликация в источнике. Стратегии:

• Жёсткая: один уникальный email = один контакт. Дубли объединяются.
• Мягкая: переносим все записи, затем используем встроенный инструмент дедупликации Битрикс24 (Контакты → Дубликаты).

Рекомендуется мягкая стратегия — сохраняет все данные, дедупликацию менеджеры делают в процессе работы.

Последовательность создания сущностей

Порядок важен из-за ссылочной целостности:

1. Компании
2. Контакты (привязка к компаниям)
3. Сделки (привязка к контактам и компаниям)
4. Активности — звонки, письма, задачи
5. Комментарии и история — через crm.timeline.comment.add

После создания каждой сущности сохраняем маппинг: source_id → b24_id.

$mappingFile = 'migration_map.json';
$mapping = json_decode(file_get_contents($mappingFile), true) ?: [];
$mapping['contacts'][$sourceContact['id']] = $b24ContactId;
file_put_contents($mappingFile, json_encode($mapping));

История активностей: звонки и письма

Перенос истории коммуникаций — опциональная, но ценная часть. Звонки из источника → crm.activity.add с типом CALL:

$b24->call('crm.activity.add', [
    'fields' => [
        'OWNER_TYPE_ID' => 3,
        'OWNER_ID'      => $mapping['contacts'][$call['contact_id']],
        'TYPE_ID'       => 2,
        'SUBJECT'       => 'Звонок от ' . date('d.m.Y', strtotime($call['created_at'])),
        'DESCRIPTION'   => $call['notes'],
        'START_TIME'    => $call['created_at'],
        'END_TIME'      => $call['ended_at'],
        'DIRECTION'     => $call['direction'] === 'inbound' ? 1 : 2,
        'COMPLETED'     => 'Y',
    ],
]);

Контроль качества после переноса

После миграции — обязательная сверка:

SELECT COUNT(*) FROM hubspot_contacts WHERE is_deleted = 0;
# → 12 847

SELECT COUNT(*) FROM b_crm_contact WHERE DELETED = 'N';
# → 12 839  ← 8 записей потеряно — расследуем

Расхождения логируются и анализируются: обычно это дубли или записи с невалидными данными.

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

Мы предоставляем полный комплекс услуг:

• Аудит исходной CRM — анализ модели данных, выявление дублей и невалидных записей.
• Создание маппинг-карты — сопоставление всех полей и типов.
• Разработка скриптов миграции — на PHP/JavaScript с использованием REST API.
• Тестовая миграция — на копию данных, проверка целостности.
• Финальный перенос — с минимальным даунтаймом (обычно в выходные).
• Пост-миграционная поддержка — 2 недели консультаций и доработок.
• Документация — описание всех созданных полей и связей.

Бюджет на миграцию для небольшой CRM обычно составляет от 30 000 до 60 000 руб., а для крупных проектов с полной историей — от 150 000 руб. Экономия при заказе комплексной миграции вместо поэтапного переноса может достигать 40%.

Сроки выполнения

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

Успешная миграция — это когда менеджеры в Битрикс24 на следующий день видят полную историю отношений с клиентами, как будто всегда работали здесь. Закажите консультацию — мы оценим проект за один день.

Официальное руководство по REST API Битрикс24