# KeyCRM

Подключите KeyCRM, чтобы агент находил покупателей по телефону и создавал карточки в воронке или заказы

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

KeyCRM подключается одним API-ключом. После подключения агент ищет покупателей по номеру телефона прямо во время разговора и создаёт новые заказы сразу в вашей воронке продаж.

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

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

## Как получить API-ключ [#get-your-api-key]

1. В KeyCRM откройте **Настройки** в левом меню.
2. Перейдите в **Основные** > **API**.
3. Нажмите **Сгенерировать**, если ключа ещё нет, и скопируйте токен.

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

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

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

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

| Поле     | Значение                                     |
| -------- | -------------------------------------------- |
| API-ключ | Токен из KeyCRM > Настройки > Основные > API |

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

Иконка шестерёнки на карточке открывает настройки того, что агенту разрешено делать.

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

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

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

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

## Отключение и переподключение [#disconnect-and-reconnect]

**Чтобы отключить:** откройте **Интеграции** > **KeyCRM**, нажмите **Отключить** рядом с подключённым воркспейсом и подтвердите.

После отключения:

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

**Чтобы переподключить:** откройте **Интеграции** > **KeyCRM**, нажмите **Подключить** и вставьте API-ключ снова.

После переподключения сохраняются: выбор воронки и статуса, маппинг полей, привязка агента к воркспейсу и аналитика заказов по интеграции.

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

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