# Клієнти з месенджерів

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

## Функції

### Написати у WhatsApp / Написати на Email

{% hint style="success" %}
Кнопки видно лише якщо бот WhatsApp та/або Email підключено до проєкту.
{% endhint %}

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

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

Натисніть, щоб відкрити вікно й додати новий контакт WhatsApp. Тут також можна створити клієнта бота Email і надіслати листа.

### Меню додаткових дій

Щоб виконати дії в **Клієнти** розділі, натисніть на значок із трьома крапками (⁝) у верхньому правому куті меню.

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

#### Позначити всі як прочитані

Ця функція позначає всі непрочитані повідомлення як прочитані:

<div data-with-frame="true"><figure><img src="/files/34e8830871e50f6334c8da7e4688df6a0484cd7f" alt="" width="243"><figcaption></figcaption></figure></div>

#### Повторно надіслати повідомлення з помилкою

Ця функція повторно надішле останнє повідомлення **ВСІ** клієнтам, у яких останнє повідомлення від бота має червоний **ПОМИЛКА** статус.

{% hint style="danger" %}

#### Увага

Ця дія повторно надсилає останнє повідомлення бота всім невдалим одержувачам — включно з повідомленнями, надісланими значно раніше.
{% endhint %}

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

Натисніть кнопку, щоб відкрити налаштування, де можна задати дату повторної відправки, вибрати месенджер і налаштувати інтервал надсилання.

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

{% hint style="danger" %}

#### Увага

Повідомлення з помилкою, наприклад **«Занадто багато запитів за секунду...»** є **автоматично** повторно надісилається через кількість секунд, указаних у тексті помилки.
{% endhint %}

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

#### Налаштування попереднього перегляду клієнта

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

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

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

#### Налаштування відображення повідомлень

<div data-with-frame="true"><figure><img src="/files/9acc351942f588f743448d76a8ba3cf91a43820a" alt="" width="245"><figcaption></figcaption></figure></div>

Тут ви можете вибрати, які повідомлення відображатимуться в чаті:

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

#### Видалити відписників

Ця дія назавжди видалить із вашої бази всіх користувачів, які заблокували бота, а також усіх користувачів, яких ви заблокували особисто.

<div data-with-frame="true"><figure><img src="/files/6a2fe652e019976c4530f976ac93038a01147f20" alt="" width="241"><figcaption></figcaption></figure></div>

### Пакетні дії в чаті

<div data-with-frame="true"><figure><img src="/files/48c2ca1ffc2a79ea2a151fe3070080997e90f7f2" alt="" width="243"><figcaption></figcaption></figure></div>

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

**Які пакетні дії доступні:**&#x20;

1. Позначити як непрочитане.

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

Якщо натиснути на цю піктограму, всі діалоги буде позначено як «непрочитані».

2. Позначити, як прочитане.

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

Якщо натиснути на цю піктограму, всі діалоги буде позначено як «прочитані».

3. Заблокувати (розблокувати) клієнтів.

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

Ця пакетна дія допоможе заблокувати або розблокувати всіх позначених клієнтів.

4. Видалити клієнтів.

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

Якщо натиснути на цю кнопку, всі позначені клієнти будуть <mark style="color:red;">**НАЗАВЖДИ**</mark> видалені!

{% hint style="warning" %}

#### Зверніть увагу

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

<img src="/files/4ac5bfbe4ef5224b6689baab783c703bb545f953" alt="" data-size="original">

У модальному вікні зазначено, що дія **НЕЗВОРОТНА!** Якщо ви введете слово **«Підтвердити»**, пакетна дія буде застосована до вибраних клієнтів.
{% endhint %}

5. Дії зі списками та тегами.

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

Використовуйте пакетні дії, щоб одночасно додати кількох клієнтів до списку (або позначити їх тегом) чи видалити їх зі списку.

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

Керуйте списками та тегами, вибираючи їх і натискаючи **Додати** або **Видалити**.

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

#### **Як вибрати кілька чатів**

Поставте галочку у верхній частині колонки дій, щоб вибрати всіх клієнтів одночасно.

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

Вибирайте окремі чати, встановлюючи відповідні прапорці.

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

