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

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

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

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

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

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

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

  • Ви увійшли в систему як root-адміністратор.
  • У бічному меню 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 інстансу
  • Перемикачі окремих функцій платформи (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, щоб бачити процес роботи агента в чаті.

Приклад — Центр нотифікацій: категорія Notifications, перемикач Notification Center — детальні кроки та другий прапорець (розширені типи) описані в інструкції для root.

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

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

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

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

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

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

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