# Списки и теги

Во вкладке **Списки** Раздел, в котором вы можете создавать, редактировать и использовать пользовательские списки клиентов для автоматизации.\
Добавление клиентов в список может выполняться автоматически на основе шагов сценария бота — по заданным условиям или действиям пользователя.

Списки можно использовать для:

* Фильтрации и сегментации клиентов внутри проекта
* Экспорта данных

Вы можете экспортировать список в файл и импортировать его в другой проект MaviBot.

<div data-with-frame="true"><figure><img src="/files/491515f3c21c8dcfb867d8ea47c6685c5212b9fd" alt=""><figcaption></figcaption></figure></div>

#### **Преимущества использования списков:**

* **Автоматизация:** Клиенты автоматически добавляются в списки или удаляются из них на основе логики бота.
* **Портативность:** Списки можно экспортировать и импортировать между разными проектами.
* **Таргетированная коммуникация:** Отправляйте рассылки или отдельные сообщения в воронке напрямую отфильтрованным спискам клиентов.

Использование списков упрощает сегментацию аудитории и делает взаимодействие с клиентами более точным и эффективным.

## Как создать список

Списки создаются во **"Списки"** вкладке в том же разделе.

<div data-with-frame="true"><figure><img src="/files/3aff7c0a528fd44778aa43c59ac47e683390a0b2" alt=""><figcaption></figcaption></figure></div>

Нажмите кнопку **«Создать список»** кнопку, чтобы открыть окно с полями ввода, где вы можете указать название списка и выбрать папку (если они есть), в которую нужно добавить список.

<div data-with-frame="true"><figure><img src="/files/aba991b16d6ff65d10f08b2fd041a91f9bb94b8a" alt=""><figcaption></figcaption></figure></div>

Во вкладке **"Списки"** разделе вы можете сортировать списки по ID списка или по алфавиту (по названию):

<div data-with-frame="true"><figure><img src="/files/37a2564d51f385cf30a62583d77d9df7a6b67bc1" alt="" width="212"><figcaption></figcaption></figure></div>

Сила списков клиентов заключается в их гибкости. Например, вы можете добавить одного клиента в **несколько списков одновременно**.

Списки могут быть:

* Объединены в папки
* Переименованы
* Удалены (сами клиенты при этом остаются в базе данных)
* Использованы для **удаления всех клиентов из списка** из проекта

<div data-with-frame="true"><figure><img src="/files/413e34f95ff1e29be97881e562ae66203b9b3a61" alt="" width="563"><figcaption></figcaption></figure></div>

Вы можете включать или исключать клиентов, применяя типы фильтров — вручную через форму или загрузив файл.

Чтобы посмотреть клиентов в списке:

1. Нажмите на список, чтобы открыть меню справа.
2. Нажмите кнопку **«Просмотреть список клиентов»** .

<div data-with-frame="true"><figure><img src="/files/cfc5f728ec5902ef04d21a546c643baa2454f901" alt="" width="563"><figcaption></figcaption></figure></div>

Затем откроется новое окно из **«Клиенты»** раздела, где вы сможете увидеть всех пользователей в этом списке.

## Как автоматизировать работу со списками

Вы можете автоматически добавлять, удалять или перемещать клиентов между списками во время работы чат-бота.

Найдите набор **действий со списками** в любом блоке конструктора:

<div data-with-frame="true"><figure><img src="/files/bf9c19d6785dbc69cbca3eb98376784704a3facf" alt=""><figcaption></figcaption></figure></div>

Когда раздел **«Действие»** включен, вы можете выбрать, какие действия выполнять со списками.

<div data-with-frame="true"><figure><img src="/files/5feb28b2db1ac550871fcd6c6731a98848147f3d" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/a9cc918c9eff5fe1e6034852cb8f52c1250c45e6" alt="" width="375"><figcaption></figcaption></figure></div>

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

### Проверка, находится ли человек в списке

Чтобы <mark style="color:зелёный;">**проверить, есть ли клиент в списке**</mark>, вы можете использовать поле <mark style="color:зелёный;">**`inlist (list_number)`**</mark> в **в поле "Переменная"** для сравнения в блоках и соединении.

Результат выполнения функции — булево значение (True или False).

`inlist(list number) == True  -` клиент ЕСТЬ в списке или

`inlist(list number) == False -` клиента НЕТ в списке.

<figure><img src="/files/09477a8ba28cff68ee4346f9fb84535103d7775c" alt=""><figcaption></figcaption></figure>

Номер списка можно узнать, нажав на нужный список. В этом случае справа откроется меню с информацией о списке:

<div data-with-frame="true"><figure><img src="/files/d48619c395109a0dda7a6697d8eb44fae7b29401" alt=""><figcaption></figcaption></figure></div>

