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

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

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

- Потрібно створити нову роль з кастомними правами доступу.
- Треба змінити права доступу існуючої ролі.
- Потрібно призначити роль користувачу або боту.

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

- **Роль** — набір прав доступу до різних модулів та функцій системи.
- **Права доступу** — дозволи на перегляд, збереження, видалення та інші дії в модулях.
- **Призначення ролей** — ролі можуть призначатися користувачам та ботам.
- **Лайт-агенти** — оператори з обмеженими дозволами, які можуть залишати внутрішні примітки замість повноцінних повідомлень в тікетах.

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

- [x] Ви увійшли в систему з правами адміністратора.
- [x] Ви маєте дозвіл на редагування ролей.

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

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

1. Перейдіть до модуля **Налаштування** через `Меню -> Налаштування`.
2. У бічному меню знайдіть розділ **"Користувачі"** та розгорніть його.
3. Натисніть на пункт **"Ролі"**.

### 2. Переглянути список ролей

1. Система відображає список існуючих ролей у системі.
2. Перегляньте поточні ролі та їх права доступу.

### 3. Створити нову роль

1. Натисніть кнопку **"Створити роль"** або аналогічну кнопку.
2. У формі, що з'явиться, введіть:
   - **"Назва ролі"** — назва ролі (наприклад, "Оператор", "Супервайзер", "Аналітик").
   - **"Аліас"** — унікальний ідентифікатор ролі латиницею (наприклад, operator, admin, supervisor). Обов'язкове поле.
   - **"Опис"** — опис ролі (опційно).
3. Налаштуйте права доступу для ролі:
   - Для кожного модуля встановіть потрібні дозволи (перегляд, збереження, видалення тощо).
   - Використовуйте чекбокси або перемикачі для встановлення дозволів.
   - **Client Portal:** для ролі кінцевих користувачів порталу (self-registration) увімкніть модуль **Client Portal** (чекбокс **Доступ**). Такі користувачі **не** зможуть увійти в Constructor / Operator Line — лише в Client Portal. Не вмикайте цей маркер для операторів і адміністраторів.
   - **Client Portal (співробітники):** для співробітників **вашої організації**, які відкривають посилання на тікети кінцевих користувачів у режимі лише для читання. Потрібні також права **Операторська панель** (маршрут) і **тікети** (сутність). Такі користувачі **можуть** входити в Constructor. Не змішуйте з маркером **Client Portal** для репортерів без потреби. → [Налаштувати staff-доступ](/uk/clientportal/how-to/configure-staff-access.md)
4. Натисніть **«Зберегти»** у формі. Якщо не заповнено обов’язкові поля (**назва**, **аліас**), під ними з’являться підказки про помилку — збереження не виконається.

### 4. Редагувати існуючу роль

1. Знайдіть роль, яку потрібно редагувати, у списку.
2. Натисніть кнопку **"Редагувати"** або аналогічну кнопку.
3. Змініть назву, аліас, опис або права доступу ролі.
4. Натисніть кнопку **"Зберегти"** у формі.

### 5. Налаштувати додаткові права (при створенні або редагуванні)

У формі ролі під таблицею модулів є додаткові секції:

**Додаткові налаштування Custom Data** — права до сутностей Custom Data по кожному боту. Виберіть бота зі списку, потім для кожної сутності (таблиці) встановіть дозволи: перегляд, редагування, видалення, додавання. Це дозволяє обмежити, які дані Custom Data може бачити та змінювати оператор з цією роллю.

**Додаткові налаштування Операторської панелі** — деталізовані права: роль (оператор/супервізор), історія чатів, показ закритих кімнат, FastLine (меню, моніторинг, takeover, transfer), масові дії, редагування тегів клієнта, видалення повідомлень, CSAT, об'єднання тікетів, оцінка якості, **Вхід як користувач** тощо. Увімкнення **«Вхід як користувач»** дозволяє користувачам з цією роллю увійти в систему під обраним оператором (див. [Увійти як користувач](/uk/settings/how-to/login-as-user.md)). Root-адміністратори мають цю можливість без додаткового налаштування ролі. У цьому блоці також є розділ **Колонки таблиці лінії оператора** для стартового набору колонок табличного вигляду (див. [підрозділ нижче](#налаштування-стандартних-колонок-таблиці-операторськоі-лініі)).

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

<a id="налаштування-стандартних-колонок-таблиці-операторської-лінії"></a>
<a id="налаштування-стандартних-колонок-таблиці-операторськоі-лініі"></a>

### Налаштування стандартних колонок таблиці Операторської лінії

У формі ролі, в блоці **Додаткові налаштування Операторської панелі**, знайдіть розділ **Колонки таблиці лінії оператора**.

