> Усі статті WIKI Helomi: /wiki/llms.txt

# KeepinCRM (перехід)

Картка KeepinCRM потрібна на час переходу зі старої CRM на Helomi. Через ключ API KeepinCRM працює дзеркало: кожні 5 хвилин угоди, клієнти, товари, платежі, задачі й доставки з KeepinCRM підтягуються в Helomi без дублів, а ШІ-агенти, які ще не переведені, читають і пишуть у KeepinCRM. Канали продажів перемикаються на Helomi по одному.

## Можливості
- Перевірка ключа KeepinCRM.
- Дзеркало кожні 5 хвилин: лише нове й змінене, повтор не дублює.
- Ручний імпорт з дати — «Налаштування → Система → Імпорт із KeepinCRM».
- Показ «бекенду CRM для ШІ» — куди зараз ходять ШІ-агенти.

## 1. Налаштування
Дорога: «Налаштування» → «Інтеграції» → вкладка «Інше» → картка «KeepinCRM» → «Підключення».

1. «API ключ» → «Ввести» → «Зберегти ключ». Ключ — у налаштуваннях вашого акаунта KeepinCRM. Зберігається зашифрованим.
2. «Перевірити» → «користувачів у CRM: N».
3. «Стан роботи» → «Бекенд CRM для ШІ»: `keepin` (ШІ-агенти працюють з KeepinCRM), `both` або `local`. Те саме видно в шапці каталогу «Інтеграцій». Змінює його розробник на сервері.

## 2. Дзеркало KeepinCRM
Дзеркало працює саме: кожні 5 хвилин бере з KeepinCRM записи, змінені з попереднього прогону (із запасом 10 хвилин), і оновлює їх у Helomi. Нові угоди з'являються з подією «створено» від «дзеркало KeepinCRM». Час останньої синхронізації — у картці (стан і «Журнал подій»: записи лише тоді, коли щось змінилося або сталася помилка). Щодня до повного переходу варто дивитися, що остання синхронізація не старша за 10 хвилин.

Тригери Webhook на записи з дзеркала не спрацьовують — у KeepinCRM спрацювали свої.

**Що саме тягнути — вирішуєте ви.** У картці KeepinCRM блок «Дзеркало KeepinCRM»: головний перемикач «Дзеркало» (без вибору — як у `.env`) і перемикачі «Клієнти», «Угоди (з доставками й платежами)», «Товари складу», «Завдання». Вимкнена сутність більше не оновлюється з KeepinCRM — записи в Helomi стають основними. Зміна діє на наступному колі дзеркала (до 5 хвилин), без перезапуску; хто і коли змінив — у «Журналі подій» картки. З 14.10 (перехід на свою CRM) увімкнено лише «Клієнти»: угоди, завдання й товари складу живуть у Helomi, а замовлення з маркетплейсів і сайтів приходять напряму (див. розділ 4). Міняти може лише адміністратор.

## 3. Імпорт із KeepinCRM
«Налаштування → Система → Імпорт із KeepinCRM»: «Лише записи, оновлені з дати» → «Запустити». Імпорт іде у фоні: «Імпорт запущено у фоні — журнал оновиться». Таблиця прогонів: «Початок», «Кінець», «Джерело», «З дати», «Стан», «Лічильники».

## 4. Перемикання каналів
Канал продажів (Prom, Rozetka, Kasta, Епіцентр, сайти…) перемикається на Helomi у своїй картці перемикачем або кнопкою «Підключити … одним натиском». **Того ж дня** вимкніть цей канал у KeepinCRM — інакше замовлення прийде двічі: напряму і дзеркалом. Наступного дня звірте кількість угод каналу за добу з кабінетом маркетплейсу.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «не задано (у картці чи .env): KEEPINCRM_API_KEY» | Ключ не введено | Введіть «API ключ» |
| «HTTP 401» після «Перевірити» | Ключ KeepinCRM недійсний | Створіть новий ключ у KeepinCRM |
| Синхронізація старша за 10 хвилин | Дзеркало зупинилося або KeepinCRM недоступна | Подивіться «Журнал подій» картки |
| Угода прийшла двічі | Канал увімкнено і тут, і в KeepinCRM | Вимкніть канал у KeepinCRM |
| Угода з KeepinCRM не з'явилась у Helomi | У «Дзеркалі KeepinCRM» вимкнено «Угоди» (так і задумано з 14.10) | Замовлення приходять напряму з каналу; якщо треба — увімкніть «Угоди» |
| «Невідома сутність дзеркала» | У запиті PUT /api/crm/mirror/settings чужий ключ | Ключі: clients, agreements, materials, tasks |

## Для ШІ-співробітників
5`). Записи з дзеркала — звичайні угоди, клієнти й товари, ШІ працює з ними своїми інструментами. Статтю ШІ читає інструментом `help("int-keepincrm")`.

## Додаткова інформація
- Пов'язані статті: [Імпорт і експорт](import-export.md), [Угоди](deals.md).