# Диалоги

Раздел [Диалоги](https://app.nextbot.ru/dialogs/0) предназначен для отображения всех чатов, в которых использовался ИИ-агент. Здесь можно увидеть список всех диалогов, которые пользователи вели с ИИ-агентом, а также просматривать ошибки и историю сообщений в каждом отдельном чате.

Этот раздел обеспечивает удобный доступ к информации о ранее проведённых диалогах, помогая отслеживать и анализировать взаимодействия с ИИ-агентом. Возможность применять фильтры к диалогам, просматривать истории сообщений и находить нужные данные позволяют быстрее решать текущие задачи.

<figure><img src="/files/8eifSqa8sfoAcLdU3GhP" alt=""><figcaption></figcaption></figure>

### Фильтры

В системе Nextbot можно использовать фильтр, который помогает быстро находить нужные диалоги по разным критериям. Например:

1. **Наличие ошибок** — можно отфильтровать диалоги, в которых были обнаружены какие-то проблемы или сбои.
2. **Наличие выполненных функций** — можно отфильтровать диалоги, по определенным функциям системы.
3. **Забаненные диалоги** — фильтр покажет диалоги с пользователями, которые были заблокированы.
4. **На паузе** — можно увидеть диалоги, которые временно приостановили взаимодействие с системой.

Для более целевого поиска можно использовать дополнительные параметры:

1. **По имени пользователя**\
   Вы можете найти диалоги, введя имя или часть имени пользователя. Это удобно, если нужно быстро найти все диалоги от конкретного человека.
2. **По диапазону дат**\
   Фильтр позволяет выбирать диалоги за определенный период. Например, можно посмотреть все созданные диалоги за "сегодня", "вчера", "7 дней", "30 дней", "этот месяц", "прошлый месяц", "все время", можно выбрать конкретный день или любой другой временной интервал.
3. **По мессенджеру**\
   Если пользователи пишут из разных мессенджеров (например, Telegram, WhatsApp, Авито), можно отфильтровать диалоги по конкретному мессенджеру. Это помогает работать только с нужным каналом связи.
4. **По тексту сообщения**\
   Вы можете найти диалоги, введя фразу или слово. Это удобно для поиска диалогов с ключевыми словами
5. **Номеру телефона**\
   Вы можете искать диалоги по номеру телефона. Удобно для поиска диалогов из WhatsApp<br>

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

{% hint style="info" %}
Для Вашего удобства указываются подсказки по выбранным фильтрам.
{% endhint %}

<figure><img src="/files/Ueq4bTOejw0zY0Eb8Ifq" alt=""><figcaption></figcaption></figure>

### **Интерфейс диалогов**

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

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

<figure><img src="/files/ngKCLsAzgqhsAXxBQkrk" alt="" width="563"><figcaption></figcaption></figure>

#### **Информация о расходах Botcoin и токенов:**

* **Расход Botcoin**: общий расход на диалог / расход на диалог после последнего рестарта.
* **Расход API ключа**: отображается при добавлении своего API-key из OpenAI. При добавлении ключа каждый запрос будет стоить фиксировано 0.01 BotCoins.
* **Входящие токены**: общее количество токенов, полученных ИИ-агентом.
* **Исходящие токены**: количество токенов, которые генерируются ИИ-агентом в ответ на входящие токены.

<figure><img src="/files/btNJpMmfTowgbIeHEgpD" alt=""><figcaption></figcaption></figure>

#### **Автообновление и ручное обновление:**

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

<figure><img src="/files/7CrfofzHVuP7ZiqdMSwX" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/4EDYnmAB8VByGs17wYsj" alt="" width="247"><figcaption></figcaption></figure>

### **Метаданные диалога**

В правом верхнем углу окна диалога находится кнопка `Метаданные диалога`.

По нажатию открывается боковая панель с метаданными текущего диалога. В этой панели отображаются:

* выполненные функции;
* все пользовательские переменные области `Диалог`.

<figure><img src="/files/zOfrRWHSdHYd151wRDgn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6zEYUNsljLoUhGL2VxLl" alt=""><figcaption></figcaption></figure>

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

Чтобы изменить переменную диалога вручную:

1. Откройте нужный диалог.
2. Нажмите кнопку `Метаданные диалога`.
3. Найдите нужную переменную в правой панели.
4. Нажмите на иконку редактирования рядом с ней.
5. Введите новое значение и сохраните изменения.

{% hint style="info" %}
Через эту панель меняются только переменные области `Диалог`. Переменные области `Агент` редактируются на странице [Настройка Агента](/functional/setting-up-agent.md).
{% endhint %}

### **Теги сообщений**

В интерфейсе диалога используются специальные теги, которые помогают отличать типы сообщений. Это могут быть, например:\
– Сообщения оператора\
– Стартовые сообщения\
– Имя текущего ИИ-агента\
– Сообщения из Instagram Direct или комментариев под постами\
– Рассылка/Nextbot

<figure><img src="/files/aLFRPuecMvwNNBmM0pS2" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UMAnxPBY8aB4gv696Pk6" alt=""><figcaption></figcaption></figure>

### **Метаданные сообщения**

<figure><img src="/files/I0JOCiXF3imRCpPuDOHR" alt=""><figcaption></figcaption></figure>

Метаданные сообщения показывают сведения, откуда пришел диалог, например:\
\- **Telegram** указывается тип чата "группа" (telegram группа), "бот" или "бизнес" (бизнес аккаунт).\
\- **Авито** - используется название аккаунта продавца.\
\- **Whatsapp**\* - номер телефона пользователя.

\**Принадлежит компании Meta, которая признана экстремистской организацией и запрещена в РФ.*

### **Управление диалогом: пауза, блокировка и очистка**

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

Пауза позволяет избежать лишних ответов от ИИ-агента в моменты, когда пользователь не может или не хочет общаться. Это создает более комфортные условия для взаимодействия, позволяя пользователю контролировать свое общение с ИИ-агентом и возвращаться к нему в удобное время, сохраняя при этом всю историю сообщений.

<div><figure><img src="/files/5rm1FauuKKXsc2SzScbB" alt=""><figcaption></figcaption></figure> <figure><img src="/files/0FhL4E4KvoXVXsr8qoV9" alt="" width="275"><figcaption></figcaption></figure></div>

**Заблокировать пользователя:** позволяет полностью приостановить взаимодействие с ИИ-агентом для конкретного пользователя. При активации блокировки входящие сообщения не будут сохраняться, и ИИ-агент не будет отвечать на них. Статус блокировки будет отображаться красным цветом, что наглядно сигнализирует о том, что диалог заблокирован.

Эта функция полезна для управления нежелательными или неподходящими взаимодействиями с ИИ-агентом. Блокировка позволяет предотвратить получение сообщений от пользователя, который может проявлять неактивность или вести себя неуместно в рамках общения.

<div><figure><img src="/files/rmVrtlntyP9nptdRHDmN" alt=""><figcaption></figcaption></figure> <figure><img src="/files/DWRPsocBBXG8BpiC2CQh" alt="" width="273"><figcaption></figcaption></figure></div>

**Очистить диалог от сообщений:** позволяет полностью удалить всю переписку в рамках одного диалога.

ВНИМАНИЕ: данное действие необратимо, будьте аккуратны!

<figure><img src="/files/kwBu0oDK2K503SjJVIAX" alt=""><figcaption></figcaption></figure>

#### **Сообщения:**

Под каждым входящим сообщением от бота отображается количество токенов, затраченных на формирование ответа. Это позволяет пользователям видеть, сколько ресурсов было использовано для обработки их запроса.

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

<figure><img src="/files/NpDep8rlFEenh05kDHtY" alt=""><figcaption></figcaption></figure>

При подключении [Базы знаний](/functional/knowledge-base.md) пользователю отображается процент совпадений, который рассчитывается на основе добавленных вложений. Это позволяет видеть, насколько информация в запросе соответствует данным, содержащимся в Базе знаний.

Отображение процента совпадений помогает пользователям оценивать релевантность информации, получаемой от ИИ-агента. Это может быть полезно для понимания, насколько точно ИИ-агент отвечает на запросы, а также для выявления областей, где информация может быть недостаточно полной или актуальной. Такой подход способствует более эффективному использованию Базы знаний и улучшает качество взаимодействия с ИИ-агентом.

<figure><img src="/files/jBMG9K3lhuky8mxy28e4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9jboBM2dg5o549nztBQc" alt="" width="563"><figcaption></figcaption></figure>

### Массовые операции с диалогами

Функционал Диалогов позволяет выбрать несколько диалогов, все диалоги или только отфильтрованные по условию, а затем применить к ним массовые операции, такие как:

* Поставить на паузу
* Снять с паузы
* Начать [Массовую рассылку](/functional/rassylki.md)
* Скачать диалог(и) в формате XLSX
* Забанить
* Разбанить
* Удалить

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

<div align="left"><figure><img src="/files/r4OnR9z2u84l3EDJtxdm" alt=""><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/QwJMsXlmhHAd20ZeSNQZ" alt=""><figcaption></figcaption></figure></div>

Также можно применить фильтр, выбрать все диалоги, удовлетворяющие условию, и выполнить с ними нужное действие.\ <br>

<div data-full-width="true"><figure><img src="/files/U1s5ltCAvmHiPGCxq9Fb" alt=""><figcaption></figcaption></figure></div>

### **Отображение функции**

Показывает информацию в диалоге, когда срабатывает или не срабатывает определенная функция. Это означает, что пользователи могут видеть результаты выполнения функции или связанные уведомления сразу в контексте их общения с ИИ-агентом.

При срабатывании [функции](/functional/functions.md) отображается информация в диалоге подсвечивается зеленым, с информацией о названии функции, параметров функции и ответов от пользователя, результаты выполнения функции.

В выборе диалога отображается "галочкой", что функция выполнена.

<div><figure><img src="/files/HVfGilwkTfQDiIVQWPjw" alt=""><figcaption></figcaption></figure> <figure><img src="/files/1lGjPXsCQf1cdV7F6Gpi" alt=""><figcaption></figcaption></figure></div>

Также информацию о выполненных функциях отображается в верхней части диалога.

<figure><img src="/files/joU4S14w3aKTyhsy7kqh" alt=""><figcaption></figcaption></figure>

При не срабатывании функции, отображается сообщение об ошибке, подсвечивается красным с названием ошибки и информацией о ней.

В выборе диалога отображается "крестик", что в диалоге ошибка.

<div><figure><img src="/files/dXqkVpP0AcidaurwSjug" alt=""><figcaption></figcaption></figure> <figure><img src="/files/3k5MNJtyWRSVX0N3mjvb" alt=""><figcaption></figcaption></figure></div>

### **Отображение отложенных сообщений**

Промпт [отложенной отправки](/functional/setting-up-agent.md#otlozhennaya-otpravka) отображается только в диалоге. Если пользователь не ответил на последнее сообщение, то будет отправлено напоминание через указанное время введенное в [настройках Агента](/functional/setting-up-agent.md).

<figure><img src="/files/pBiC0shorDLWK7pvYkjF" alt="" width="563"><figcaption></figcaption></figure>

### **Отображение информационных сообщений**

Эти подсказки объясняют, почему ИИ-агент временно не отвечает:\
\- **Пауза диалога** **по причине**– например, из-за вмешательства оператора, вызова функции, спам агента.\
\- **Агент не работает** - агент не будет отвечать в это время в соответствии с настройками расписания.\
\- **Агент отключен -** Агент отключен на странице выбора агентов.\
\- **Запрещенный этап Bitrix** - Если сделка была перемещена на этап, не входящий в этот список, вы увидите сообщение «Запрещенный этап Bitrix», и диалог с агентом будет заблокирован.

<figure><img src="/files/imu0NRgX78CLuRIsHZue" alt=""><figcaption></figcaption></figure>

### **Отправка из диалога**

Позволяет пользователям отправлять сообщения от имени ИИ-агента непосредственно в рамках текущего диалога.

{% hint style="info" %}
Для отправки сообщения из нескольких строк, используйте Ctrl+Enter для перевода курсора на новую строку
{% endhint %}

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

<figure><img src="/files/gvpSLwGFCdIy57oK1OSN" alt=""><figcaption></figcaption></figure>

### Отправка изображений/документов через Диалоги

На странице Диалогов вы можете отправить файлы с помощью кнопки "скрепки". Нажмите на неё, выберите файл — после загрузки он будет готов к отправке. При необходимости добавьте текст к изображению перед отправкой.

**Поддерживаемые форматы:** `jpg, jpeg, png, webp, jfif, heic, heif, pdf`

<figure><img src="/files/IRnR9LwaypZsbt2hwJ71" alt=""><figcaption></figcaption></figure>

Также можно отправить файл из Облака прямо через Диалог — нажмите на иконку «Облака» и выберите нужный файл в открывшемся окне.


---

# 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://doc.nextbot.ru/functional/dialogi.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.