# Client chat

Click any user in the left-hand list within the **Clients** section to open a window showing their information and chat history.

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

The **Clients** section lets you chat with users from multiple messengers in one unified interface, eliminating the need to switch apps.

## Client data and information

The **client card** in the right sidebar displays the client's full profile — from standard details to custom variables collected via bot, landing pages, or third-party integrations.

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

{% hint style="warning" %}

#### Note

All data is fictional; any resemblance to actual persons is purely coincidental.
{% endhint %}

The card includes several subsections:

* **About**
* **Comments**
* **Deals**
* **Tasks**
* **Courses**

### About

Every client card contains default information fields and action buttons for interaction.

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

{% hint style="warning" %}

#### Note

All data is fictional; any resemblance to actual persons is purely coincidental.
{% endhint %}

The client card displays the client’s messenger profile picture (if available) and their name as registered in the messenger (phone number, username, etc.).

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

To change the client's name, click the pencil icon and enter the new name.

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

**Client ID** is the client's unique identifier within MaviBot. This `client_id` is used in MaviBot functions and is often required for client-related operations such as searching, linking, and other actions.

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

Use the **Transfer client** button or the **Owner** field to assign an owner to the client.

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

The client card displays the client’s current funnel stage and allows you to move them between stages.

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

{% hint style="info" %}
If the client is not linked to any deal or funnel, the deal stage will not be displayed.
{% endhint %}

If you have multiple funnels, their stages remain hidden until you click on a specific funnel to change the client’s stage.

You can also add tags or assign the client to a list in this block. Tags and lists can be created directly from the client card:

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

<details>

<summary><strong>How to add a client to a list or assign a tag</strong></summary>

Use the **About** tab to tag the client or add them to existing lists.

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

To add a tag, click the **"+ Tags"** button. In the window that opens, enter the tag name in the empty field and, if desired, choose a color for it.

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

Add as many tags as needed, and check the box next to each one to assign it to the client.
\
To edit or delete a tag, click the pencil icon, then make your changes or remove the tag in the window that opens.

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

Later, you can use these tags to filter clients in the search.
&#x20;Similarly, you can also create client lists:

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

Enter the list name in the required field and, optionally, select a color for it. Then check the required list.

</details>

There is a section with variables and a variable editor below the client card.\
You can add a variable from this block by selecting the type of variable (customer variable or deal variable) and specifying its name and value.&#x20;

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

The card also contains system variables. The documentation will focus exclusively on these, since the set of variables you can define in your project will be unique.

