KeyCRM
Подключите KeyCRM, чтобы агент находил покупателей по телефону и создавал карточки в воронке или заказы
KeyCRM подключается одним API-ключом. После подключения агент ищет покупателей по номеру телефона прямо во время разговора и создаёт новые заказы сразу в вашей воронке продаж.
Перед началом
- Аккаунт KeyCRM на платном тарифе — API открыт на всех платных тарифах.
- API-ключ из настроек KeyCRM (как его получить — ниже).
- Воркспейс HAPP хотя бы с одним агентом, настроенным для общения с клиентами.
- Воронка и начальный статус — решите, куда должны попадать новые карточки.
Как получить API-ключ
- В KeyCRM откройте Настройки в левом меню.
- Перейдите в Основные > API.
- Нажмите Сгенерировать, если ключа ещё нет, и скопируйте токен.
Подключение
- В HAPP откройте Интеграции и найдите KeyCRM в разделе Добавить CRM.
- Нажмите Подключить — в окне всего одно поле.
- Вставьте API-ключ и нажмите Подключить.
KeyCRM появится в разделе Мои интеграции — карточка с блоком Информация об аккаунте: название воркспейса, дата и время подключения.
| Поле | Значение |
|---|---|
| API-ключ | Токен из KeyCRM > Настройки > Основные > API |
Настройки
Иконка шестерёнки на карточке открывает настройки того, что агенту разрешено делать.
- Поиск — агент ищет существующих покупателей по номеру телефона и возвращает их данные.
- Создание — агент создаёт новые записи. Выберите режим создания (карточка воронки или заказ), воронку продаж, статус карточки, в который переводится запись, и источник заказа.
Решение проблем
| Ошибка | Причина | Что сделать |
|---|---|---|
INVALID_API_KEY | Ключ введён с ошибкой или скопирован с пробелами | Заново скопируйте токен из KeyCRM > Настройки > Основные > API. Убедитесь, что ключ сгенерирован до копирования. |
TOKEN_REVOKED (401) | Админ перевыпустил или отозвал ключ | Сгенерируйте новый ключ в KeyCRM и переподключите интеграцию в HAPP. |
RATE_LIMITED (429) | Превышен лимит запросов к API KeyCRM | Подождите 1–2 минуты и повторите. Если повторяется — напишите в поддержку, мы снизим темп запросов со своей стороны. |
| Заказы не доходят до KeyCRM | Синхронизация настроена неправильно | Проверьте три вещи по порядку: в Настройках выбраны воронка и начальный статус; поля покупателя KeyCRM, задействованные в маппинге, активны, а не архивированы; белый список IP в KeyCRM > Настройки > API пуст или содержит исходящие IP-адреса HAPP. |
Не получается? Напишите в поддержку с текстом ошибки — подскажем, как именно исправить.
Отключение и переподключение
Чтобы отключить: откройте Интеграции > KeyCRM, нажмите Отключить рядом с подключённым воркспейсом и подтвердите.
После отключения:
- Новые заказы из чата перестают отправляться в KeyCRM.
- Существующие заказы в KeyCRM остаются без изменений.
- Агент продолжает работать в чате — останавливается только синхронизация с KeyCRM.
- API-ключ не отзывается в KeyCRM. Если нужно — отзовите его там отдельно.
Чтобы переподключить: откройте Интеграции > KeyCRM, нажмите Подключить и вставьте API-ключ снова.
После переподключения сохраняются: выбор воронки и статуса, маппинг полей, привязка агента к воркспейсу и аналитика заказов по интеграции.
Дальше
- CRM — все CRM-интеграции
- Инструменты — обращение к CRM во время разговора
- Интеграции — полный каталог
Help me solve it
Happ answers right away and hands over to a manager when needed.