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