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

У **Списки** розділі ви можете створювати, редагувати та використовувати власні списки клієнтів для автоматизації.\
Додавання клієнтів до списку можна автоматизувати на основі кроків сценарію бота — за певних умов або дій користувача.

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

* Фільтрації та сегментації клієнтів у межах проєкту
* Експорт даних

Ви можете експортувати список як файл і імпортувати його в інший проєкт MaviBot.

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

#### **Переваги використання списків:**

* **Автоматизація:** Клієнти автоматично додаються до списків або видаляються з них на основі логіки бота.
* **Портативність:** Списки можна експортувати та імпортувати між різними проєктами.
* **Цільова комунікація:** Надсилайте розсилки або конкретні повідомлення воронки безпосередньо до відфільтрованих списків клієнтів.

Використання списків спрощує сегментацію аудиторії та робить взаємодію з клієнтами точнішою й ефективнішою.

## Як створити список

Списки створюються в **"Списки"** вкладці в межах того ж розділу.

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

Натисніть **«Створити список»** кнопку, щоб відкрити вікно з полями введення, де можна ввести назву списку та вибрати папку (якщо такі є), до якої додати список.

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

У **"Списки"** розділі ви можете сортувати списки за ID списку або в алфавітному порядку (за назвою):

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

Сила списків клієнтів полягає в їхній гнучкості. Ви можете, наприклад, додати одного клієнта до **кількох списків одночасно**.

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

* Об’єднані в папки
* Перейменовані
* Видалені (самі клієнти залишаються в базі даних)
* Використовувані для **видалення всіх клієнтів зі списку** з проєкту

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

Ви можете включати або виключати клієнтів, застосовуючи типи фільтрів — або вручну через форму, або завантаживши файл.

Щоб переглянути клієнтів у списку:

1. Натисніть на список, щоб відкрити меню праворуч.
2. Натисніть **«Переглянути список клієнтів»** кнопку.

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

Потім відкриється нове вікно з **"Клієнти"** розділу, де ви можете переглянути всіх користувачів у цьому списку.

## Як автоматизувати роботу зі списками

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

Знайдіть набір **дій зі списками** у будь-якому блоці конструктора:

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

Коли **«Дія»** розділ увімкнено, ви можете вибрати, які дії виконати зі своїми списками.

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

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

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

Команди виконуються в тому порядку, в якому вони відображаються в налаштуваннях блоку.

### Перевірка, чи є людина у списку

Щоб <mark style="color:green;">**перевірити, чи є клієнт у списку**</mark>, ви можете використовувати <mark style="color:green;">**`inlist (list_number)`**</mark> функцію в **) для збереження відповіді клієнта.** поле для порівняння в блоках і з’єднанні.

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

`inlist(list number) == True  -` клієнт Є у списку або

`inlist(list number) == False -` клієнта НЕМАЄ у списку.

<figure><img src="/files/1272c6b3919de1b4d775d0bc12591587689b1a35" alt=""><figcaption></figcaption></figure>

Номер списку можна знайти, натиснувши на потрібний список. У цьому разі праворуч відкриється меню з інформацією про список:

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

### Інші функції, пов’язані зі списками

{% hint style="info" %}
[Детальні інструкції щодо роботи з функціями списків і тегів ви знайдете тут.](/doc/uk/chatbot/functions/kalkulyator/lists.md)
{% endhint %}

## **Як працювати зі списками вручну**

Кожен список має кнопки для:

* Додавання/видалення клієнтів зі списку
* Запуску розсилки на основі списку
* Завантаження списку як файлу

Контекстне меню містить опції для:

* Додавання списку до папки
* Редагування списку
* Видалення списку (клієнти залишаються в проєкті)
* Видалення всіх клієнтів зі списку з проєкту

{% hint style="danger" %}

#### **Увага**

**«Видалити учасників списку з проєкту»** назавжди видаляє цих клієнтів із проєкту. Цю дію неможливо скасувати.
{% endhint %}

### Додати клієнтів до списку

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

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

{% hint style="warning" %}

#### Важливо

Під час додавання існуючих клієнтів до списку **з файлу**, перша колонка має містити **внутрішні ID клієнтів** ( `client_id` змінної).
{% endhint %}

#### Як додати клієнтів із файлу:

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

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

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

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

Щоб <mark style="color:green;">**додати НОВИХ клієнтів**</mark> до певного списку, перейдіть до розділу **«Канали»** . Потім натисніть **«Завантажити список клієнтів»** кнопку та виберіть список, до якого хочете завантажити клієнтів.

### Як видалити клієнтів зі списку

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

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

Застосуйте необхідні фільтри, щоб видалити певну групу клієнтів **З ЦЬОГО СПИСКУ** (а не з бази клієнтів).

{% hint style="danger" %}
**Будьте уважні під час заповнення форми.**

Якщо ви залишите поля фільтра у **«Видалити зі списку»** формі **порожніми**, **усі клієнти** в цьому списку будуть видалені.

Щоб видалити лише частину списку, заповніть відповідні фільтри:

* **За підключеними месенджерами** — виберіть конкретного бота
* **Клієнти в блоці** — вкажіть номер(и) блоку у воронці (можна додати кілька блоків)
* **За змінними клієнта** — введіть точне значення змінної
* **Зареєстровані до/після** — встановіть відповідний діапазон дат
* **Виключити списки** — якщо введено номери списків, буде видалено лише клієнтів **не** наявних у будь-якому з цих виключених списків, із поточного списку.
  {% endhint %}

## Як створити розсилку

Коли ви натиснете на список, ви також побачите **«Створити розсилку»** кнопку в правій бічній панелі.

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

Ви можете створити розсилку для обох **месенджерів** та **email** (якщо електронна пошта увімкнена у вашому проєкті).

## Як перенести клієнта з інших платформ

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

Для цього:

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

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

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

<div data-with-frame="true"><figure><img src="/files/83e4580a5a520d5b922bf966b7af11697670650a" 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/uk/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.