Міграція даних з Zoho CRM до Бітрікс24

Міграція даних із Zoho CRM у Bitrix24

Zoho CRM — масштабована платформа з розвиненою екосистемою продуктів. Компанії переходять на Bitrix24 з різних причин: консолідація інструментів (CRM + задачі + сайт в одному місці), локалізація, ціноутворення. Zoho надає хороший API, але модель даних вимагає уважного вивчення перед міграцією.

Структура даних Zoho CRM

Zoho CRM оперує модулями (аналог об'єктів). Стандартні модулі:

• Leads — ліди (первинні контакти)
• Contacts — контакти (кваліфіковані)
• Accounts — компанії/організації
• Deals — угоди (Opportunities)
• Activities — активності: Tasks, Events, Calls
• Cases — звернення підтримки

Крім стандартних, у Zoho можна створювати кастомні модулі — це аналог користувацьких сутностей без прямого аналога у базовому Bitrix24 (тільки в On-Premise через кастомну розробку).

Zoho API v2: особливості

Zoho використовує OAuth2. API v2 повертає дані з пагінацією через параметри page та per_page (максимум 200 записів за запит):

$page = 1;
$leads = [];
do {
    $response = $zoho->get('/crm/v2/Leads', [
        'page'     => $page,
        'per_page' => 200,
        'fields'   => 'First_Name,Last_Name,Email,Phone,Company,Lead_Status,Owner',
    ]);
    $leads = array_merge($leads, $response['data'] ?? []);
    $page++;
    $info = $response['info'];
} while ($info['more_records']);

Отримання метаданих модуля (список полів):

$fields = $zoho->get('/crm/v2/settings/fields', ['module' => 'Leads'])['fields'];

Маппінг: Leads і Contacts

Zoho CRM розділяє «Ліди» (Leads) і «Контакти» (Contacts) аналогічно Bitrix24, що спрощує маппінг. Нюанс: у Zoho конвертація ліда створює Contact + Account + Deal одночасно. У Bitrix24 цей процес аналогічний (конвертація ліда). Сконвертовані ліди у Zoho не потрібно мігрувати як ліди — вони вже є у Contacts і Deals.

Кастомні поля

Zoho підтримує розширені типи кастомних полів: Formula (обчислювані поля), Subform (вкладені форми, аналог пов'язаних таблиць), Multi-select Lookup. Ці типи не мають прямого аналога у Bitrix24 і вимагають прийняття архітектурних рішень:

• Formula — обчислюється у Bitrix24 через роботи або кастомні обробники
• Subform — переноситься як окрема CRM-сутність із прив'язкою
• Multi-select Lookup — емулюється через множинне поле типу crm

Ролі та профілі безпеки

Zoho CRM має розвинену рольову модель: профілі, ролі, правила розмежування доступу до записів (Record-level security). У Bitrix24 аналог — ролі CRM та права доступу. Прямої міграції рольової моделі не існує — налаштовується вручну за документацією від замовника.

Типові терміни

Екосистема Zoho (Zoho Projects, Zoho Desk, Zoho Books) мігрує окремими проєктами — кожен продукт вимагає своєї стратегії.