# SalesDrive

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

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

Для подключения SalesDrive нужны API-ключ и поддомен вашего магазина. После подключения агент находит заказы по номеру телефона, создаёт новые прямо из чата и — если включить эту опцию — предлагает товары из вашего каталога.

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

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

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

1. В админке SalesDrive перейдите в **Настройки** > **Общие настройки и интеграции**.
2. Перейдите в **Собственные сайты и маркетплейсы** и выберите **API**.
3. Нажмите **API-ключи**, в таблице выберите строку **«Для интеграции с сайтом (системный)»** и скопируйте этот ключ.

<img alt="Таблица API-ключей SalesDrive — копировать нужно строку «Для интеграции с сайтом (системный)»" src="__img0" />

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

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

| Поле     | Значение                                                            |
| -------- | ------------------------------------------------------------------- |
| API ключ | Общий API-ключ из SalesDrive > Настройки > API                      |
| Домен    | Только поддомен — для `happstore.salesdrive.me` введите `happstore` |

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

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

Нажмите на шестерёнку на карточке, чтобы настроить, что разрешено делать агенту.

* **Поиск** — агент ищет заказы по номеру телефона и возвращает данные контакта.
* **Создание** — агент создаёт новые заказы с именем, телефоном и комментарием клиента.
* **Каталог** — агент получает доступ к вашему каталогу товаров и может предлагать товары. Для этого нужен **публичный ключ YML-каталога**: в SalesDrive перейдите в **Настройки** > **Интеграции** > **Экспорт YML** и скопируйте публичный ключ.

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

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

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

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

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

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

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

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

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

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

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