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

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

Pipedrive — CRM с акцентом на визуальное управление воронкой продаж. Её отличительная черта — простая, плоская модель данных без сложных иерархий. API Pipedrive хорошо документировано, что делает экспорт предсказуемым. Основная работа — в корректном маппинге концепций.

Объектная модель Pipedrive

Pipedrive строится вокруг пяти основных сущностей:

• Person — контакт (физическое лицо)
• Organization — компания/организация
• Deal — сделка, проходящая через воронку
• Activity — активность (звонок, встреча, задача, email, дедлайн)
• Lead — входящий лид (появился относительно недавно, это не то же самое, что лид в Битрикс)

Также есть Products (товары), Notes (заметки) и Files (вложения).

API Pipedrive: особенности

Pipedrive API v1 работает с API-ключом или OAuth2. Лимит запросов — 100 запросов в 10 секунд (для большинства тарифов). Пагинация — offset-based с параметрами start и limit:

$start = 0;
$allDeals = [];
do {
    $response = $pipedrive->get('/deals', [
        'start'  => $start,
        'limit'  => 500,
        'status' => 'all_not_deleted',
    ]);
    $allDeals = array_merge($allDeals, $response['data'] ?? []);
    $start = $response['additional_data']['pagination']['next_start'] ?? null;
} while ($start !== null && $response['additional_data']['pagination']['more_items_in_collection']);

Маппинг объектов Pipedrive → Битрикс24

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

Pipedrive позволяет добавлять кастомные поля к каждому объекту. Схему полей получаем через /dealFields, /personFields, /organizationFields. Каждое поле имеет key (уникальный идентификатор вида abc123def456) и field_type.

// Получение схемы полей сделок
$dealFields = $pipedrive->get('/dealFields')['data'];
$customFields = array_filter($dealFields, fn($f) => !$f['edit_flag'] === false && $f['id'] > 12);
// Поля с id > 12 — кастомные (системные поля имеют малые ID)

Типы полей Pipedrive и их аналоги в Битрикс24:

Воронки и стадии

Pipedrive поддерживает несколько воронок (pipelines). Каждая воронка имеет набор стадий. В Битрикс24 это «Направления сделок» (deal categories) со своими стадиями.

Последовательность действий:

1. Получить воронки через /pipelines
2. Получить стадии через /stages?pipeline_id=X
3. Создать направления в Битрикс24 через crm.dealcategory.add
4. Создать стадии через crm.status.add с ENTITY_ID = DEAL_STAGE_<category_id>
5. Сохранить маппинг stage_id Pipedrive → STATUS_ID Битрикс24

Активности и типы

Pipedrive имеет типы активностей: call, meeting, task, deadline, email, lunch. В Битрикс24 дела (crm.activity) имеют типы: 1 (звонок), 2 (встреча), 4 (email), 6 (задача). Маппинг нестандартных типов (lunch, deadline) — на задачи или кастомный тип активности.

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

Pipedrive не имеет аналогов Диска, чата и задачного трекера Битрикс24 — после миграции CRM пользователи осваивают эти инструменты отдельно.