HappHapp Docs

SalesDrive

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

MarkdownOpen in ClaudeOpen in ChatGPT

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

Перед началом

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

Как получить API-ключ

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

Таблица API-ключей SalesDrive — копировать нужно строку «Для интеграции с сайтом (системный)»

Подключение

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

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

Настройки

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

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

Решение проблем

ОшибкаПричинаЧто сделать
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 минуты и повторите. Если ошибка повторяется — напишите в поддержку, мы снизим темп запросов со своей стороны.
Заказы не доходят до SalesDriveСинхронизация настроена неправильноПроверьте три вещи по порядку: в Настройках выбраны воронка и начальный статус; поля клиента SalesDrive, задействованные в маппинге, активны, а не архивированы; IP-whitelist в SalesDrive > Настройки > API пуст или содержит egress-IP HAPP.

Не получается? Напишите в поддержку с текстом ошибки — подскажем точное исправление.

Отключение и переподключение

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

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

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

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

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

Дальше

Help me solve it

Happ answers right away and hands over to a manager when needed.

На этой странице