KeepinCRM (migration)
The KeepinCRM card is needed while you move from the old CRM to Helomi. A mirror runs through the KeepinCRM API key: every 5 minutes, deals, clients, products, payments, tasks, and deliveries from KeepinCRM are pulled into Helomi without duplicates, while AI agents that haven't been moved over yet read from and write to KeepinCRM. Sales channels are switched over to Helomi one at a time.
This article is in Ukrainian for now. Ask Lomi in your language — she will read the article and answer. Talk to Lomi
On this page
Можливості
- Перевірка ключа KeepinCRM.
- Дзеркало кожні 5 хвилин: лише нове й змінене, повтор не дублює.
- Показ «бекенду CRM для ШІ» — куди зараз ходять ШІ-агенти.
1Налаштування
Дорога: «Налаштування» → «Інтеграції» → вкладка «Інше» → картка «KeepinCRM» → «Підключення».
- «API ключ» → «Ввести» → «Зберегти ключ». Ключ — у налаштуваннях вашого акаунта KeepinCRM. Зберігається зашифрованим.
- «Перевірити» → «користувачів у CRM: N».
- «Стан роботи» → «Бекенд 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, а замовлення з маркетплейсів і сайтів приходять напряму (див. розділ 3). Міняти може лише адміністратор.
3Перемикання каналів
Канал продажів (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")`.
Додаткова інформація
- Пов'язані статті: Імпорт і експорт, Угоди.
Helomi AI employees read this same article: help("int-keepincrm")