---
title: "Як налаштувати доступ до макросу"
description: "Аліас макросу, позначка «Доступний з чату» і обмеження макросу скіл-групами в Scenario Builder."
---

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

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

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

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

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

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

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

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

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

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

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

<!-- Скріншот: модалка «Параметри секції» з блоком аліасу, «Доступний з чату» і скіл-групами -->

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

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

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

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

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

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

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

### 5. Зберегти

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

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

<!-- GIF: задати аліас і скіл-групу, опублікувати, бейдж на стартовому вузлі -->

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

Окремої дії для цього не потрібно. Додайте в макрос ноду **«Оновлення запиту»** (`action_request_update`) і вкажіть у ній статус та тематику — дія застосується до кімнати, з якої запустили макрос. Статус змінюється для будь-якої кімнати, тематика — лише для звернень-тікетів: у звичайному чаті нода тематику не змінює. Параметри дії — у довіднику [Параметри ноди «Оновлення запиту»](/uk/scenariobuilder/reference/request-update-parameters.md).

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

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

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

- [Налаштувати параметри інстансу](/uk/settings/how-to/configure-instance.md)
- [Параметри ноди «Оновлення запиту»](/uk/scenariobuilder/reference/request-update-parameters.md)