{% hint style="success" %}
Тепер ви готові керувати списками клієнтів за допомогою пакетних дій
{% endhint %}

## Фільтри

Список клієнтів містить **функцію фільтрації** щоб сортувати клієнтів за різними критеріями.

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

Вкладки у верхній частині списку клієнтів забезпечують швидку фільтрацію:

* **Усі** – відображає всі діалоги з клієнтами, що збережені в CRM.
* **Без відповіді** – показує лише клієнтів, які мають непрочитані повідомлення.

{% hint style="info" %}

#### **Важливо**

Позначка «Непрочитано» зникає, щойно член команди відкриває діалог із клієнтом.
{% endhint %}

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

Розглянемо доступні налаштування фільтрів.

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

Фільтри дають змогу зосередитися на цільовій групі клієнтів на основі ваших запитів.

{% hint style="info" %}
Зберігайте налаштування фільтра для зручного повторного використання пізніше — просто виберіть їх зі списку збережених фільтрів.
{% endhint %}

#### **Доступні фільтри**

**Пошук** — шукає за іменем або унікальним ідентифікатором месенджера. Наприклад, введення `1988` знайде клієнта на ім’я `Vasya1988` і того, хто має Telegram ID `7771988777`.

**За ID клієнта** — шукає клієнта за його внутрішнім службовим ID. Це поле працює за частковим збігом. Наприклад, `10` відповідатиме таким ID, як 10, 110, 100, 210 тощо.

**Блоки воронки** — відображає клієнтів, які наразі перебувають у певному блоці, наприклад у `Вітання` .

**Списки розсилок** — відображає клієнтів, які перебувають у вибраному списку(ах) розсилки.

**Виключити списки** — виключає клієнтів, які перебувають у вказаному списку(ах) розсилки.

**Виключити теги** — виключає клієнтів, які мають указані теги Mavibot.

**Теги** — відображає клієнтів, які мають указані теги Mavibot.

**Канали зв’язку** — відображає клієнтів за ботом, у якому вони перебувають, наприклад, двома різними Telegram-ботами.

**Зареєстровані до** — відображає клієнтів, які зареєструвалися до певної дати.\
\&#xNAN;*Приклад:* `Зареєстровані до 23.05.2023` включає клієнтів, зареєстрованих до 22.05.2023 23:59, але не тих, хто зареєструвався 23.05.2023 о 00:00.

**Зареєстровані після** — відображає клієнтів, які зареєструвалися після певної дати.\
\&#xNAN;*Приклад:* `Зареєстровані після 20.05.2023` включає клієнтів, зареєстрованих з 20.05.2023 00:01 і далі, але не тих, хто зареєструвався раніше.

**Сортувати чати за датою створення клієнта** — сортує клієнтів у спадному порядку (спочатку найновіші).

**Непрочитані** — відображає клієнтів (на основі інших фільтрів), які мають непрочитані повідомлення.

**Показати відписаних** — відображає клієнтів, які відписалися від ваших ботів.

**Виключити відписаних** — приховує клієнтів, які відписалися від ваших ботів.

**Показати заблокованих клієнтів** — відображає клієнтів, яких було заблоковано.

<div data-with-frame="true"><figure><img src="/files/55321682630886ccb805f7ccc6c53e3738e9b06b" alt="" width="357"><figcaption></figcaption></figure></div>

**Стадія угоди в CRM** — відображає всіх клієнтів на вибраних стадіях інтегрованої CRM.

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

**Власник** — коли ввімкнено автоматичне або ручне призначення клієнта, власник (призначений співробітник) показується в профілі клієнта. Ви можете використовувати цей фільтр, щоб переглядати клієнтів за призначеним власником.

**Пошук за змінними** — складається з двох полів: **«Назва змінної»** та **«Значення змінної.»** Цей фільтр працює лише за точного збігу назви змінної та її значення.

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

**Приклад:** Якщо ви введете **«Price»** у полі *Змінна* поле, буде показано клієнтів із пов’язаною **«Price»** змінною. Однак якщо ввести **«prices»** більше не будуть **не** знайдіть **«Price»** змінну.

Поле **Поле «Значення змінної»** працює так само — потрібен точний збіг.

