# Перехід з KeyCRM: що переноситься і в якому порядку

https://krokul.com/uk/blog/pereyizd-z-keycrm/ · Команда Krokul · Оновлено 2026-11-04

Krokul CRM — B2B CRM для компаній, що працюють за договорами: угоди, проєкти й прибуток кожного клієнта в одній системі; впроваджують партнери-інтегратори. Цей посібник перелічує, що конектор KeyCRM переносить у Krokul, у якому порядку йдуть кроки й що лишається в KeyCRM.

**Коротка відповідь.** Щоб перейти з KeyCRM на Krokul, створіть у KeyCRM ключ публічного API, підключіть його, зіставте воронки, статуси й менеджерів, запустіть пробний прогін, який нічого не пише, і після нього імпорт. Krokul читає компанії, покупців, товари й картки воронок, записує їх у сталому порядку й зберігає кожен ID з KeyCRM. Відкат прибирає створене прогоном.

## Що переноситься, коли переходите з KeyCRM на Krokul

Переїзд з KeyCRM переносить чотири види записів і зберігає звʼязки між ними. Метод, на якому стоїть порядок, описано в посібнику про те, [як змінити CRM і не втратити дані](https://krokul.com/uk/blog/topics/switching-crm/), а ця стаття застосовує його до KeyCRM.

Конектор KeyCRM читає дані через публічний API KeyCRM і перетворює кожен запис на запис Krokul. Таблиця показує, чим стає кожен запис KeyCRM і які його поля приходять.

Записи KeyCRM й записи Krokul, якими вони стають:

| KeyCRM | Стає в Krokul | Що приходить |
|---|---|---|
| Компанії | Контрагенти | Назва, а коли її немає, юридична назва, юридична назва окремим полем, нотатки й відповідальний менеджер. Банківський рахунок у KeyCRM є вільним текстом, тому його збережено у власних даних запису. |
| Покупці | Контакти | Повне імʼя, а коли його немає, перший телефон чи пошта, усі телефони й усі адреси пошти, нотатка, день народження та звʼязок із компанією покупця. |
| Товари | Товари | Назва, опис, артикул, одиниця, категорія й закупівельна ціна. Ціна — найнижча серед варіантів, валюта — код валюти товару або UAH, а архівний товар приходить неактивним. |
| Картки воронок | Угоди | Назва, коментар менеджера, дата планового контакту, підсумок як очікувана сума, рядки (назва, артикул, кількість, ціна), воронка й статус, джерело, відповідальний менеджер, покупець як контакт угоди та теги. |
| Воронки, статуси, джерела й теги | Довідники | Читаються разом із записами, а тоді зіставляються з воронками, етапами, джерелами й тегами Krokul за правилами мапінгу. |
| Задачі | Не переноситься | У публічному API KeyCRM немає ресурсу задач. Дата планового контакту картки їде разом з угодою, а окремі задачі не створюються. |
| Чати й журнали дзвінків | Не переноситься | Вони є лише у внутрішньому API KeyCRM. Вивантажте їх з KeyCRM і збережіть архів. |

## У якому порядку йде переїзд з KeyCRM

Переїзд з KeyCRM складається з шести кроків, а Krokul записує дані в сталому порядку: контрагенти, контакти, товари й угоди, тож кожен звʼязок знаходить свою ціль уже на місці. Загальний перелік перевірок дає [чек-лист переїзду CRM](https://krokul.com/uk/blog/chek-lyst-pereizdu-crm/).

### 1. Порахуйте й почистьте записи в KeyCRM

Випишіть, скільки в KeyCRM компаній, покупців, товарів і карток, і занотуйте воронки, якими користуєтесь. Ці числа стануть підсумками, з якими ви звіряєтесь наприкінці.

Спершу обʼєднайте очевидні дублі покупців і компаній. Типово імпорт пропускає дубль компанії, контакту чи товару, а пробний прогін його рахує.

### 2. Підготуйте користувачів, воронку й етапи в Krokul

Запросіть людей, які ведуть картки в KeyCRM, бо імпорт ніколи не створює користувачів. Підготуйте воронку з етапами, щоб для кожного статусу KeyCRM був етап Krokul, у який він ляже.

Статуси зіставляються на кроці 4 за правилами, тож підготуйте етапи до цього кроку.

### 3. Створіть ключ публічного API в KeyCRM і підключіть його

У KeyCRM відкрийте «Налаштування», «Публічний API» й створіть ключ. Відкрийте екран «Міграція» в Krokul від імені адміністратора, оберіть KeyCRM джерелом, вставте ключ у поле «API-ключ KeyCRM» і натисніть «Перевірити підключення».

Ключ читає сервер, і після перевірки екран його більше не показує. Конектор надсилає лише запити на читання, тож у KeyCRM нічого не змінюється. Перевірка читає по одному запису кожного виду й показує загальні кількості, коли KeyCRM їх повертає.

> **Порада.** Поле «База API» можна лишити порожнім, а розмір сторінки джерела типово дорівнює 50, найбільшому значенню, яке приймає конектор.

![Міграція, крок «Джерело»: обрано KeyCRM, поле API-ключа, підказка «Де взяти ключ», кнопка перевірки підключення](https://krokul.com/img/uk/blog/pereyizd-keycrm-dostup.webp)

### 4. Зіставте воронки, статуси, джерела й менеджерів

Статуси KeyCRM стають етапами Krokul за правилами мапінгу, а джерела й менеджери зіставляються так само за правилами. Екран «Міграція» сьогодні не має кроку для цих правил, тож їх записує в прогін через API міграції партнер-впроваджувач або адміністратор, що працює з API.

KeyCRM не віддає списку менеджерів, тому список на кроці перевірки порожній, тож щоб зберегти менеджера з KeyCRM, правило менеджера записують вручну. Без нього Krokul призначає відповідального за власними правилами: менеджер компанії клієнта, тоді контакту, тоді пул воронки. Картка, воронці якої не відповідає жодне правило, лягає в першу зіставлену воронку, а картка з незіставленим статусом лягає в перший етап своєї воронки. Без жодного правила воронки й без воронки за замовчуванням картка потрапляє у звіт помилкою рядка з причиною, що воронку не зіставлено й воронки за замовчуванням не задано.

### 5. Запустіть пробний прогін і прочитайте звіт

Запустіть пробний прогін з кроку перевірки. Він бере ключ із перевірки підключення на сервері, читає весь акаунт KeyCRM зі швидкістю 60 запитів на хвилину, застосовує правила й нічого не записує в Krokul.

Порівняйте його підсумки з числами з кроку 1 і повторюйте пробний прогін після кожної зміни правил, доки в кожного помилкового рядка не буде причини, яку ви приймаєте, а числа пропущених не збігаються з вашим аудитом.

### 6. Запустіть імпорт і перевірте підсумок

Запустіть справжній прогін. Він іде на сервері у сталому порядку, тож його можна призупинити й продовжити або закрити сторінку й повернутись до підсумку. Підсумок показує створені, оновлені й помилкові рядки, і кожен помилковий має причину.

Порівняйте підсумки з кроком 1, відкрийте двадцять випадково обраних записів і звірте кожне поле з KeyCRM. Тримайте KeyCRM доступним, доки перевірка не пройде.

## Як картки воронок KeyCRM стають угодами в Krokul

Картка воронки KeyCRM стає угодою Krokul, а її статус стає етапом, і з нею приходять рядки й покупець. Сума картки, її загальний підсумок, стає очікуваною сумою угоди, а валюта кожної угоди — UAH.

- Покупець картки стає контактом угоди.
- Рядки картки зберігають назву, артикул, кількість і ціну, тож угода показує, що замовляли.
- Теги картки записуються після створення угоди. Якщо тег не вдалося записати, угода лишається, а рядок потрапляє в перелік помилок.

## Що показує пробний прогін переїзду з KeyCRM

Пробний прогін переїзду з KeyCRM показує для кожного виду записів, скільки записів Krokul справжній прогін створить, оновить і пропустить, і перелічує рядки, що впадуть, із причиною для кожного. Сама перевірка підключення цього не дасть, бо вона лише рахує записи, які бачить.

Приклад: звіт пробного прогону для акаунта KeyCRM:

| Записи | Буде створено | Буде оновлено | Буде пропущено |
|---|---|---|---|
| Контрагенти | 220 | 0 | 9 |
| Контакти | 1 260 | 0 | 85 |
| Товари | 310 | 0 | 0 |
| Угоди | 940 | 0 | 0 |

У прикладі нічого не буде оновлено, бо раніших прогонів немає. Звіт лише рахує 9 компаній і 85 контактів, які буде пропущено, бо типово Krokul пропускає запис, що дублює наявний у компанії. Політика дублів одна на весь прогін: пропустити, оновити чи створити. Вирішіть її до справжнього прогону.

## Як відкотити імпорт з KeyCRM, що ліг неправильно

Відкат імпорту з KeyCRM прибирає записи, які створив цей імпорт, і не чіпає решти. Він стосується одного прогону за раз і доступний лише для справжнього прогону.

- Записи, які створив прогін, прибираються, а останній вид записів іде першим.
- Записи, які прогін лише оновив, зберігають нові значення, тож за потреби виправте їх вручну.
- Записи, які хтось змінив після імпорту, лишаються на місці.
- Пробний прогін нічого не створив, тож відкочувати нічого.

Krokul зберігає ID з KeyCRM для кожного записаного запису, тому повторний прогін оновлює вже перенесені записи й не створює дублів. Звʼязки видно на вкладці «Зовнішні ID», див. [довідку про зовнішні ID](https://krokul.com/uk/help/mapinh-zviazky-z-dzherelom/).

## Що лишається в KeyCRM або потребує рішення

> Конектор KeyCRM написано за довідником KeyCRM й перевірено на змодельованих відповідях. Живим акаунтом KeyCRM його ще не перевіряли, тому пробний прогін на ваших даних стає першим справжнім випробуванням, і переїзд без нього починати не варто.

- Задачі, чати й журнали дзвінків не переносяться. Спершу вивантажте їх з KeyCRM.
- Кожна угода записується з валютою UAH, яку б валюту не мала картка, а товар без коду валюти теж дістає UAH, тож після пробного прогону перевірте суми.
- Без правила менеджера менеджера з KeyCRM не збережено, а відповідального призначає Krokul за власними правилами, тож за потреби запишіть правила менеджерів до прогону. Пробний прогін не проходить перевірки справжнього запису, тому справжній прогін ще може впасти на рядках, які проба пропустила.

## Хто веде переїзд: ваша команда чи партнер-впроваджувач

Компанія з коротким переліком покупців і кількома користувачами може сама підключити KeyCRM, запустити пробний прогін і прочитати звіт. Бізнес із живою воронкою, кількома менеджерами й роками замовлень дістає від партнера-впроваджувача правила воронок, статусів і менеджерів, розбір пробного прогону й фінальну перевірку, а ще навчання команди.

Сторінка про [джерела, які читає міграція Krokul](https://krokul.com/uk/solutions/migration/), перелічує, що Krokul переносить і що лишає, а сторінка [альтернатива KeyCRM для B2B](https://krokul.com/uk/compare/keycrm/) ставить дві системи поруч. Менше джерело проходить ті самі кроки, наприклад переїзд із SalesDrive, який читає лише замовлення. Екран «Міграція» описано в [довідці про імпорт даних](https://krokul.com/uk/help/import-danykh-v-crm/).

## Які помилки коштують найдорожче під час переїзду з KeyCRM

- Запуск імпорту до появи правил воронки. Картки тоді лягають у першу зіставлену воронку й її перший етап або падають з однією причиною, коли жодної воронки не зіставлено, тож спершу запишіть правила воронки й статусів і повторіть пробний прогін.
- Пропуск пробного прогону. Та сама помилка мапінгу повторюється на кожній картці, а показує її до запису лише пробний прогін.
- Закриття KeyCRM в день імпорту. Чати й журнали дзвінків недоступні через публічний API, тож тримайте акаунт доступним робочий тиждень і спершу вивантажте їх.
- Незіставлені менеджери. Менеджера з KeyCRM буде втрачено, а відповідального призначить Krokul, тож запишіть правила менеджерів до прогону.

## Питання й відповіді

### Скільки триває переїзд з KeyCRM?

Конектор читає KeyCRM зі швидкістю 60 запитів на хвилину, тож великий акаунт триває довше, а часу на живому акаунті KeyCRM ніхто не міряв, тому оцінки тут немає. Спершу запустіть пробний прогін: він читає весь акаунт без запису.

### Чи змінюється KeyCRM під час переїзду?

Ні, конектор надсилає в KeyCRM лише запити на читання. Ваші дані в KeyCRM лишаються як є, тому акаунт можна тримати відкритим, доки перевірка не пройде.

### Чи переносяться чати й задачі?

Задачі, чати й журнали дзвінків не переносяться, бо публічний API KeyCRM їх не віддає. Коментар менеджера й дата планового контакту картки приходять разом з угодою.

### Що буде з дублями?

Типово імпорт пропускає запис, що дублює наявний у компанії, а звіт пробного прогону рахує пропущені рядки.

### Хто може запустити міграцію в Krokul?

Міграцію запускає лише адміністратор. Ключ, який ви вставляєте, читає сервер, і після перевірки підключення його не показано.

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs
