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

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

Pipedrive — CRM із акцентом на візуальне управління воронкою продажів. Її відмінна риса — проста, плоска модель даних без складних ієрархій. API Pipedrive добре задокументовано, що робить експорт передбачуваним. Основна робота полягає у коректному маппінгу концепцій.

Об'єктна модель Pipedrive

Pipedrive будується навколо п'яти основних сутностей:

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

Також є 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 → Bitrix24

Кастомні поля 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 та їхні аналоги у Bitrix24:

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

Pipedrive підтримує кілька воронок (pipelines). Кожна воронка має набір стадій. У Bitrix24 аналогом є «Напрями угод» (deal categories) зі своїми стадіями.

Послідовність дій:

1. Отримати воронки через /pipelines
2. Отримати стадії через /stages?pipeline_id=X
3. Створити напрями у Bitrix24 через crm.dealcategory.add
4. Створити стадії через crm.status.add з ENTITY_ID = DEAL_STAGE_<category_id>
5. Зберегти маппінг stage_id Pipedrive → STATUS_ID Bitrix24

Активності та типи

Pipedrive має типи активностей: call, meeting, task, deadline, email, lunch. У Bitrix24 справи (crm.activity) мають типи: 1 (дзвінок), 2 (зустріч), 4 (email), 6 (задача). Нестандартні типи (lunch, deadline) маппляться на задачі або кастомний тип активності.

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

Pipedrive не має аналогів Диску, чату та трекера задач Bitrix24 — після міграції CRM користувачі освоюють ці інструменти окремо.