# Переїзд з ClickUp у Krokul: угоди, контакти, задачі

Перенесіть угоди, контакти, компанії й задачі з ClickUp разом із підзадачами, коментарями й звʼязками між ними.

Теги: переїзд з clickup, міграція з clickup, імпорт задач, розкладка списків, перенесення crm

## Коротко
- **Розкладка списків** — для кожного списку ClickUp ви обираєте, що в ньому: угоди, контакти, компанії, задачі чи «Пропустити».
- **Мапа полів** — яке власне поле ClickUp у яке поле Krokul: телефон, пошта, сума, дата закриття, звʼязок, власне поле.
- **Чернетка помічника** — розкладку може скласти Kro, а ви її правите й затверджуєте.
- **Пробний прогін** показує, що створиться, і нічого не записує.

## Як зробити
### Підключити ClickUp
Потрібен особистий токен — ClickUp видає його будь-якому учаснику Workspace.
1. У ClickUp натисніть аватар → «Settings» → «Apps» → «API Token» → «Generate» і скопіюйте токен, що починається з «pk_».
2. У Krokul на вкладці «Перенесення» оберіть джерело «ClickUp».
3. Вставте токен у поле «API-токен ClickUp» і натисніть «Перевірити підключення».
> Порада: Токен бачить лише сервер Krokul. Після перевірки на екрані лишається маска.
> Важливо: У ClickUp може бути кілька Workspace. Без «Workspace ID» Krokul бере перший, доступний токену.

### Розкласти списки
У ClickUp усе — задачі в списках, тож Krokul питає, що чим є.
1. На кроці мапінгу відкрийте секцію «Розкладка списків»: списки згруповано за Space і Folder, поруч — скільки в кожному задач.
2. Натисніть «Скласти помічником», щоб Kro запропонував чернетку, — або розкладіть руками.
3. Для кожного списку оберіть роль: «Угоди», «Контакти», «Компанії», «Задачі» чи «Пропустити». Лічильник „у роботі N з M“ показує, скільки списків переноситься.
4. Розгорніть список і в «Поля списку» для кожного поля оберіть «Куди перенести» — перелік нижче.
5. Для списку з роллю «Задачі» в «Статуси ClickUp» оберіть стан кожного статусу: «Відкрита», «Виконана» чи «Скасована».
6. Для списку з роллю «Угоди» в «Етапи воронки» натисніть «Задати етапи»: Krokul візьме статуси списку, а ви перейменуєте, додасте, приберете чи пересунете етапи й оберете вид кожного — «Відкритий», «Виграш» або «Програш». Потрібні щонайменше один виграш і один програш. «Етапи зі статусів списку» повертає початковий вигляд.
7. У «Правило статусу ClickUp» для кожного статусу оберіть «Етап», за потреби впишіть «Тег угоди» і, якщо етап програшний, «Причину програшу». Кілька статусів можуть вести в один етап: 16 статусів ClickUp легко стають 10 етапами. Якщо причини програшу ще немає, Krokul заведе її сам. Для відкритого статусу в тому ж стовпці оберіть «Стан угоди»: «Пауза до дня» або «Передано партнеру». Статуси на кшталт «on hold» чи «waiting» Krokul позначає паузою, а «partner» — передачею сам, ви можете це змінити. Пауза триває до дати з поля «Звʼязатися до», а без неї — 14 днів. Для «Передано партнеру» оберіть партнера внизу розкладки; без нього угоди лишаються відкритими.
8. Для списку з роллю «Задачі» оберіть «Проєкт для задач списку»: «Не створювати», «Зі списку» або «З папки». Задачі й підзадачі списку лягуть у проєкт. «З папки» доступне, лише коли список лежить у папці.
9. Під розкладкою оберіть перемикачі: «Створити власні поля», «Переносити коментарі», «Переносити підзадачі», «Переносити архівні задачі» — і «Виконавець задач без виконавця». Порожній вибір лишає такі задачі без виконавця.
- «Контакти» — «Телефони», «Пошта», «Посада», «Компанія текстом», «Звʼязок із компанією»;
- «Компанії» — «ЄДРПОУ»;
- «Угоди» — «Сума угоди», «Дата закриття», «Звʼязатися до», «Питання кваліфікації воронки», «Компанія текстом», «Звʼязок із контактом», «Звʼязок із компанією»;
- «Задачі» — «Звʼязок з угодою», «Звʼязок із контактом», «Звʼязок із компанією»;
- для будь-якого списку — наявне власне поле Krokul, «У текст запису», «Нове власне поле» або «Не переносити».
> Порада: Помічник бачить лише назви списків, статусів і полів та кілька прикладів значень. Телефони й пошта йдуть йому маскою.
> Важливо: Список з роллю «Пропустити» не переноситься. Перед прогоном Krokul перевіряє розкладку: список чи поле з помилкою позначено «Є помилки», а причина стоїть під полем.

