Миграция данных из Salesforce в Битрикс24

Миграция данных из Salesforce в Битрикс24

Salesforce хранит данные в собственной объектной модели: Account, Contact, Lead, Opportunity, Task, Event — и каждый объект может иметь сотни кастомных полей, настроенных под конкретный бизнес. Прямого импорта между Salesforce и Битрикс24 не существует. Задача решается через промежуточный слой: экспорт через Salesforce API или Data Export, трансформация данных, загрузка через REST API Битрикс24.

Анализ структуры данных Salesforce

Первый шаг — аудит того, что реально используется. В типичном Salesforce-аккаунте накапливается несколько лет мусора: удалённые записи в корзине, дублированные контакты, устаревшие поля с нулевым заполнением. Перед миграцией необходимо:

• Выгрузить схему объектов через describeSObjects() API и составить маппинг на сущности Битрикс24
• Проверить объёмы: Salesforce Data Export даёт CSV-файлы, разбитые по объектам, но связи между записями (lookup-поля) хранятся как Salesforce ID — их нужно резолвить в новые ID Битрикс24
• Оценить кастомные объекты (Custom Objects): они могут не иметь прямого аналога в Битрикс24 и потребуют создания пользовательских полей или отдельных разделов CRM

Маппинг базовых объектов:

Технический процесс миграции

Экспорт из Salesforce выполняется двумя способами:

1. Data Export (Setup → Data Export) — полный дамп в ZIP с CSV. Удобно для разовой миграции, но выгрузка формируется до 48 часов, и при большом объёме файлы разбиваются на части по объекту.
2. Salesforce API (REST/Bulk API 2.0) — предпочтительно для больших объёмов (от 50 000 записей). Bulk API 2.0 работает асинхронно: создаёте job, загружаете данные, ждёте выполнения, скачиваете результат.

POST /services/data/v58.0/jobs/ingest
{
  "operation": "query",
  "query": "SELECT Id, Name, Phone, BillingCity FROM Account WHERE IsDeleted = false"
}

Трансформация данных — самый трудоёмкий этап. Проблемы, которые встречаются почти всегда:

• Телефоны в Salesforce хранятся в произвольном формате; Битрикс24 принимает их через crm.contact.update в поле PHONE как массив с типом WORK/MOBILE/HOME
• Адреса в Salesforce — плоская структура (BillingStreet, BillingCity); в Битрикс24 адрес компании хранится через crm.address.add с привязкой к ENTITY_TYPE_ID=4 (компания)
• Пользователи: владелец записи в Salesforce (OwnerId) нужно сопоставить с пользователями Битрикс24 через user.get по email или имени

Загрузка в Битрикс24 через REST API:

• crm.contact.add / crm.company.add — добавление по одной записи; при больших объёмах используйте batch-метод (до 50 запросов за раз)
• Порядок загрузки критичен: сначала компании, потом контакты (чтобы была возможность указать COMPANY_ID), затем сделки
• Сохраняйте маппинг Salesforce ID → Битрикс24 ID в промежуточной таблице — он нужен для привязки задач, событий, файлов

История взаимодействий и вложения

Письма, звонки, встречи из Salesforce Activity History мигрируют в Битрикс24 как дела CRM (crm.activity.add). Вложенные файлы — через crm.timeline.comment.add с base64-кодированием или предварительной загрузкой через disk.folder.uploadfile.

Объём вложений нередко становится сюрпризом: 5–10 лет работы в Salesforce легко дают 50–100 ГБ файлов. Это требует отдельной стратегии: либо выборочная миграция (только последние N лет), либо архивный доступ к Salesforce остаётся на период адаптации.

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

После завершения переноса обязательна фаза верификации: выборочная сверка записей, проверка связей, тест уведомлений и автоматизаций в Битрикс24. Параллельная работа в двух системах на переходный период — стандартная практика.