# KeyCRM

Підключіть KeyCRM, щоб асистент знаходив покупців за номером телефону і створював картки у воронці або замовлення

> Full REST + WebSocket API reference: https://api.happ.tools/reference

KeyCRM підключається одним API-ключем. Після підключення асистент шукає покупців за номером телефону просто під час розмови і створює нові замовлення одразу у вашій воронці продажів.

## Перед стартом [#перед-стартом]

* **Акаунт KeyCRM** на платному тарифі — API відкрито на всіх платних тарифах.
* **API-ключ** з налаштувань KeyCRM (як його отримати — нижче).
* **Робочий простір HAPP** з хоча б одним налаштованим асистентом, що спілкується з клієнтами.
* **Воронка і початковий статус** — визначте, куди мають потрапляти нові картки.

## Як отримати API-ключ [#як-отримати-api-ключ]

1. З головного дашборду KeyCRM відкрийте **Налаштування** у лівому сайдбарі.
2. Перейдіть у **Основні** > **API**.
3. Натисніть **Згенерувати**, якщо ключа ще немає, і скопіюйте токен.

<img alt="Поле API-ключа в налаштуваннях KeyCRM, поряд — кнопка копіювання" src="__img0" />

## Підключення [#підключення]

1. У HAPP відкрийте **Інтеграції** і знайдіть KeyCRM у розділі **Додати CRM**.
2. Натисніть **Підключити** — модалка попросить одне поле.
3. Вставте **API-ключ** і натисніть **Підключити**.

KeyCRM переїде в **Мої інтеграції** як картка з **інформацією про акаунт** — назва робочого простору, дата й час підключення.

| Поле     | Значення                                      |
| -------- | --------------------------------------------- |
| API ключ | Токен з KeyCRM > Налаштування > Основні > API |

## Налаштування [#налаштування]

Іконка шестерні на картці відкриває налаштування того, що асистенту дозволено робити.

* **Пошук** — асистент шукає наявних покупців за номером телефону і повертає їхні дані.
* **Створення** — асистент створює нові записи. Оберіть **режим створення** (картка воронки або замовлення), **воронку продажів**, **статус картки**, у який переводиться запис, і **джерело замовлення**.

## Що робити, якщо не підключається [#що-робити-якщо-не-підключається]

| Помилка                          | Причина                                             | Що зробити                                                                                                                                                                                                                                    |
| -------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVALID_API_KEY`                | Ключ введено з помилкою або скопійовано з пробілами | Перекопіюйте токен з KeyCRM > Налаштування > Основні > API. Переконайтесь, що ключ згенеровано перед копіюванням.                                                                                                                             |
| `TOKEN_REVOKED` (401)            | Адмін перегенерував або відкликав ключ              | Створіть новий ключ у KeyCRM і перепідключіть інтеграцію в HAPP.                                                                                                                                                                              |
| `RATE_LIMITED` (429)             | Перевищено ліміт запитів до API KeyCRM              | Зачекайте 1–2 хвилини і спробуйте знову. Якщо повторюється — [напишіть у підтримку](https://happ.tools/contacts), ми знизимо темп запитів зі свого боку.                                                                                      |
| Замовлення не доходять до KeyCRM | Синхронізація налаштована неправильно               | Перевірте три речі по порядку: у **Налаштуваннях** вибрані воронка і початковий статус; поля покупця KeyCRM, задіяні в мапінгу, активні, а не архівовані; IP-whitelist у KeyCRM > Налаштування > API порожній **або** містить egress-IP HAPP. |

Не знайшли свою помилку? [Напишіть у підтримку](https://happ.tools/contacts) з текстом помилки — підкажемо точне виправлення.

## Відключення і перепідключення [#відключення-і-перепідключення]

**Щоб відключити:** відкрийте **Інтеграції** > **KeyCRM**, натисніть **Відключити** поряд з підключеним робочим простором і підтвердьте дію.

Після відключення:

* Нові замовлення з чату перестають іти в KeyCRM.
* Наявні замовлення в KeyCRM залишаються без змін.
* Асистент продовжує працювати в чаті — зупиняється лише синхронізація з KeyCRM.
* API-ключ **не** відкликається в KeyCRM. Якщо потрібно — відкличте його там окремо.

**Щоб перепідключити:** відкрийте **Інтеграції** > **KeyCRM**, натисніть **Підключити** і вставте API-ключ знову.

Після перепідключення зберігаються: вибір воронки і статусу, мапінг полів, прив'язка асистента до робочого простору, аналітика замовлень по інтеграції.

## Далі [#далі]

* [CRM](/docs/integrations/crm) — усі CRM-інтеграції
* [Інструменти](/docs/agents/tools) — звернення до CRM під час розмови
* [Інтеграції](/docs/integrations) — повний каталог