> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.novatalks.com.ua/ru/get-started/settings/macros.md).

# Макросы

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

**Макрос** - это набор сохраненных действий, которые запускаются в диалоге и помогают агентам ускорить обслуживание клиента. Это может быть, например, присвоение тега к разговору, назначение команды, обновление кастомного атрибута. С помощью макроса можно запустить все эти действия одним кликом.

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

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

Для создания нового макроса/редактирования существующего необходимо выбрать **Добавить новый макрос/Редактировать макрос.**

***

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

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

1. **Название макросу**
2. **Библиотека** - папка, в которую входит Макрос. Используется для организации Макросов.
3. **Видимость макроса -** доступность макроса для других пользователей. Может быть:

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

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

{% hint style="info" %}
В приватной библиотеке возможно создавать только Приватный макрос.
{% endhint %}

3. **Действие** -указывает действия, которые должны выполниться при запуске макроса. Возможные действия:

* Назначить команду&#x20;
* Назначить агента&#x20;
* Добавить теги&#x20;
* Удалить теги&#x20;
* Удалить назначенную команду&#x20;
* Завершить разговор&#x20;
* Отправить сообщение&#x20;
* Отправить вложение
* Добавить к:

личная заметка разговора - личная заметка разговора (с отправкой в разговор), в рамках которого был запущен макрос.&#x20;

окна Ответить разговору - окно Ответа разговора, в рамках которого был запущен макрос (без отправки в разговор).&#x20;

заметка диалога - заметка диалога (с сохранением в заметку), в рамках которой был запущен макрос

пользовательские атрибуты разговора (только текстовые)&#x20;

пользовательские атрибуты контакта (только текстовые)

* Добавить личную заметку&#x20;
* Отправить пользовательское событие (обычно используется для вызова пользовательского сценария NovaTalks. Например, в системе создается сценарий получения номера телефона чат ботом. С помощью макроса можно вызвать данный сценарий. В рамках запроса можно указать, какие значения параметров передавать через поля - Ключ/Значение)
* Отправить событие на вебхук (обычно используется для передачи данных в третьи системы. В рамках запроса можно указать, какие значения параметров передавать через поля - Ключ/Значение)&#x20;
* Отправить событие браузера (используется для поставки данных в Приложения. В рамках запроса можно указать, какие значения параметров передавать через поля - Ключ/Значение)

Можно добавить несколько действий последовательно. При запуске макроса действия будут выполняться в том порядке, в котором они заданы в настройках макроса. Изменить порядок действий можно, перетаскивая их за ручку рядом с каждым узлом.

***

### **Библиотека**  <a href="#libraries-list" id="libraries-list"></a>

#### Список библиотек

<figure><img src="/files/6lO3qeFEcmjuA19tQvdb" alt=""><figcaption></figcaption></figure>

**Библиотека** - это папки, которые используются для организации макросов и удобства их поиска. С помощью библиотек можно также скрывать не нужные макросы, которые в них входят или управлять правами доступа - частные или публичные.&#x20;

На странице Списка Библиотек отображаются их настройки и опция скрытия/отображения Макросов, которые входят в Библиотеку, при общении с клиентами

***

### Создание/Редактирование Библиотеки

<figure><img src="/files/2HZF1aAtsjPX3aNjJWdP" alt=""><figcaption></figcaption></figure>

1. **Название библиотеки**&#x20;
2. **Видимость** - доступность библиотеки для других пользователей. Может быть:

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

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