# Kommo

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

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

Kommo (amoCRM) подключается по долгосрочному токену приватной интеграции, которую вы создаёте в своём аккаунте. После подключения агент обращается к знакомым клиентам по имени, зная их последнюю сделку, создаёт контакт и сделку, когда клиент оставляет заявку, и записывает итог каждого звонка в карточку клиента.

## Что умеет агент [#what-the-assistant-can-do]

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

## Перед началом [#before-you-start]

* **Администратор Kommo** — только администратор может создать токен.
* **Воркспейс HAPP** хотя бы с одним агентом.
* **Kommo включён для вашего воркспейса** — интеграция включается для каждой компании отдельно. Попросите поддержку HAPP её включить.

## Создание токена [#create-the-token]

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

## Подключение [#connect]

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

## Настройки [#settings]

Нажмите на шестерёнку на карточке во вкладке **Интеграции** агента.

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

## Ограничения [#limits]

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

## Решение проблем [#troubleshooting]

| Проблема                                                       | Причина                                                    | Что делать                                                            |
| -------------------------------------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------------------- |
| «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»                                             | Пользователь токена потерял права или аккаунт заблокирован | Сгенерируйте токен от имени администратора.                           |

## Отключение [#disconnect]

Отключите карточку в HAPP и удалите приватную интеграцию в **Настройки > Интеграции**. Контакты, сделки и заметки, которые уже есть в Kommo, останутся.

## Дальше [#next]

* [CRM](/docs/integrations/crm) — все CRM-интеграции
* [Инструменты](/docs/agents/tools) — что агент вызывает во время разговора