# Як налаштувати параметри інстансу?

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

## Коли знадобиться

- Потрібно змінити системні параметри (наприклад, часовий пояс, назву проекту, обмеження файлів).
- Потрібно увімкнути або вимкнути окремі функції в налаштуваннях інстансу (AI-помічник, Process Library, інтеграції).
- Потрібно налаштувати постачальника email (Mailgun, Gmail, Outlook).

## Що важливо знати

- **Інстанс** — окремий екземпляр системи ConnectiveOne для конкретного клієнта.
- **Налаштування інстансу** — пари ключ–значення, що впливають на всю систему.
- **Доступ** — тільки root-адміністратори бачать і можуть змінювати налаштування інстансу.
- **Доступність функцій** — окремі можливості платформи можна увімкнути або вимкнути; параметри задає root-адміністратор у налаштуваннях інстансу.

## Перед початком

- [x] Ви увійшли в систему як root-адміністратор.
- [x] У бічному меню Settings ви бачите пункт «Налаштування інстансу».

## Покрокова інструкція

### 1. Відкрити налаштування інстансу

1. Перейдіть до модуля **Налаштування** через меню або за адресою `/settings-page`.
2. У бічному меню знайдіть пункт **«Налаштування інстансу»**.
3. Натисніть на нього.

### 2. Переглянути поточні налаштування

1. У лівій частині сторінки відображається список усіх налаштувань (ключ і значення).
2. Прокрутіть список, щоб переглянути потрібні параметри.

**Популярні налаштування:**
- `instance_timezone` — часовий пояс (наприклад, `Europe/Kiev`, `America/New_York`)
- `clarity_enabled` — увімкнення Microsoft Clarity (1/0)
- `lifecycle` — кількість днів до автоматичного видалення файлів у сховищі
- `client_portal_url` — базова URL клієнтського порталу (окремий веб-додаток для тікетів/helpdesk); додає цей домен до дозволених для CORS, щоб портал міг звертатися до API інстансу
- `portal_registration_enabled` — увімкнути (`true`) або вимкнути (`false`) self-registration у Client Portal (сторінка `/register`)
- `portal_registration_role_id` — id ролі для нових користувачів порталу; роль має мати право **Client Portal** (див. [Ролі](/uk/settings/how-to/configure-roles.md)). Типово це системна роль `client_portal`
- **Client Portal (staff)** — довірені URL і вікно для контексту співробітників вашої організації: `client_portal_staff_jira_url`, `client_portal_staff_operator_line_url`, `client_portal_staff_recent_ticket_days`, `client_portal_staff_highlighted_client_field_keys` (див. [Доступ співробітників](/uk/clientportal/how-to/configure-staff-access.md))
- Перемикачі окремих функцій платформи (Process Library, Instance Agent тощо) — керуються в блоці налаштувань інстансу

Повний опис усіх ключів — у технічній документації для розробників.

Щоб змінити значення у формі інстансу в інтерфейсі:

1. Змініть потрібні параметри:
   - **"Назва інстансу"** — назва вашого інстансу ConnectiveOne.
   - **"Домен"** — домен системи (якщо доступно).
   - **"Контактна інформація"** — email, телефон тощо.
   - **"Часовий пояс"** — часовий пояс для системи.
   - **"Експорт чатруму в PDF"** — максимальний час очікування (у секундах) при генерації PDF для діалогів. Використовується, коли оператори експортують історію чату в PDF.
   - **Перемикачі функцій** — для нових можливостей платформи. Наприклад, **"Operator Panel → Chatroom Export to PDF"** увімкнуто, щоб оператори могли експортувати діалоги в PDF; вимкнено — пункт меню не відображається.
   - Інші параметри (залежно від реалізації).
2. Перевірте введені дані.

### 3. Створити або оновити налаштування

1. У правій частині знайдіть картку **«Створення/оновлення ключа»**.
2. У полі **«Ключ»** введіть назву параметра (наприклад, `project_name`, `instance_timezone`).
3. У полі **«Значення»** введіть потрібне значення.
4. За потреби ввімкніть **«Exclude»**, щоб приховати налаштування від не-root користувачів.
5. Натисніть **«Створити/Оновити»**.

