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

У параметрах секції-макросу можна задати коротку назву (аліас), позначити макрос доступним з чату і обмежити його скіл-групами — тоді макрос у списку макросів бачать лише оператори цих груп.

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

Макросів багато, і операторам різних ліній потрібні різні.
Макрос змінює статус або тематику звернення, і запускати його мають лише певні команди.
Потрібна коротка стабільна назва макросу, за якою його легко знайти.

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

Функцію вмикає root-адміністратор: Меню → Налаштування → Налаштування інстансу, категорія Scenario Builder, перемикач «Доступ до макросів: аліас, чат і скіл-групи». Поки його вимкнено, нових полів у модалці немає, а списки макросів працюють як раніше.
Аліас унікальний на весь інстанс: два макроси не можуть мати однаковий аліас, навіть у різних процесах.
Скіл-групи обмежують, хто бачить макрос у списку: діалог «Запустити макрос», масовий запуск, старий інтерфейс операторської панелі і макроси в CustomData. Макрос без скіл-груп бачать усі, як і раніше.
Root-адміністратор бачить усі макроси. Адміністратор, який не входить у жодну скіл-групу, бачить лише макроси без обмежень.
Якщо скіл-групу видалили або вимкнули, макрос не зникає — для нього вона просто перестає діяти. Вимкнену групу макрос «пам'ятає»: коли її знову ввімкнуть, обмеження за нею знову діятиме.
«Доступний з чату» поки лише зберігається: виклик макросу з поля вводу чату з'явиться в наступних версіях.

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

Root-адміністратор увімкнув функцію в налаштуваннях інстансу.
У вас є право редагувати сценарії (Scenario Builder).
Потрібні скіл-групи вже створено в налаштуваннях операторської панелі.

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

1. Відкрити параметри секції-макросу

Відкрийте процес у Scenario Builder.
У списку секцій натисніть шестерню біля секції, яка використовується як макрос.
Переконайтеся, що позначено «Використовується як макрос» — нові поля з'являються під цим перемикачем.

2. Задати аліас

У полі «Коротка назва макросу (аліас)» введіть назву, наприклад verify_doc.
Дозволені латинські літери в нижньому регістрі, цифри, _ і -, від 2 до 32 символів. Великі літери і пробіли на краях виправляються автоматично, коли ви виходите з поля.
Якщо під полем з'явилось «Аліас уже використовується» — такий аліас має інший макрос, оберіть інший. «Неприпустимий аліас» — у назві є недозволені символи. Поки є помилка, кнопка «Підтвердити» неактивна.

Аліас можна не задавати — поле необов'язкове.

3. Позначити «Доступний з чату»

Увімкніть перемикач «Доступний з чату». Він активний лише тоді, коли задано аліас; якщо очистити аліас, перемикач вимкнеться.

4. Обмежити скіл-групами

У полі «Скіл-групи з доступом» оберіть одну або кілька груп (є пошук).
Порожнє поле означає «Доступний усім операторам».

5. Зберегти

Натисніть «Підтвердити», потім «Опублікувати».
Аліас з'явиться бейджем /verify_doc біля секції в списку і на стартовому вузлі макросу.

Якщо під час публікації хтось уже зайняв цей аліас, з'явиться повідомлення «Аліас уже використовується» — змініть аліас і опублікуйте ще раз.

Як змінити статус і тематику звернення з макросу

Окремої дії для цього не потрібно. Додайте в макрос ноду «Оновлення запиту» (action_request_update) і вкажіть у ній статус та тематику — дія застосується до кімнати, з якої запустили макрос. Статус змінюється для будь-якої кімнати, тематика — лише для звернень-тікетів: у звичайному чаті нода тематику не змінює. Параметри дії — у довіднику Параметри ноди «Оновлення запиту».

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

Оператори, які не входять у обрані скіл-групи, більше не бачать макрос у списку макросів.
Копія секції отримує ті самі скіл-групи, але без аліасу і без «Доступний з чату» — аліас задайте заново.
Імпорт процесу або секції і секції з маркетплейсу приходять без аліасу і без скіл-груп: номери скіл-груп у різних інстансах різні, тож групи потрібно обрати заново.
Відновлення версії повертає аліас, лише якщо він вільний; скіл-групи лишаються поточними.