# NetHunt

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

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

NetHunt — это CRM на базе Gmail, поэтому для аутентификации нужны email аккаунта и API-ключ. После подключения агент находит контакты по номеру телефона и создаёт новые в той папке NetHunt, которую вы выберете.

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

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

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

1. В дашборде NetHunt нажмите **Settings** внизу левого сайдбара.
2. В группе **INTEGRATIONS** выберите **Apps and other integrations**.
3. Прокрутите вниз, нажмите **GENERATE API KEY** и скопируйте токен.

<img alt="API-ключ внизу страницы Apps and other integrations в NetHunt" src="__img0" />

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

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

| Поле     | Значение                              |
| -------- | ------------------------------------- |
| Email    | Email вашего аккаунта NetHunt         |
| API ключ | Токен, созданный в настройках NetHunt |

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

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

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

* **Поиск** — выберите **папку для поиска контактов** и **поле поиска**, в котором хранится номер телефона. Агент ищет контакты по телефону в этой папке.
* **Создание** — выберите **папку для создания контактов**, затем настройте **маппинг полей**: для каждого параметра агента укажите поле NetHunt, в которое он записывается, его тип и обязательно ли оно.

Без маппинга полей контакты не создаются. Если у обязательного поля NetHunt нет сопоставленного параметра, контакт не создастся.

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

| Ошибка                                         | Причина                                                   | Что сделать                                                                                                                                                                                                      |
| ---------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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 минуты и повторите. Если ошибка повторяется — [напишите в поддержку](https://happ.tools/contacts), мы снизим темп запросов со своей стороны.                                                       |
| Контакты не создаются                          | Папка или маппинг настроены неправильно                   | Проверьте три вещи по порядку: в **Настройках** выбрана папка для создания; у каждого обязательного поля NetHunt есть сопоставленный параметр; сопоставленные поля всё ещё активны в NetHunt, а не архивированы. |

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

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

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

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

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

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

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

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

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