1. Відкрийте **Налаштування** → **Користувачі** → **Ролі** та створіть нову роль або натисніть **Редагувати** для наявної.
2. Прокрутіть до секції **Додаткові налаштування Операторської панелі**.
3. У блоці **Колонки таблиці лінії оператора**:
   - **Налаштувати колонки (діалоги)** — стартовий набір для таблиці, коли у фільтрі звернень **немає** типу «тікет»;
   - **Налаштувати колонки (тикети / змішаний режим)** — стартовий набір, коли у фільтрі **є** «тікет», у тому числі для змішаного списку діалогів і тікетів.
4. У діалозі оберіть колонки та порядок і збережіть зміни — пресет зберігається **у ролі**, а не на пристроях операторів.
5. **Скинути пресет ролі** прибирає лише організаційний стандарт у ролі; **особисті** збереження операторів у браузерах не змінюються.

**Зв’язок з оператором:** якщо оператор уже натиснув **Зберегти** у **Налаштувати колонки** в таблиці, його макет на пристрої має пріоритет над пресетом ролі. Після оновлення пресету ролі такий оператор знову бачить новий стандарт лише після **Скинути до стандартних** у діалозі колонок для потрібного режиму. Детальніше — [Переглянути чати у таблиці](/uk/operatorline/how-to/view-chats-table.md).

### 6. Призначити роль користувачу

1. Перейдіть до **Налаштування** → **Користувачі** → **Користувачі**.
2. Знайдіть користувача, якому потрібно призначити роль.
3. Натисніть кнопку **"Редагувати"** або відкрийте профіль користувача.
4. У формі редагування знайдіть поле **"Роль"**.
5. Виберіть потрібну роль зі списку.
6. Збережіть зміни.

### 7. Призначити ботів до ролі (Напрямки)

**Примітка:** Тільки адміністратори (root-користувачі) можуть призначати ботів до ролей. Це обмежує, до яких ботів мають доступ користувачі з цією роллю.

1. Перейдіть до **Налаштування** → **Користувачі** → **Ролі**.
2. Знайдіть роль, яку потрібно налаштувати, та натисніть **Редагувати**.
3. У формі ролі знайдіть колонку або кнопку **"Напрямки (Процеси)"**.
4. Натисніть, щоб відкрити модальне вікно призначення ботів.
5. Виберіть ботів, до яких мають мати доступ користувачі з цією роллю.
6. Збережіть зміни.

### 8. Налаштувати права для лайт-агентів

1. Створіть або виберіть роль для лайт-агентів.
2. Налаштуйте обмежені дозволи для роботи з тікетами:
   - Лайт-агенти мають можливість залишати **внутрішні примітки** замість повноцінних повідомлень.
   - Інтерфейс для лайт-агентів відображає placeholder "Написати внутрішню примітку…" замість "Повідомлення".
   - Для email тікетів редактор повідомлень та поле "Від" приховано для лайт-агентів.
3. Збережіть зміни.
4. Призначте цю роль користувачам, які мають працювати як лайт-агенти.

**Особливості роботи лайт-агентів:**
- Лайт-агенти не можуть відправляти повідомлення клієнтам в тікетах.
- Внутрішні примітки відображаються тільки для операторів та не видно клієнтам.
- Це дозволяє краще контролювати роботу лайт-агентів та запобігати випадковим помилкам.

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

Ролі налаштовано та застосовано:
- Нові ролі доступні для призначення користувачам та ботам.
- Змінені права доступу застосовуються до користувачів з відповідною роллю.
- Користувачі та боти отримують права доступу згідно з призначеними ролями.

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

- Перевірте, що нова роль з'явилася в списку ролей.
- Перевірте, що права доступу ролі відображаються коректно.
- Призначте роль користувачу та перевірте, що права доступу застосовані.

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

- [Переглянути користувачів](/uk/settings/how-to/view-users.md)
- [Увійти як користувач](/uk/settings/how-to/login-as-user.md)
- [Переглянути чати у таблиці](/uk/operatorline/how-to/view-chats-table.md) — колонки та скидання особистого макета

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

- ⚠️ **Зміна прав доступу**: Зміна прав доступу ролі впливає на всіх користувачів з цією роллю — будьте обережні.
- 💡 **Тестування**: Рекомендується спочатку протестувати нову роль на тестовому користувачі перед застосуванням на production.
- 🔒 **Безпека**: Не надавайте занадто широкі права доступу — дотримуйтесь принципу мінімальних привілеїв.
- 🔒 **Client Portal:** роль з увімкненим **Client Portal** призначена для кінцевих користувачів helpdesk-порталу. Значення `portal_registration_role_id` у налаштуваннях інстансу має вказувати на таку роль. Див. [Налаштування інстансу](/uk/settings/how-to/configure-instance.md) та [Поля клієнтів](/uk/settings/how-to/configure-client-fields.md) (поля реєстрації).
- 👤 **Лайт-агенти**: Для лайт-агентів налаштовуються обмежені дозволи, які дозволяють залишати внутрішні примітки замість повноцінних повідомлень, що забезпечує кращий контроль роботи та запобігає випадковим помилкам.