Як налаштувати доступ співробітників до Client Portal?
Інструкція для root-адміністратора: дозволити співробітникам вашої організації (оператори, супервайзери) відкривати посилання на тікети кінцевих користувачів у режимі лише для читання з внутрішнім контекстом.
Коли знадобиться
- Співробітники отримують від кінцевих користувачів посилання на тікет у Центрі підтримки і мають бачити переписку очима користувача порталу плюс внутрішні нотатки.
- Потрібно переглянути список тікетів у порталі (лише читання) з фільтрами за організацією чи клієнтом — без створення й редагування.
- Потрібно підготувати інстанс до оновлення Client Portal з інтерфейсом режиму співробітника.
Що важливо знати
- Потрібне окреме право Client Portal (співробітники) — не плутати з Client Portal для кінцевих репортерів.
- Для не-root користувача одночасно потрібні права: Client Portal (співробітники), Операторська панель (маршрут) і Тікети (сутність).
- root за замовчуванням відкриває Client Portal у режимі співробітника й не потребує цих прав у ролі.
- Користувачі з повним staff-набором можуть входити в Constructor; portal-only репортери — ні.
- Посилання на зовнішній трекер (наприклад, Jira) формується лише з довіреної адреси інстансу, а не з довільного тексту в полі тікета.
Перед початком
Ви увійшли як root. Client Portal розгорнуто; задано client_portal_url(див. хаб адміністратора).
Покрокова інструкція
1. Роль для співробітників
- Відкрийте Налаштування → Користувачі → Ролі.
- Створіть роль або відредагуйте існуючу (наприклад, для лінії підтримки).
- Увімкніть модуль Client Portal (співробітники).
- Увімкніть Операторська панель (маршрут) і права на тікети (перегляд сутності тікета).
- Не вмикайте маркер Client Portal (репортер) на цій же ролі, якщо це роль для співробітників організації.
- Збережіть роль і призначте її потрібним користувачам.
→ Деталі модулів: Як налаштувати ролі
2. Довірені URL для контексту
У Налаштування → Налаштування інстансу створіть або оновіть ключі (значення — https://… без зайвих параметрів):
| Ключ | Призначення | Приклад значення |
|---|---|---|
client_portal_staff_jira_url | Базова адреса трекера (без /browse/KEY) | https://tracker.example.com |
client_portal_staff_operator_line_url | Базова адреса Constructor для прямого посилання в чат | https://app.example.com |
client_portal_staff_recent_ticket_days | Скільки днів враховувати для «недавніх тікетів» (1–90) | 7 |
client_portal_staff_highlighted_client_field_keys | JSON-масив ключів полів клієнта для виділення | ["instance_url"] |
→ Загальний опис ключів інстансу: Налаштування інстансу
3. Перевірка
- Увійдіть під користувачем з новою роллю в Constructor — вхід має бути дозволений.
- Після оновлення Client Portal відкрийте пряме посилання на тікет — має з’явитися режим співробітника (лише читання, внутрішні нотатки, панель контексту).
- Користувач з роллю лише Client Portal (репортер) як і раніше не входить у Constructor.
- На екрані тікетів співробітник за замовчуванням бачить введення прямого посилання; кнопка Показати список тікетів відкриває список лише для читання (фільтри Організація / Клієнт за потреби). Повернення — Перегляд за прямим посиланням.