KeyCRM
Підключіть KeyCRM, щоб асистент знаходив покупців за номером телефону і створював картки у воронці або замовлення
KeyCRM підключається одним API-ключем. Після підключення асистент шукає покупців за номером телефону просто під час розмови і створює нові замовлення одразу у вашій воронці продажів.
Перед стартом
- Акаунт KeyCRM на платному тарифі — API відкрито на всіх платних тарифах.
- API-ключ з налаштувань KeyCRM (як його отримати — нижче).
- Робочий простір HAPP з хоча б одним налаштованим асистентом, що спілкується з клієнтами.
- Воронка і початковий статус — визначте, куди мають потрапляти нові картки.
Як отримати API-ключ
- З головного дашборду KeyCRM відкрийте Налаштування у лівому сайдбарі.
- Перейдіть у Основні > API.
- Натисніть Згенерувати, якщо ключа ще немає, і скопіюйте токен.
Підключення
- У HAPP відкрийте Інтеграції і знайдіть KeyCRM у розділі Додати CRM.
- Натисніть Підключити — модалка попросить одне поле.
- Вставте API-ключ і натисніть Підключити.
KeyCRM переїде в Мої інтеграції як картка з інформацією про акаунт — назва робочого простору, дата й час підключення.
| Поле | Значення |
|---|---|
| API ключ | Токен з KeyCRM > Налаштування > Основні > API |
Налаштування
Іконка шестерні на картці відкриває налаштування того, що асистенту дозволено робити.
- Пошук — асистент шукає наявних покупців за номером телефону і повертає їхні дані.
- Створення — асистент створює нові записи. Оберіть режим створення (картка воронки або замовлення), воронку продажів, статус картки, у який переводиться запис, і джерело замовлення.
Що робити, якщо не підключається
| Помилка | Причина | Що зробити |
|---|---|---|
INVALID_API_KEY | Ключ введено з помилкою або скопійовано з пробілами | Перекопіюйте токен з KeyCRM > Налаштування > Основні > API. Переконайтесь, що ключ згенеровано перед копіюванням. |
TOKEN_REVOKED (401) | Адмін перегенерував або відкликав ключ | Створіть новий ключ у KeyCRM і перепідключіть інтеграцію в HAPP. |
RATE_LIMITED (429) | Перевищено ліміт запитів до API KeyCRM | Зачекайте 1–2 хвилини і спробуйте знову. Якщо повторюється — напишіть у підтримку, ми знизимо темп запитів зі свого боку. |
| Замовлення не доходять до KeyCRM | Синхронізація налаштована неправильно | Перевірте три речі по порядку: у Налаштуваннях вибрані воронка і початковий статус; поля покупця KeyCRM, задіяні в мапінгу, активні, а не архівовані; IP-whitelist у KeyCRM > Налаштування > API порожній або містить egress-IP HAPP. |
Не знайшли свою помилку? Напишіть у підтримку з текстом помилки — підкажемо точне виправлення.
Відключення і перепідключення
Щоб відключити: відкрийте Інтеграції > KeyCRM, натисніть Відключити поряд з підключеним робочим простором і підтвердьте дію.
Після відключення:
- Нові замовлення з чату перестають іти в KeyCRM.
- Наявні замовлення в KeyCRM залишаються без змін.
- Асистент продовжує працювати в чаті — зупиняється лише синхронізація з KeyCRM.
- API-ключ не відкликається в KeyCRM. Якщо потрібно — відкличте його там окремо.
Щоб перепідключити: відкрийте Інтеграції > KeyCRM, натисніть Підключити і вставте API-ключ знову.
Після перепідключення зберігаються: вибір воронки і статусу, мапінг полів, прив'язка асистента до робочого простору, аналітика замовлень по інтеграції.
Далі
- CRM — усі CRM-інтеграції
- Інструменти — звернення до CRM під час розмови
- Інтеграції — повний каталог
Допомогти з рішенням
Happ відповість одразу і за потреби передасть питання менеджеру.