# Kommo

Підключіть Kommo (amoCRM), щоб асистент упізнавав клієнтів за телефоном, створював контакти й угоди та записував кожен дзвінок нотаткою

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

Kommo (amoCRM) підключається за довгостроковим токеном приватної інтеграції, яку ви створюєте у своєму акаунті. Після підключення асистент звертається до знайомих клієнтів на ім'я і знає їхню останню угоду, створює контакт і угоду, коли клієнт залишає заявку, і записує підсумок кожного дзвінка в картку клієнта.

## Що вміє асистент [#що-вміє-асистент]

* **Упізнає клієнта** — на початку дзвінка шукає номер у Kommo і отримує ім'я, email, компанію та останню угоду контакту (назва, етап, бюджет).
* **Створює угоду** — знаходить контакт за телефоном або створює новий і створює угоду у вибраній воронці та на вибраному етапі. Запит, адреса доставки, товари та реклама, з якої прийшов клієнт, додаються до угоди нотаткою.
* **Записує дзвінки** — після кожного дзвінка додає нотатку до відкритої угоди клієнта (або до контакту): напрямок, тривалість, результат, резюме, посилання на запис і, за бажанням, повну розшифровку.

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

* **Адміністратор Kommo** — лише адміністратор може створити токен.
* **Робочий простір HAPP** щонайменше з одним асистентом.
* **Kommo увімкнено для вашого простору** — інтеграція вмикається для кожної компанії окремо. Зверніться до підтримки HAPP.

## Створіть токен [#створіть-токен]

1. У Kommo відкрийте **Налаштування > Інтеграції** і натисніть **Створити інтеграцію**.
2. Виберіть приватну інтеграцію, назвіть її `HAPP` і збережіть. Redirect URL і вебхук відкликання можна не заповнювати.
3. На вкладці **Ключі та доступи** натисніть **Згенерувати довгостроковий токен**, виберіть термін дії (до 5 років) і скопіюйте токен — Kommo показує його лише один раз.

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

1. У HAPP відкрийте **Інтеграції** і знайдіть Kommo у розділі **Додати CRM**.
2. Натисніть **Підключити**, введіть адресу акаунта (`acme`, `acme.kommo.com` або адресу на `amocrm.ru`) і вставте токен.
3. Kommo з'явиться в **Моїх інтеграціях** з назвою вашого акаунта.

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

Відкрийте шестерню на картці у вкладці **Інтеграції** асистента.

* **Пошук** — упізнавати клієнта за телефоном.
* **Створення** — угоди. Виберіть **воронку**, **етап** і **відповідального**; без них угода потрапить в основну воронку на перший етап. **Нерозібране**, **Успішно реалізовано** і **Закрито й не реалізовано** як етап не пропонуються.
* **Нотатки про дзвінки** — нотатка після кожного дзвінка. **Повна розшифровка** додає текст розмови.

## Обмеження [#обмеження]

* Kommo зберігає телефон так, як його ввели; асистент порівнює останні 9 цифр, тож `050 111 22 33` і `+380501112233` — той самий клієнт.
* Для номера, якого немає в Kommo, нотатка про дзвінок не створюється — її нема до чого прив'язати.
* Токен перестає працювати в обрану дату закінчення — згенеруйте новий заздалегідь.

## Вирішення проблем [#вирішення-проблем]

| Проблема                                                       | Причина                                                | Що робити                                                                |
| -------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------ |
| «Enter the Kommo account address, e.g. acme or acme.kommo.com» | Адреса не належить акаунту Kommo чи amoCRM             | Скопіюйте адресу з браузера, коли ви в Kommo.                            |
| «Kommo account not found»                                      | Помилка в адресі                                       | Перевірте адресу акаунта.                                                |
| «Kommo: the token is invalid or expired»                       | Термін токена минув або інтеграцію видалили            | Згенеруйте новий довгостроковий токен і натисніть **Підключити** ще раз. |
| «Kommo: the account is not paid»                               | Підписка закінчилась — Kommo закриває API              | Продовжіть підписку.                                                     |
| «Kommo: no access»                                             | Користувач токена втратив права або акаунт заблоковано | Згенеруйте токен від імені адміністратора.                               |

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

Відключіть картку в HAPP і видаліть приватну інтеграцію в **Налаштування > Інтеграції**. Контакти, угоди й нотатки, що вже є в Kommo, залишаться.

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

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