# NetHunt

Підключіть NetHunt, щоб асистент знаходив контакти за телефоном і створював нові у вибраній папці

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

NetHunt — це CRM на базі Gmail, тому автентифікація йде поштою акаунта плюс API-ключем. Після підключення асистент знаходить контакти за номером телефону і створює нові у тій папці NetHunt, яку ви оберете.

## Перед стартом [#перед-стартом]

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

## Як отримати API-ключ [#як-отримати-api-ключ]

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

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

## Підключення [#підключення]

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

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

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

## Відключення і перепідключення [#відключення-і-перепідключення]

**Щоб відключити:** відкрийте **Інтеграції** > **NetHunt**, натисніть **Відключити** поряд з підключеним робочим простором і підтвердьте дію.

Після відключення:

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

**Щоб перепідключити:** відкрийте **Інтеграції** > **NetHunt**, натисніть **Підключити** і введіть email та API-ключ знову.

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

## Далі [#далі]

* [CRM](/docs/integrations/crm) — усі CRM-інтеграції
* [Інструменти](/docs/agents/tools) — звернення до CRM під час розмови
* [Інтеграції](/docs/integrations) — повний каталог