### Другие функции, связанные со списками

{% hint style="info" %}
[Здесь вы можете найти подробные инструкции по работе с функциями списков и тегов.](/doc/ru/chatbot/functions/kalkulyator/lists.md)
{% endhint %}

## **Как работать со списками вручную**

У каждого списка есть кнопки для:

* Добавления/удаления клиентов из списка
* Запуска рассылки по списку
* Скачивания списка в виде файла

Контекстное меню содержит пункты для:

* Добавления списка в папку
* Редактирования списка
* Удаления списка (клиенты остаются в проекте)
* Удаления всех клиентов из списка из проекта

{% hint style="danger" %}

#### **Предупреждение**

**«Удалить участников списка из проекта»** навсегда удаляет этих клиентов из проекта. Это действие нельзя отменить.
{% endhint %}

### Добавить клиентов в список

<div data-with-frame="true"><figure><img src="/files/aee6439dfe7da2e213edb06c3195b9c1192f7420" alt="" width="375"><figcaption></figcaption></figure></div>

Вы можете вручную добавить **существующих клиентов** в список, отфильтровав их через форму, загрузив файл или выбрав из другого списка.

{% hint style="warning" %}

#### Важно

При добавлении существующих клиентов в список **из файла**, в первом столбце должны быть указаны **внутренние ID клиентов** ( `client_id` переменной).
{% endhint %}

#### Как добавить клиентов из файла:

1. Выберите **«Клиенты из файла»** тип фильтра:

<div data-with-frame="true"><figure><img src="/files/a10a4057982d437e946393b6872a75de53093928" alt="" width="375"><figcaption></figcaption></figure></div>

2. Далее загрузите список клиентов в формате .CSV

<div data-with-frame="true"><figure><img src="/files/81f9db63cc2646c891e3d7d25efe1442ac7bf3ff" alt="" width="375"><figcaption></figcaption></figure></div>

Чтобы <mark style="color:зелёный;">**добавить НОВЫХ клиентов**</mark> в определённый список, перейдите в раздел **«Каналы»** Затем нажмите кнопку **«Загрузить список клиентов»** и выберите список, в который вы хотите загрузить клиентов.

### Как удалить клиентов из списка

Вы можете удалить клиентов из списка таким же образом: нажмите кнопку **«— Удалить из списка**» и при необходимости примените фильтры.

<div data-with-frame="true"><figure><img src="/files/014b6befc9703948cae1d6c9e37f26ed6597d1b3" alt="" width="375"><figcaption></figcaption></figure></div>

Примените необходимые фильтры, чтобы удалить определённую группу клиентов **ИЗ ЭТОГО СПИСКА** (не из базы клиентов).

{% hint style="danger" %}
**Пожалуйста, будьте внимательны при заполнении формы.**

Если вы оставите поля фильтра в форме **«Удалить из списка»** пустыми **,**, **все клиенты** в этом списке будут удалены.

Чтобы удалить только часть списка, заполните соответствующие фильтры:

* **По подключённым мессенджерам** — выберите определённого бота
* **Клиенты в блоке** — укажите номер(а) блока в воронке (можно добавить несколько блоков)
* **По переменным клиента** — введите точное значение переменной
* **Зарегистрирован до/после** — задайте соответствующий диапазон дат
* **Исключить списки** — если указаны номера списков, будут удалены только клиенты **не** присутствующие в любом из этих списков исключения, из текущего списка.
  {% endhint %}

## Как создать рассылку

Когда вы нажмёте на список, вы также увидите кнопку **«Создать рассылку»** в правой боковой панели.

<div data-with-frame="true"><figure><img src="/files/3d6634f2b40deddfb30d5b15ddebc482c6c2fa2b" alt="" width="563"><figcaption></figcaption></figure></div>

Вы можете создать рассылку как для **мессенджеров** и **email** (если в вашем проекте включена электронная почта).

## Как перенести клиента с других платформ

При загрузке клиентов из других платформ в разделе **«Мессенджеры»** вы можете выбрать один или несколько списков, куда клиенты будут помещены после загрузки.

Для этого:

1. Перейдите на вкладку **«Мессенджеры»** .
2. Выберите подключённый мессенджер, в который вы хотите загрузить клиентов.

<div data-with-frame="true"><figure><img src="/files/68c175b216898df4f2ce28504640dad5af276f0c" alt=""><figcaption></figcaption></figure></div>

Нажмите кнопку **кнопку «Загрузить клиентов»** и настройте параметры загрузки (кодировка, список назначения и т. д.), чтобы импортировать ваш список.

<div data-with-frame="true"><figure><img src="/files/4ea24fbb5a8316820d810dd35a0de7854a6740fb" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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://docs.mavibot.ai/doc/ru/crm/tags.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.