{% hint style="info" %}
[More information about variables is described here.](/chatbot/functions/variables.md#how-to-set-client-variables)
{% endhint %}

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

1. **Tag** — a tracking variable that shows where the client came from. Learn more about tags [here](/websites/sites/builder.md).
2. **Creation date** — the date and time the client was created, shown in the project's time zone.
3. **Last action** — the timestamp of the most recent activity with this client.
4. **Source** — the messenger the client used to contact you.
5. **Messenger ID** — the client’s unique identifier within the messenger (`platform_id`). Used for exports, API functions, search, and other operations.
6. **Linked to a bot** — the name or ID of the bot the client is connected to.
7. **Funnel position** — the block number in the flow diagram (Funnel Builder) where the client is currently located.
8. **Owner** — the email of the employee assigned to the client. If assigned to you, it shows **"Your client"**.

If the client is in a funnel block with a scheduled delayed message, the variable **"Messages scheduled"** will appear:

<details>

<summary>More about scheduled messages</summary>

If you click on the parameter, a window with the list of scheduled messages will open.

The modal displays:

* The block number where the message is scheduled
* The message text or block name (if provided)
* The scheduled date and time for sending

You can adjust the date and time by:

1. Selecting a new date from the calendar.
2. Entering a new send time.
3. Clicking the **"Confirm"** button.

{% hint style="info" %}
If you don’t click **Confirm** to save the changes, the message will be sent according to the original schedule.

Save all the changes you make to send messages correctly.
{% endhint %}

You can:

* Send the block immediately (click the **letter icon** button).
* Cancel the scheduled send (click the **crossed circle** button).
* Leave it unchanged (click the **"X"** in the top-right corner).

</details>

10. **Proxy links** — displays the number of proxy links associated with the client. You can open a table of these proxy links by clicking on it.

### Comments

The "Comment" subsection allows you to leave notes within the client's chat, which the client will not see.

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

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

This is convenient when clarifying a client’s question or when multiple operators or employees from different departments collaborate on the same client.

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

You can also leave a comment by clicking on **"Convert to comment"** while writing a message.

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

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

The comment will display its creator and the date/time. You can also delete, edit, or pin a comment left in the dialog. You can select an action from the side menu.

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

### Deals

The "Deals" tab displays all the client's deals, both active and already completed.

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

An example of a successfully closed deal:

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

If the deal is closed but you need to add a variable to it, you can do so by clicking on the active line labeled ***"+ New variable."***

In this tab, you can create a new deal for this client.\
Click **"+ Create a deal"** and enter the details in the creation form. Specify the budget, set all the necessary data, and select the funnel state for the created deal:

### Tasks

The "Tasks" section will help you assign a task to a responsible employee and not forget about its completion.

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

You can create a task by clicking the button with the same name.&#x20;

To create a task, specify the task name, enter its description and priority, and set the completion date:

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

When the task is created, it will be displayed in the section with its description and dates of completion.

## Chat

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

The upper part contains the client’s name, the time of his last activity, and his messenger ID.

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

Buttons and menu in the block:

1. **Pause the bot** — suspending the bot for this client for 24 hours, or restarts the stopped bot.
2. **Word search for messages** — searching the dialog based on specified words.
3. **Show/hide the side menu** — hides or displays the left panel of the "Clients" section.
4. **Mark the dialog as unread** — marks the client’s last message as unread.
5. **Unpin Dialog / Pin Dialog** — unpins or pins the dialog in the client list. Pinned dialogs are always displayed at the top of the client list.
6. **Block/unblock the client** — blocks or unblocks the client.&#x20;
7. **Delete a client** — removes a client from MaviBot.

The dialog window displays messages from the client, messages from managers and the bot, as well as system notifications highlighted in yellow (such as callbacks and comments that the client cannot see)

All messages contain a context menu. Regular messages can be pinned or deleted

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

The pinned message will be displayed at the top, indicating the time of sending. You can unpin the message by clicking the "X" button.

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

You can resend a message to the client, with the option to change the message subject (for email bots) when forwarding, for example, from Telegram to email.

All employees except operators can delete messages. To limit the ability to delete messages, you can configure roles.

{% hint style="info" %}
How to work with roles is described in the article "[Employees](/us/admin/employees.md)."
{% endhint %}

## Message sending form

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

***Главное поле*** — поле ввода сообщения для отправки клиенту.\
Меню формы

1. ***Отправить emoji (смайлик)*** открывает меню с выбором emoji, чтобы добавить emoji в ваше сообщение, просто нажмите на нужную иконку.
2. ***Прикрепить файл*** - загрузить файл для отправки клиенту. Открывает меню с выбором типа файла. Также в этом окне вы можете просмотреть ранее загруженные файлы, их размер, дату загрузки и название. Ненужные файлы можно удалять.

{% hint style="success" %}
Вы можете загрузить изображения из буфера обмена, просто вставив его в главное поле ввода сообщения. Оно будет загружено к нам на сервис и будет занимать 1 из 40 мест
{% endhint %}

<mark style="color:orange;">**В проекте может быть**</mark><mark style="color:orange;">**&#x20;**</mark>*<mark style="color:orange;">**до 200 файлов.**</mark>*<mark style="color:orange;">**&#x20;**</mark><mark style="color:orange;">**После загрузки 200 файлов, чтобы загрузить новый, вам придется удалить один из старых файлов.**</mark>

3. ***Быстрые ответы*** - позволяет создавать шаблоны сообщений для отправки клиентам. Также можно формировать отдельные папки для удобства поиска и категорирования готовых сообщений.

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

После клика на кнопку (См. пример выше), откроется небольшая форма с заполнением поля названия раздела ответов.

4. ***Отправить сообщение из воронки***  - позволяет отправить клиенту сообщение, из конкретного блока. После отправки сообщения, клиент будет перенаправлен в выбранный блок, а его дальнейшие действия будут зависеть от последующей цепочки в разделе воронки. \
   В открывшемся окне выбора блока из раздела воронки необходимо выбрать нужный блок. Блоки можно отфильтровать их по цвету (типу), найти через форму поиска по описанию, ID или ответу.
5. ***Преобразовать в комментарий*** - позволяет преобразовывать сообщение в комментарий для подготовки более полного ответа клиенту и комментирования действий сотрудника в диалоге.

{% hint style="info" %}
Подробнее о работе с комментариями рассказали выше в разделе "[Comments](#comments)"
{% endhint %}

6. **Иконка таймера** -  при нажатии открывается меню, в котором можно выбрать точное время для отправки сообщения. Чтобы выбрать дату и время, нужно кликнуть на соответствующее поле.
7. **Кнопка отправки сообщения** — отправляет введённое сообщение.&#x20;

Вы можете отправить переменную в виде #{имя\_переменной}, и она будет доставлена в виде значения этой переменной. Есть возможность изменять высоту поля ввода сообщения, для этого нужно просто потянуть за верхнюю часть блока, в котором находится поле.

8. Сгенерировать текст с помощью ИИ — для генерации текста сообщения с помощью AI.

## Отличие ответственного за сделку и ответственного за клиента

В контексте CRM и диалогов с клиентами, ответственный за клиента и ответственный за сделку - это две разные роли, хотя и тесно взаимосвязанные.&#x20;

1. **Ответственный за клиента** обычно отвечает за установление и поддержание отношений с клиентом.&#x20;

В контексте диалогов с клиентом в MaviBot - **ответственным за клиента** является тот менеджер (сотрудник) вашего проекта, который в данный момент ведет переписку с клиентом в разделе "Клиенты".

Три способа, как назначить ответственного за клиента:

1. Кликнуть "Взять клиента";
2. Кликнуть "Передать клиента";
3. В поле "Ответственный" выбрать сотрудника.

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

2. **Ответственный за сделку**, в свою очередь, фокусируется на конкретном этапе продаж, например, на заключении договора на этапе "Первичный контакт" или на выполнении заказа.

Чтобы просмотреть ответственных по сделкам клиентов, перейдите во вкладку "Сделки" в карточке клиента.

Ответственными за клиента и ответственными за сделку могут быть назначены разные сотрудники вашего проекта.

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

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


---

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