Міграція даних з 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. Паралельна робота в двох системах на перехідний період — стандартна практика.