KeepinCRM (перехід)
Картка KeepinCRM потрібна на час переходу зі старої CRM на Helomi. Через ключ API KeepinCRM працює дзеркало: кожні 5 хвилин угоди, клієнти, товари, платежі, задачі й доставки з KeepinCRM підтягуються в Helomi без дублів, а ШІ-агенти, які ще не переведені, читають і пишуть у KeepinCRM. Канали продажів перемикаються на Helomi по одному.
На цій сторінці
Можливості
- Перевірка ключа KeepinCRM.
- Дзеркало кожні 5 хвилин: лише нове й змінене, повтор не дублює.
- Ручний імпорт з дати — Налаштування›Система›Імпорт із KeepinCRM«Налаштування → Система → Імпорт із KeepinCRM».
- Показ «бекенду 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, а замовлення з маркетплейсів і сайтів приходять напряму (див. розділ 4). Міняти може лише адміністратор.
3Імпорт із KeepinCRM
Налаштування›Система›Імпорт із 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")`.
Додаткова інформація
- Пов'язані статті: Імпорт і експорт, Угоди.
Цю саму статтю читають ШІ-співробітники Helomi: help("int-keepincrm")