### 4. Видалити налаштування

1. Знайдіть картку **«Видалення ключа»**.
2. Введіть ключ налаштування, яке потрібно видалити.
3. Натисніть **«Видалити»**.

### 5. Налаштувати постачальника email

1. Прокрутіть до секції **«Постачальник email»**.
2. Оберіть провайдера: Not configured, Mailgun, Gmail або Outlook.
3. Натисніть **«Зберегти»**.
4. Якщо обрано Mailgun — з’явиться додаткова секція з полями API Key, Signing Key, Region та Forwarding Domain. Заповніть їх і збережіть.

### 6. Увімкнути або вимкнути окремі функції

1. Прокрутіть до блоку з перемикачами функцій платформи (категорії залежать від конфігурації).
2. Розгорніть потрібну категорію (наприклад, **Instance Agent**, **Process Library**, **Operator Panel**).
3. Перемикайте прапорці (switch) або обирайте значення (select) для потрібних функцій.
4. Зміни зберігаються автоматично після перемикання.

**Приклад — увімкнення AI-помічника:**
- Розгорніть категорію **Instance Agent**.
- Увімкніть **Instance Agent Integration**.
- За потреби увімкніть **Agent Debug Mode**, щоб бачити процес роботи агента в чаті.
- Щоб заборонити зміни даних через помічника для всіх користувачів — увімкніть **Agent Read-Only Mode** (лише перегляд і пояснення в UI).

Детальніше про права ролей — [Як налаштувати доступ до AI Помічника](/uk/constructor/how-to/configure-ai-assistant-access.md).

**Приклад — Центр нотифікацій:** категорія **Notifications**, перемикач **Notification Center** — покрокова інструкція в [інструкції для root](/uk/notifications/how-to/enable-notification-center.md).

**Приклад — база знань інстансу (Constructor):** категорія **Instance Docs**, перемикач **Instance Docs** — детальніше про роботу з документами: [інструкція в розділі Constructor](/uk/constructor/how-to/use-instance-knowledge-base.md).

**Приклад — нативні файли в Facebook Messenger:** категорія **Integrations**, перемикач **Facebook native file attachments** — PDF і документи з Operator Line приходять клієнту як вкладення Messenger (за замовчуванням вимкнено). Покроково: [Як увімкнути нативні файли в Facebook Messenger](/uk/operatorline/how-to/enable-facebook-native-file-attachments.md).

## Що відбувається після

- Налаштування застосовуються до всієї системи.
- Ці налаштування впливають на те, які функції з’являються в меню та інтерфейсі.
- Деякі зміни можуть вимагати перезавантаження сторінки.

## Як переконатися, що все вдалось

- Перевірте, що нове або змінене налаштування з’явилось у списку зліва.
- Для перемикачів функцій — перевірте, що відповідна можливість з’явилась або зникла в інтерфейсі.

## Пов'язані матеріали

- [Налаштувати ролі](/uk/settings/how-to/configure-roles.md)
- [Як увімкнути Центр нотифікацій на інстансі (root)](/uk/notifications/how-to/enable-notification-center.md)
- [Як увімкнути нативні файли в Facebook Messenger](/uk/operatorline/how-to/enable-facebook-native-file-attachments.md)
- [Поля клієнтів](/uk/settings/how-to/configure-client-fields.md) — поля форми реєстрації Client Portal

## Важливі примітки

- ⚠️ **Критичні зміни:** Деякі налаштування впливають на доступ до системи — будьте обережні. Не змінюйте `project_name` без узгодження з технічною командою — це впливає на ідентичність інстансу.
- 🔄 **Перезавантаження:** Окремі зміни можуть вимагати перезавантаження сторінки або системи.
- 💡 **Exclude:** Якщо ввімкнено Exclude, налаштування не видно не-root користувачам.