### Перевірити й запустити
1. Запустіть пробний прогін — він перевіряє й запамʼятовує розкладку, рахує, що створиться, і нічого не пише.
2. Подивіться лічильники: компанії, контакти, угоди, задачі, коментарі, нові власні поля.
3. Запустіть бойовий прогін.
> Порада: Прогін можна призупинити й продовжити — Krokul почне з місця зупинки.

## Як це влаштовано
**Що куди.** Список з роллю «угоди» стає воронкою, його статуси — етапами. Закритий статус, чия назва про виграш («Оплачено»), стає виграним етапом, решта закритих — програними. Задача списку контактів — контакт: назва задачі — імʼя, телефони й пошта — з полів. Задача списку компаній — компанія. Текстове поле «Компанія» у контактах чи угодах дає одну компанію на кожну назву.

**Етапи й правила статусів.** Без власних етапів воронка повторює статуси списку. З етапами кілька статусів сходяться в один етап, а правило статусу додає тег («не бере слухавку» → етап «Кваліфікація» і тег «Не відповідає») або причину програшу для закритого статусу. Поле дати можна перенести в «Звʼязатися до» угоди, а поле-анкету — у питання кваліфікації воронки.

**Звʼязки.** Поле-звʼязок ClickUp (Relationship) з контакту на компанію, з угоди на контакт чи компанію, із задачі на угоду переноситься звʼязком у Krokul.

**Підзадачі.** З увімкненим «Переносити підзадачі» підзадача стає підзадачею Krokul. У Krokul один рівень вкладеності: глибша підзадача лягає під верхню задачу. Підзадача угоди чи контакту стає задачею цієї угоди чи контакту.

**Задачі.** Строк, оцінка часу, чек-лист і виконавець переносяться. Статус ClickUp стає «Відкрита», «Виконана» чи «Скасована» за розкладкою; закриті статуси — «Виконана».

**Коментарі.** З увімкненим «Переносити коментарі» коментар угоди, контакту чи компанії стає подією в стрічці, з автором і датою в тексті. Коментарі задачі дописуються в її опис. На задачу — до 50 коментарів.

**Виконавці.** Учасник ClickUp стає менеджером чи виконавцем за мапою користувачів на тому ж кроці. Учасника без пари Krokul лишає без виконавця.

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

**Швидкість.** ClickUp дозволяє 100 запитів на хвилину. Коментарі — окремий запит на кожну задачу, тож 3 000 задач із коментарями переїжджають близько 35 хвилин, без коментарів — 1–2 хвилини.

**Відкат.** Відкат прибирає рівно створене прогоном, разом із новими власними полями. Записи, які хтось уже змінив, лишаються.

**Що не переноситься.** Docs, Goals, Whiteboards, автоматизації й права доступу лишаються в ClickUp. Вкладення переносяться посиланнями.

Повʼязані вікна: «Міграція», «Власні поля», «Воронки».

## Питання й відповіді
### Чи можна перенести дані з ClickUp у Krokul?
Так. Оберіть джерело «ClickUp» у «Міграції», вставте особистий токен API, розкладіть списки й запустіть прогін.

### Навіщо розкладати списки, якщо Krokul сам бачить ClickUp?
ClickUp не знає, що таке угода чи контакт: це задачі у списках, які команда назвала по-своєму. Розкладка — ваше рішення, що з них чим стане в CRM.

### Чи обовʼязково задавати етапи воронки?
Ні. Без них угоди лягають в етапи, що повторюють статуси списку, а тег і причину програшу можна вказати й так. Власні етапи потрібні, коли статусів ClickUp більше, ніж етапів, які ви хочете бачити в Krokul.

### Чи пише помічник у мою базу?
Ні. Помічник лише пропонує розкладку. Записи робить прогін, який запускаєте ви, після пробного прогону.

### Що буде з підзадачами третього рівня?
Підзадачі третього рівня лягають під верхню задачу: у Krokul підзадачі мають один рівень.

### Чи переносяться закриті задачі?
Так, разом з відкритими. Закриті стають виконаними або скасованими — як задано в «Статуси ClickUp» розкладки. Архівні задачі переносяться, коли в розкладці увімкнено «Переносити архівні задачі».

### Що робить «У текст запису»?
Значення поля дописується в опис угоди, контакту, компанії чи задачі. Так переносять поля, які важливо зберегти, але окреме власне поле для них заводити не варто.

---

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