# Клиенты из мессенджеров

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

## Функции

### Написать в WhatsApp / Написать на Email

{% hint style="success" %}
Кнопки видны только если WhatsApp и/или Email-бот подключены к проекту.
{% endhint %}

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

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

Нажмите, чтобы открыть окно и добавить новый контакт WhatsApp. Здесь вы также можете создать клиента Email-бота и отправить письмо.

### Меню дополнительных действий

Чтобы выполнить действия в **Клиенты** разделе, нажмите на значок с тремя точками (⁝) в правом верхнем углу меню.

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

#### Отметить все как прочитанные

Эта функция отмечает все непрочитанные сообщения как прочитанные:

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

#### Повторно отправить сообщения с ошибкой

Эта функция повторно отправит последнее сообщение **ВСЕ** клиентам, у которых последнее сообщение бота отображает красный **ОШИБКА** статус.

{% hint style="danger" %}

#### Внимание

Это действие повторно отправляет последнее сообщение бота всем получателям, у которых произошёл сбой, — включая сообщения, отправленные гораздо раньше.
{% endhint %}

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

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

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

{% hint style="danger" %}

#### Внимание

Сообщение с ошибкой, например **"Слишком много запросов в секунду..."** открыто **автоматически** будет отправлено повторно через количество секунд, указанное в тексте ошибки.
{% endhint %}

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

#### Настройки предпросмотра клиента

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

Меню настроек позволяет выбрать данные, отображаемые в панели предпросмотра клиента.

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

#### Настройки отображения сообщений

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

Здесь вы можете выбрать, какие сообщения будут отображаться в чате:

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

#### Удалить отписавшихся

Это действие навсегда удалит из вашей базы данных всех пользователей, которые заблокировали бота, а также всех пользователей, которых вы заблокировали лично.

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

### Массовые действия в чате

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

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

**Какие массовые действия доступны:**&#x20;

1. Отметить как непрочитанное.

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

Если вы нажмёте на этот значок, все диалоги будут отмечены как "непрочитанные".

2. Отметить как прочитанное.

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

Если вы нажмёте на этот значок, все диалоги будут отмечены как "прочитанные".

3. Заблокировать (разблокировать) клиентов.

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

Это массовое действие поможет заблокировать или разблокировать всех отмеченных клиентов.

4. Удалить клиентов.

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

Если вы нажмёте на эту кнопку, все отмеченные клиенты будут <mark style="color:красный;">**НАВСЕГДА**</mark> удалены!

{% hint style="warning" %}

#### Обратите внимание

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

<img src="/files/9defbaa76d0cf51e38e1ddd7ff7305b3b880ad80" alt="" data-size="original">

В модальном окне указано, что действие **НЕОБРАТИМО!** Если вы введёте слово **"Подтвердить"**, массовое действие будет применено к выбранным клиентам.
{% endhint %}

5. Действия со списками и тегами.

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

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

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

Управляйте списками и тегами, выбирая их и нажимая **Добавить** или **Удалить**.

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

#### **Как выбрать несколько чатов**

Поставьте галочку в верхней части столбца действий, чтобы выбрать всех клиентов одновременно.

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

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

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

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

## Фильтры

Список клиентов включает **функцию фильтрации** для сортировки клиентов по различным критериям.

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

Вкладки в верхней части списка клиентов обеспечивают быструю фильтрацию:

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

{% hint style="info" %}

#### **Важно**

Метка "Непрочитано" снимается, как только сотрудник открывает диалог с клиентом.
{% endhint %}

* **Мои** — отображает клиентов, назначенных сотруднику, который в данный момент просматривает список.
* **Другое** — отображает клиентов, назначенных другим сотрудникам в системе.
* **Свободные клиенты** — отображает клиентов, не назначенных ни одному сотруднику.

Давайте рассмотрим доступные настройки фильтра.

<div data-with-frame="true"><figure><img src="/files/9e87e68322e04032b2f95fa097dfaa2b5f45d46c" 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/d708bea468d37b9f8d75035c50853ae64335b50b" alt="" width="357"><figcaption></figcaption></figure></div>

**Стадия сделки в CRM** — отображает всех клиентов на выбранных стадиях интегрированной CRM.

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

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

**Поиск по переменной** — состоит из двух полей: **"Имя переменной"** и **"Значение переменной."** Этот фильтр работает только при точном совпадении имени переменной и её значения.

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

**Пример:** Если вы введёте значение **"Цена"** в поле *Переменная* в поле, будут показаны клиенты, у которых связана **"Цена"** переменная. Однако если ввести **"цены"** больше не будут **не** найти **"Цена"** переменную.

Текст **Поле "Значение переменной"** работает так же — требуется точное совпадение.

Вы можете заполнить оба поля одновременно. Например, если вы зададите **"Размер"** в поле *Переменная* поле и **"M"** в поле *Поле "Значение переменной"* поле, вы увидите только тех клиентов, у которых `size = M`.

**Сбросить фильтры**r**s** — сбрасывает все фильтры.&#x20;

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

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

### Как скачать базу клиентов

Чтобы скачать базу клиентов в виде файла, перейдите в:\
**Клиенты → Фильтр → Скачать**

<div data-with-frame="true"><figure><img src="/files/8ab4945e6828e564279087b089879375028c0dbe" 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/9f36e4d244155af2d286141d8cff13316eaef328" alt=""><figcaption></figcaption></figure></div>

## Карточке клиента

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

Карточка клиента показывает ключевую информацию о клиенте:

* **Аватар**
* **Значок мессенджера** которым пользовался клиент
* **Имя клиента**
* **Статус клиента** (например, *заблокирован* / *приостановлен*)
* **Назначенный сотрудник**

— Связан с вами → показывает **"Ваш клиент"**\
— Связан с другим сотрудником → показывает его email или имя\
— Не назначен → метка не отображается

* **Время последней активности**
* **Индикатор последнего сообщения** (один из следующих):

— **Клиент** — последнее сообщение отправлено клиентом\
– **Вам** — последнее сообщение отправлено вами\
– **Email сотрудника** — последнее сообщение отправлено другим сотрудником\
– **Комментарий** — последнее сообщение является комментарием\
– **Вложение** — последнее сообщение содержит вложение

* **Значок закреплённого клиента**, если клиент закреплён

{% hint style="info" %}
Чтобы открыть чат, нажмите на карточку клиента.
{% endhint %}

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

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

Контекстное меню карточки клиента включает:

* **Отметить как непрочитанное** — помечает диалог как непрочитанный и перемещает клиента в **"Без ответа"** .
* **Закрепить/Открепить диалог** — закрепляет чат вверху списка (над всеми остальными) или открепляет его.
* **Заблокировать/Разблокировать** — блокирует или разблокирует клиента.
* **Удалить клиента** — навсегда удаляет клиента из базы данных. **Это действие нельзя отменить.**

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

Нажатие на карточку клиента в основном списке открывает чат с этим клиентом. В правой панели вы увидите полный профиль клиента. Каждый раздел карточки клиента в правой панели подробно описан в [нашем руководстве](/doc/ru/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/ru/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.