Ви можете заповнити обидва поля одночасно. Наприклад, якщо ви встановите **«Size»** у полі *Змінна* поле та **«M»** у полі *Поле «Значення змінної»* поле, ви побачите лише клієнтів, у яких `size = M`.

**Скинути фільте**r**s** — скидає всі фільтри.&#x20;

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

Ви також можете комбінувати всі наведені вище фільтри, щоб створити саме той сегмент клієнтів, який вам потрібен.

### Як завантажити базу клієнтів

Щоб завантажити базу клієнтів у вигляді файла, перейдіть до:\
**Клієнти → Фільтр → Завантажити**

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

{% hint style="danger" %}

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

* Експорт підтримує до **100 000 клієнтів** на CSV-файл, якщо включено всі змінні.
* Для баз **що перевищують 100 000 клієнтів**, розділіть експорт на кілька частин, якщо вам потрібна кожна змінна клієнта.
* У **.xls** формат файлу, буде включено лише **основні 11 колонок** .
  {% endhint %}

Кнопка дає змогу експортувати список клієнтів у стандартному форматі — **CSV** або **XLS** — який можна відкрити в Excel. Файл міститиме такі колонки:

1. **ID клієнта** (`client_id`)
2. **Ім’я клієнта**
3. **Месенджер** використаний клієнтом
4. **Бот** якому написав клієнт
5. **Унікальний ID месенджера** (наприклад, номер телефону для WhatsApp)
6. **Дані останньої дії**
7. **Дата останньої дії**
8. **URL аватара клієнта**
9. **Поточний ID блоку**
10. **Історія переходів** (відвідані блоки)
11. **Тег**

{% hint style="info" %}
**Після цих 11 колонок буде включено користувацькі змінні — але лише у форматі файлу .CSV.**
{% endhint %}

Ви також можете експортувати клієнтів із певного списку. Для цього натисніть **Експортувати клієнтів** кнопку в **Списки** розділ.

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

## Картка клієнта

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

Картка клієнта показує основні дані клієнта:

* **Аватар**
* **Піктограма месенджера** який використав клієнт
* **Ім’я клієнта**
* **Статус клієнта** (наприклад, *заблокований* / *призупинений*)
* **Призначений співробітник**

– Пов’язаний із вами → показує **«Ваш клієнт»**\
– Пов’язаний з іншим співробітником → показує його email або ім’я\
– Не призначено → позначка не показується

* **Час останньої активності**
* **Індикатор останнього повідомлення** (один із таких):

— **Клієнт** — останнє повідомлення надіслане клієнтом\
– **Вам** — останнє повідомлення надіслане вами\
– **Email співробітника** — останнє повідомлення надіслане іншим співробітником\
– **Коментар** — останнє повідомлення є коментарем\
– **Вкладення** — останнє повідомлення містить вкладення

* **Піктограма закріпленого клієнта**, якщо клієнт закріплений

{% hint style="info" %}
Щоб відкрити чат, натисніть на картку клієнта.
{% endhint %}

### Контекстне меню

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

Контекстне меню картки клієнта містить:

* **Позначити як непрочитане** – позначає діалог як непрочитаний і переміщує клієнта до **«Без відповіді»** .
* **Закріпити/відкріпити діалог** – закріплює чат угорі списку (над усіма іншими) або відкріплює його.
* **Заблокувати/розблокувати** – блокує або розблоковує клієнта.
* **Видалити клієнта** – назавжди видаляє клієнта з бази даних. **Цю дію не можна скасувати.**

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

Натискання на картку клієнта в основному списку відкриває чат із цим клієнтом. У правій панелі ви побачите повний профіль клієнта. Кожен розділ картки клієнта в правій панелі детально описано в [нашому посібнику](/doc/uk/crm/customers/helpdesk.md).&#x20;

Зверніть увагу, що в лівому меню відображається **кількість непрочитаних повідомлень**.

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

Те, що відображається, залежить від вашої ролі в проєкті:

* **Адміністратори** бачать загальну кількість усіх непрочитаних повідомлень у проєкті.
* **Оператори** бачать лише непрочитані повідомлення від клієнтів, призначених їм.


---

# 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/customers.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.