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

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

Zoho CRM — масштабируемая платформа с развитой экосистемой продуктов. Компании переходят на Битрикс24 по разным причинам: консолидация инструментов (CRM + задачи + сайт в одном месте), локализация, ценообразование. Zoho предоставляет хорошее API, но модель данных требует внимательного изучения перед миграцией.

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

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

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

Помимо стандартных, в Zoho можно создавать кастомные модули — это аналог пользовательских сущностей без прямого аналога в базовом Битрикс24 (только в 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) аналогично Битрикс24, что упрощает маппинг. Нюанс: в Zoho конвертация лида создаёт Contact + Account + Deal одновременно. В Битрикс24 этот процесс аналогичен (конвертация лида). Сконвертированные лиды в Zoho не нужно мигрировать как лиды — они уже есть в Contacts и Deals.

Кастомные поля

Zoho поддерживает расширенные типы кастомных полей: Formula (вычисляемые поля), Subform (вложенные формы, аналог связанных таблиц), Multi-select Lookup. Эти типы не имеют прямого аналога в Битрикс24 и требуют принятия архитектурных решений:

• Formula — вычисляется в Битрикс24 через роботы или кастомные обработчики
• Subform — переносится как отдельная CRM-сущность с привязкой
• Multi-select Lookup — эмулируется через множественное поле типа crm

Роли и профили безопасности

Zoho CRM имеет развитую ролевую модель: профили, роли, правила разграничения доступа к записям (Record-level security). В Битрикс24 аналог — роли CRM и права доступа. Прямой миграции ролевой модели не существует — настраивается вручную по документации от заказчика.

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

Экосистема Zoho (Zoho Projects, Zoho Desk, Zoho Books) мигрирует по отдельным проектам — каждый продукт требует своей стратегии.