# Адміністратор — Хаб налаштувань системи

Сторінка для адміністратора системи, який керує всіма налаштуваннями платформи ConnectiveOne. Тут ви налаштуєте ботів, користувачів, ролі, інстанс, автентифікацію та інші системні параметри.

---

## Короткий зміст
- [Верхньорівневі цілі та сценарії](#верхньорівневі-цілі-та-сценаріі)
- [Де працювати в інтерфейсі](#де-працювати-в-інтерфеисі)
- [Швидкі посилання](#швидкі-посилання)

---

## Верхньорівневі цілі та сценарії

### Управління ботами
**Мета** — налаштувати ботів для обробки діалогів з клієнтами.
- **Переглянути список ботів** — як побачити всіх ботів у системі та їх статуси. → [./how-to/view-bots-list.md](/uk/settings/how-to/view-bots-list.md)
- **Створити нового бота** — як додати нового бота до системи. → [./how-to/create-bot.md](/uk/settings/how-to/create-bot.md)
- **Налаштувати бота** — як змінити параметри конкретного бота (канали, хуки, мови). → [./how-to/configure-bot.md](/uk/settings/how-to/configure-bot.md)
- **Активувати/деактивувати бота** — як вмикнути або вимкнути бота без видалення. → [./how-to/activate-deactivate-bot.md](/uk/settings/how-to/activate-deactivate-bot.md)

### Управління користувачами та ролями
**Мета** — налаштувати користувачів системи та їх права доступу.
- **Переглянути користувачів** — як побачити список всіх користувачів системи. → [./how-to/view-users.md](/uk/settings/how-to/view-users.md)
- **Налаштувати ролі** — як створити та редагувати ролі з різними правами доступу. → [./how-to/configure-roles.md](/uk/settings/how-to/configure-roles.md)
- **Призначити ролі користувачам** — як надати користувачам відповідні права доступу.

### Налаштування інстансу
**Мета** — налаштувати загальні параметри системи.
- **Налаштувати інстанс** — як змінити загальні параметри системи (назва, домен, тощо). → [./how-to/configure-instance.md](/uk/settings/how-to/configure-instance.md)
- **Увімкнути нативні файли в Facebook Messenger** — щоб PDF і документи з Operator Line приходили клієнту як вкладення Messenger. → [../operatorline/how-to/enable-facebook-native-file-attachments.md](/uk/operatorline/how-to/enable-facebook-native-file-attachments.md)
- **Керувати секретами для сценаріїв** — збережені API-ключі та токени для Send Request і custom actions (після увімкнення адміністратором інстансу). → [./how-to/manage-action-credentials.md](/uk/settings/how-to/manage-action-credentials.md)

### Налаштування полів
**Мета** — налаштувати кастомні поля для користувачів та клієнтів.
- **Налаштувати поля користувачів** — як додати додаткові поля до профілю користувача. → [./how-to/configure-user-fields.md](/uk/settings/how-to/configure-user-fields.md)
- **Налаштувати поля клієнтів** — як додати додаткові поля до картки клієнта. → [./how-to/configure-client-fields.md](/uk/settings/how-to/configure-client-fields.md)
- **Довідник JSON (`custom_fields_json`)** — повний перелік властивостей поля для інтеграторів. → [./reference/client-fields-json.md](/uk/settings/reference/client-fields-json.md)

### Налаштування системи
**Мета** — підготувати операторську панель до роботи та налаштувати всі необхідні параметри.
- **Налаштувати загальні налаштування** — як налаштувати ботів, користувачів, операторську панель, налаштування та швидкі відповіді. → [./how-to/configure-system-settings.md](/uk/settings/how-to/configure-system-settings.md)
- **Налаштувати шаблони email** — як задати HTML-хедер та футер для листів по кожній адресі відправника. → [./how-to/configure-email-templates.md](/uk/settings/how-to/configure-email-templates.md)

### Автентифікація та доступ
**Мета** — налаштувати автентифікацію користувачів та управління доступом.
- **Налаштувати автентифікацію** — як налаштувати SSO Google та Microsoft Active Directory для управління доступом. → [./how-to/configure-authentication.md](/uk/settings/how-to/configure-authentication.md)
- **Отримати токен MCP для інстансу** — як відкрити `/mcp/token`, скопіювати токен і конфігурацію Cursor для підключення AI-асистента до інстансу. → [./how-to/get-mcp-instance-token.md](/uk/settings/how-to/get-mcp-instance-token.md)

### Моніторинг та діагностика
**Мета** — контролювати стан системи та швидко діагностувати проблеми.
- **Переглянути стан системи** — як перевірити працездатність всіх компонентів платформи (месенджери, модулі). → [./how-to/view-system-status.md](/uk/settings/how-to/view-system-status.md)
- **Переглянути журнал змін налаштувань** — хто і коли змінив критичні параметри (теми, ролі, поля клієнта тощо); спочатку увімкніть функцію в налаштуваннях інстансу. → [./how-to/view-settings-audit-log.md](/uk/settings/how-to/view-settings-audit-log.md)

### Автоматичні перевірки
**Мета** — налаштувати автоматичний запуск обраних функцій за розкладом.
- **Створити перший розклад “Автоматична перевірка”** — навчальний сценарій для першого налаштування. → [./tutorials/first-automatic-check-schedule.md](/uk/settings/tutorials/first-automatic-check-schedule.md)
- **Задати параметри розкладу** — додаткові значення для Action Jail (форма або JSON). → [./how-to/configure-automatic-check-params.md](/uk/settings/how-to/configure-automatic-check-params.md)

### Інфраструктура
**Мета** — підготувати інфраструктуру для розгортання ConnectiveOne.
- **Перевірити вимоги до сервера** — як перевірити технічні вимоги до інфраструктури для розміщення ConnectiveOne. → [./reference/server-requirements.md](/uk/settings/reference/server-requirements.md)

---

## Де працювати в інтерфейсі

Основна робота з налаштуваннями відбувається в модулі **Налаштування** Constructor:

- **Адреса `/settings-page`** — головний екран розділу налаштувань після переходу з меню або з головного екрана.
- **Бічна панель**: розділи згруповані в **акордеоні** — натисніть на заголовок групи, щоб розгорнути список пунктів. Типові групи: **Боти**, **Користувачі**, **Операторська панель** (теми, групи навичок, статуси, теги, метрики, календарі тощо), окремий блок **Налаштування** для детальних параметрів операторської панелі (оператори, таймери, гарячі клавіші, файли, чати, тікети тощо), а також **Налаштування інстансу** та інші системні пункти — залежно від прав доступу. Назви пунктів можуть відображатися українською або англійською залежно від мови інтерфейсу.
- **Розділ «Боти»** — управління ботами та групами ботів.
- **Розділ «Користувачі»** — користувачі, ролі та пов’язані екрани (наприклад, додаткові поля користувача).
- **Розділ «Операторська панель»** — настроювальні списки (теми, skill groups, статуси, теги тощо).
- **Підрозділ «Налаштування»** (у межах операторської панелі) — детальні екрани параметрів роботи панелі операторів (файли, стилі, таймери, гарячі клавіші, поля картки клієнта тощо); зміни на таких сторінках зазвичай зберігаються **кнопкою збереження** в шапці відповідного екрана.
- Категорії **загальних налаштувань** (боти, користувачі, операторська панель, швидкі відповіді тощо) відкрийте через відповідні групи **бічної панелі** — див. також [налаштувати загальні налаштування](/uk/settings/how-to/configure-system-settings.md).
- **Автентифікація** (SSO, Active Directory): підключення та зміни зазвичай узгоджуються з **технічною підтримкою** та адміністратором.

---

## Швидкі посилання

### Боти
- [Переглянути список ботів](/uk/settings/how-to/view-bots-list.md)
- [Створити нового бота](/uk/settings/how-to/create-bot.md)
- [Налаштувати бота](/uk/settings/how-to/configure-bot.md)
- [Активувати/деактивувати бота](/uk/settings/how-to/activate-deactivate-bot.md)

### Користувачі та ролі
- [Переглянути користувачів](/uk/settings/how-to/view-users.md)
- [Налаштувати ролі](/uk/settings/how-to/configure-roles.md) (у т. ч. стандартні колонки таблиці Operator Line — підрозділ у кінці інструкції)

### Налаштування системи
- [Налаштувати інстанс](/uk/settings/how-to/configure-instance.md)
- [Увімкнути нативні файли в Facebook Messenger](/uk/operatorline/how-to/enable-facebook-native-file-attachments.md)
- [Керувати секретами для сценаріїв](/uk/settings/how-to/manage-action-credentials.md)
- [Налаштувати поля користувачів](/uk/settings/how-to/configure-user-fields.md)
- [Налаштувати поля клієнтів](/uk/settings/how-to/configure-client-fields.md)
- [Довідник JSON полів клієнта](/uk/settings/reference/client-fields-json.md)
- [Налаштувати загальні налаштування](/uk/settings/how-to/configure-system-settings.md)

### Автентифікація
- [Налаштувати автентифікацію](/uk/settings/how-to/configure-authentication.md)
- [Отримати токен MCP для інстансу](/uk/settings/how-to/get-mcp-instance-token.md)

### Моніторинг та діагностика
- [Переглянути стан системи](/uk/settings/how-to/view-system-status.md)
- [Переглянути журнал змін налаштувань](/uk/settings/how-to/view-settings-audit-log.md)
### Автоматичні перевірки
- [Створити перший розклад “Автоматична перевірка”](/uk/settings/tutorials/first-automatic-check-schedule.md)
- [Задати параметри розкладу «Автоматична перевірка»](/uk/settings/how-to/configure-automatic-check-params.md)

### Інфраструктура
- [Вимоги до сервера](/uk/settings/reference/server-requirements.md)

### Налаштування операторської панелі
- [Налаштувати теми](/uk/settings/how-to/configure-subjects.md)
- [Налаштувати групи навичок](/uk/settings/how-to/configure-skill-groups.md)
- [Налаштувати статуси операторів](/uk/settings/how-to/configure-statuses.md)
- [Налаштувати статуси діалогів](/uk/settings/how-to/configure-chat-statuses.md)
- [Налаштувати теги](/uk/settings/how-to/configure-tags.md)
- [Налаштувати пріоритети](/uk/settings/how-to/configure-priorities.md)
- [Налаштувати метрики](/uk/settings/how-to/configure-metrics.md)
- [Налаштувати календарі](/uk/settings/how-to/configure-calendars.md)
- [Налаштувати операторів](/uk/settings/how-to/configure-operators.md)
- [Налаштувати таймери](/uk/settings/how-to/configure-timers.md)
- [Налаштувати гарячі клавіші](/uk/settings/how-to/configure-hot-keys.md)
- [Налаштувати стилі та скрипти](/uk/settings/how-to/configure-styles-scripts.md)
- [Налаштувати файли](/uk/settings/how-to/configure-files.md)
- [Налаштувати поля картки клієнта](/uk/settings/how-to/configure-client-card-fields.md)
- [Налаштувати чати](/uk/settings/how-to/configure-chats.md)
- [Налаштувати тікети](/uk/settings/how-to/configure-tickets.md)
- [Налаштувати шаблони email](/uk/settings/how-to/configure-email-templates.md)
- [Налаштування нотифікацій (інстанс, обов’язкові канали та типи, бот)](/uk/notifications/how-to/configure-notifications-instance.md)

---

## Структура налаштувань

Модуль Налаштування організований у кілька основних розділів:

### 1. Bots (Боти)
Управління ботами, групами ботів та їх налаштуваннями.

### 2. Users (Користувачі)
Управління користувачами системи та їх ролями.

### 3. Операторська панель
Налаштування роботи операторської панелі:
- Теми
- Групи навичок (skill groups)
- Статуси операторів та діалогів
- Теги та пріоритети
- Метрики та календарі
- Категорії та швидкі відповіді

### 4. Детальні налаштування операторської панелі
Параметри роботи панелі операторів (окремі екрани в бічній панелі):
- Налаштування операторів (ім'я в чаті, Viber параметри)
- Налаштування нотифікацій (обов’язкові канали та типи, бот і сценарій для месенджерів) — див. [інструкцію](/uk/notifications/how-to/configure-notifications-instance.md)
- Таймери (час відповіді, обробки)
- Гарячі клавіші
- Стилі та скрипти (CSS, JavaScript)
- Налаштування файлів
- Поля картки клієнта
- Налаштування чатів та тікетів
- Шаблони email (HTML-хедер та футер для листів по кожній адресі)

### 5. Системні налаштування
Технічні налаштування та інфраструктура:
- Автентифікація (SSO, Active Directory)
- Загальні системні налаштування
- Вимоги до сервера та інфраструктури

---

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

- ⚠️ Деякі налаштування можуть впливати на роботу всієї системи — будьте обережні при зміні параметрів
- 💾 Завжди зберігайте зміни після редагування налаштувань
- 🔒 Перевіряйте права доступу перед зміною критичних налаштувань
- 📝 Деякі налаштування можуть вимагати перезавантаження системи або оновлення кешу
- 🔧 Налаштування автентифікації та інфраструктури виконуються технічною підтримкою