# Макроси

## Макроси <a href="#macros" id="macros"></a>

### Список макросів <a href="#macros-list" id="macros-list"></a>

**Макрос** - це набір збережених дій, які запускаються в діалозі та допомагають агентам пришвидшити обслуговування клієнта. Це може бути, наприклад, присвоєння тегу до розмови, призначення команди, оновлення кастомного атрибуту. За допомогою макросу можна запустити всі ці дії одним кліком.

Коли агенти запускають макрос, дії виконуються послідовно в порядку, в якому вони були визначені в макросі.

<figure><img src="/files/VQj4XFRaGQt7IuaIdH8C" alt=""><figcaption></figcaption></figure>

Для створення нового макросу/редагування існуючого необхідно обрати **Створити новий макрос/Редагувати макрос.**

***

### Створення/Редагування Макросу <a href="#create-edit-a-macro" id="create-edit-a-macro"></a>

<figure><img src="/files/xsFhBNDDggkLMQiI8REE" alt=""><figcaption></figcaption></figure>

1. **Назва макросу**
2. **Бібліотека -** папка, в яку входить Макрос. Використовується для організації Макросів.
3. **Видимість макросу** **-** доступність макросу для інших користувачів. Може бути:

* Приватний – доступ до макросу має тільки користувач, який його створив;
* Публічний – доступний для всіх користувачів облікового запису.&#x20;

{% hint style="info" %}
Публічні макроси можуть створювати лише користувачі з ролллю Адміністратор.
{% endhint %}

{% hint style="info" %}
В приватній бібліотеці можливо створювати лише Приватний макрос.
{% endhint %}

3. **Дія** - вказує дії, які мають виконатись при запуску макросу. Можливі дії:

* Призначити команду
* Призначити агента
* Додати теги
* Видалити теги
* Видалити призначену команду
* Завершити розмову
* Надіслати повідомлення
* Надіслати вкладення
* Додати до:&#x20;

приватна нотатка розмови - приватна нотатка розмови (з відправкою в розмову), в рамках якої було запущено макрос

вікна Відповісти розмови - вікно Відповіді розмови, в рамках якої було запущено макрос (без відправки в розмову)

нотатка діалогу - нотатка діалогу (із збереженням в нотатку), в рамках якої було запущено макрос

кастомні атрибути розмови (лише текстові)

кастомні атрибути контакту (лише текстові)

* Додати приватну замітку
* Надіслати користувацьку подію (зазвичай використовується для виклику користувацького сценарію NovaTalks. Наприклад, в системі створюється сценарій отримання номеру телефону чат ботом. За допомогою макросу можна викликати даний сценарій. В рамках запиту можна вказати, які значення параметрів передавати через поля - Ключ/Значення)
* Надіслати подію на вебхук (зазвичай використовується для передачі даних в треті системи. В рамках запиту можна вказати, які значення параметрів передавати через поля - Ключ/Значення)
* Надіслати подію браузера (використовується для поставки даних в Додатки.  В рамках запиту можна вказати, які значення параметрів передавати через поля - Ключ/Значення)

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

***

## Бібліотеки <a href="#libraries" id="libraries"></a>

### Список бібліотек <a href="#libraries-list" id="libraries-list"></a>

<figure><img src="/files/51xt1aDybrJwQp2tfBPq" alt=""><figcaption></figcaption></figure>

**Бібліотека** – це папки, які використовуються для організації макросів та зручності їх пошуку. За допомогою бібліотек можна також приховувати не потрібні макроси, які в них входять чи керувати правами доступу - приватні або публічні.

На сторінці Списку Бібліотек відображаються їх налаштування та опція приховання/відображення Макросів, які входять в Бібліотеку, під час спілкування з клієнтами.

***

### Створення/Редагування Бібліотеки <a href="#create-edit-a-library" id="create-edit-a-library"></a>

<figure><img src="/files/kbesVZ9FReSmfxpUyDZr" alt=""><figcaption></figcaption></figure>

1. **Назва бібліотеки**
2. **Видимість -** доступність бібліотеки для інших користувачів. Може бути:

* Приватна – доступ до бібліотеки має тільки користувач, який його створив;
* Публічна – доступна для всіх користувачів облікового запису.

{% hint style="info" %}
Публічні Бібліотеки можуть створювати лише користувачі з роллю Адміністратор.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.novatalks.com.ua/ua/get-started/settings/macros.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.