# Odoo

Підключіть сервер Odoo, щоб асистент знаходив контакти за телефоном і створював замовлення

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

Odoo підключається реквізитами сервера й логіном користувача — HAPP автентифікується безпосередньо у вашій інстанції, тож працює і з Odoo Online, і з self-hosted. Після підключення асистент знаходить контакти за номером телефону і створює замовлення з чату.

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

* **Інстанція Odoo**, доступна з інтернету — Odoo Online (`mycompany.odoo.com`) або власний сервер.
* **URL сервера, назва бази даних і логін користувача** з правами читати контакти й створювати замовлення.
* **Пароль або API-ключ** цього користувача (як отримати ключ — нижче; це безпечніший варіант).
* **Робочий простір HAPP** з хоча б одним налаштованим асистентом, що спілкується з клієнтами.

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

Підключитися можна і звичайним паролем користувача, але API-ключ безпечніший — він прив'язаний до однієї інтеграції, і його можна відкликати, не змінюючи пароль акаунта.

1. У дашборді Odoo натисніть на **аватар** зверху справа і оберіть **My Preferences**.
2. Перейдіть на вкладку **Безпека**, натисніть **Add API Key** і введіть свій поточний пароль, щоб підтвердити вхід.
3. Введіть назву ключа (наприклад `Happ`) і **замініть тривалість з «1 Day» на «1 Year»** — інакше ключ протухне через добу. Натисніть **Створіть ключ** і скопіюйте його.

Odoo показує API-ключ лише один раз. Скопіюйте його до закриття вікна — якщо загубите, доведеться генерувати новий.

<img alt="Odoo показує згенерований ключ один раз — у вікні, яке не можна відкрити повторно" src="__img0" />

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

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

| Поле        | Значення                                                   |
| ----------- | ---------------------------------------------------------- |
| URL сервера | Адреса вашої інстанції, напр. `https://mycompany.odoo.com` |
| База даних  | Назва бази даних                                           |
| Логін       | Email користувача                                          |
| Пароль      | Пароль користувача в Odoo **або** створений вище API-ключ  |

Odoo переїде в **Мої інтеграції** як картка з **інформацією про акаунт** — назва інстанції, дата й час підключення.

## Налаштування [#налаштування]

Іконка шестерні на картці відкриває налаштування того, що асистенту дозволено робити.

* **Пошук** — асистент шукає контакти за номером телефону в базі Odoo.
* **Створення** — асистент створює замовлення, прив'язані до контакту, з назвою товару в примітках.

## Що робити, якщо не підключається [#що-робити-якщо-не-підключається]

| Проблема                           | Причина                                                               | Що зробити                                                                                                                                           |
| ---------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Автентифікація не проходить        | Невірний логін, пароль або база даних                                 | Odoo потребує збігу всіх чотирьох значень. Перевірте назву бази — на одній інстанції їх може бути кілька, і назва не завжди збігається з піддоменом. |
| Ключ перестав працювати через добу | Ключ створено з типовою тривалістю «1 Day»                            | Створіть новий ключ і поставте тривалість **1 Year**.                                                                                                |
| 401 на ключі, який раніше працював | Адмін відкликав ключ або змінився пароль користувача                  | Створіть новий API-ключ у **My Preferences** > **Безпека** і перепідключіть інтеграцію в HAPP.                                                       |
| Сервер недоступний                 | Self-hosted інстанція не виставлена назовні або заблокована фаєрволом | URL має бути доступний з інтернету через HTTPS. Якщо фільтруєте за IP — дозвольте egress-IP HAPP.                                                    |
| Замовлення не створюються          | Синхронізація вимкнена або бракує прав                                | Перевірте, що в **Налаштуваннях** увімкнено **Створення** і що користувач Odoo має права створювати замовлення.                                      |

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

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

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

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

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

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

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

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

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