> For the complete documentation index, see [llms.txt](https://metabot.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://metabot.gitbook.io/documentation/panel-upravleniya-botom/lidy.md). # Лиды {% embed url="" %} Конечные клиенты или пользователи, которые непосредственно общаются с ботом называются **лидами** (далее слова лиды и пользователи будут взаимозаменяемы), это понятие происходит от английского слова lead — термин из сферы продаж и маркетинга означающий потенциального клиента. Мы будем часто говорить о пользователях, поскольку правильно рассматривать чат-боты, как сервис для самообслуживания, а также потому, что мы часто будем говорить о разработке полноценных приложений. Там, где есть пользователи, есть пользовательский интерфейс, его удобство и опыт. Все это важные концепции, понимание которых необходимо для создания успешных решений. Итак, все пользователи, которые когда либо взаимодействовали с вашим ботом аккумулируются на вкладке **Лиды** в вашем Боте. Когда пользователь связывается с компанией через аккаунт в мессенджере, социальной сети или через окно чата на сайте (в общем, через любой канал связи), создаётся лид. В раздел [**Лиды**](https://app.metabot24.com/lead) можно перейти по одноименной кнопке на главном экране или из панели управления раздела **Настройки бота** выбрать пункт меню [**Лиды**](https://app.metabot24.com/lead)**.** ![Раздел "Лиды"](/files/-MSX-1IQgs-yGAIlaIr4) В лиде на платформе сохраняются все параметры, которые он может приобрести во время общения с ботом. Один из примеров - теги и атрибуты пользователя — те данные, которые бот создает в ходе диалога. Также по каждому лиду платформы хранится вся история диалога, со всеми временными обозначениями. Диалог осуществляется с помощью обмена вебхуков, историю (лог) которых также можно просмотреть через лида, в целях проверки работы видимых или невидимых для пользователя команд бота. В соответствующем разделе на платформе размещается список пользователей - Лидов, которые взаимодействовали с ботом. По лиду производится сбор следующей информации: * **Клиент** - логин пользователя; * **Внешний ID;** * **Канал** - канал интеграции; * **Мессенджер** - при создании лида заполняется данными мессенджера по каналу интеграции; * **Менеджер -** закрепленный за пользователем менеджер; * **Статус** - действующий статус лида на данный момент времени; * **Атрибуты** - список атрибутов, сохраненных в базе, например: значения, тэги, контекст; * **Операции**: * Отключение / включение реакции бота на сообщения лида; * Сообщения- список всех сообщений данного пользователя с ботом; * Редактировать - форма редактирования реквизитов по выбранной строке списка лидов; * Сбросить беседу для этого лида. ### Фильтрация и поиск Фильтрация и поиск данных может производиться по следующим параметрам: * **Лид** - поиск по выпадающему списку всех лидов, взаимодействовавших с этим ботом; * **Тэг** - фильтр, выбор значения *Тэга* из выпадающего списка тэгов, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Переменная** - фильтр, выбор значения *Переменной* из выпадающего списка переменных, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Выключен** - фильтр по параметру включен или выключен бот для лида: * если ДА, то фильтруются лиды, для которых бот *выключен*; * если НЕТ, то фильтруются лиды, для которых бот *включен*. * **Канал** - фильтр, выбор значения *Канала* из выпадающего списка подключенных в данном боте каналов; * **NLP** - фильтр, выбор значения по Активной NLP интеграции из выпадающего списка; * **Статус** - фильтр, выбор значения *Статуса* из выпадающего списка статусов, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Контекст** - фильтр, выбор значения *Контекст* из выпадающего списка контекстных данных, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Значение** - фильтр, выбор *Значения* из выпадающего списка значений, которые были присвоены лидам, взаимодействовавшим с этим ботом; * **Чат передан оператору** - фильтр по параметру передал ли диалог с лидом оператору: * если ДА, то фильтруются лиды, для которых диалог/чат передан оператору; * если НЕТ, то фильтруются лиды, для которых диалог/чат ведется ботом. * **Мессенджер** - фильтр, выбор значения *Мессенджера* из выпадающего списка мессенджеров, через которые общались лиды в данном боте. * **Дата создания** - период, в котором были созданы диалоги лидов с данным ботом. Можно установить дату С и не ограничивать дату По, или наоборот. По умолчанию дата С - не установлена, дата По - текущая дата календаря; * **Последняя активность** - период, в котором была зарегистрирована последняя активность лидов с данным ботом. Можно установить дату С и не ограничивать дату ПО, или наоборот. По умолчанию период устанавливается последняя неделя. После установки параметров фильтрации нажать кнопку ***Применить фильтр***. Если необходимо сбросить все установленные фильтры, то нажать кнопку ***Сбросить фильтр***. ![](/files/-MaX_EId4ptomineH0rV) Если необходимо сбросить один какой-либо параметр фильтрации, оставив остальные, то надо нажать *крестик* на данном параметре и кнопку *Применить фильтр*. ![](/files/-MSWu9YZWW1TR861G_K7) Под наименование раздела Лиды указано количество лидов общее или по примененному в текущий момент фильтру. ![](/files/-MSWubzjqX2Bq8nilxBZ) ### Сортировка данных В разделе **Лиды** можно сортировать данные по следующим параметрам: * По возрастанию сортировка по дате создания диалога, вначале таблицы отображаются данные с последнего созданного диалога; * По убыванию сортировка по дате создания диалога, вначале таблицы отображаются данные с первого созданного диалога; * По возрастанию сортировка по дате последней активности лида, вначале таблицы отображаются данные с последнего диалога по дате активности; * По убыванию сортировка по дате последней активности, вначале таблицы отображаются данные с первого диалога по дате активности. Необходимо в поле *Сортировка* выбрать нужный параметр и нажать кнопку ***Применить фильтр*** ![](/files/-MSWv7RCuqLSuCSEDYda) Сортировка может применяться совместно к данным по примененным параметрам фильтрации. По умолчанию установлена обратная сортировка по дате создания диалогов. ### Функциональные возможности #### Экспорт / Импорт лидов Над списком *Лидов* возможно выполнение следующих функций: * *Экспорт* - при нажатии на ссылку формируется файл формата \*.csv; * *Экспорт в JSON* - при нажатии на ссылку экспортируется список лидов в формете json; * *Импорт из JSON* - при нажатии на ссылку импортируется список лидов из формата json; * *Сбросить все беседы* - при нажатии на ссылку происходит сброс бесед по всем лидам, взаимодействовавших с ботом. ![](/files/-MSX4rhDLMDEGgU0mHa2) #### Работа с сообщениями Для просмотра списка сообщений, которые были записаны при взаимодействии лида с ботом, необходимо нажать кнопку *Сообщения*. На значке показано общее количество сообщений с данным лидом. ![](/files/-MSX7b-cwQvsc45BWYhO) По умолчанию открывается список сообщений лида за последнюю неделю. На экранной форме также отображены все параметры по данной записи доступные для просмотра. ![](/files/-MSX8Scnej6XcSf6gr5S) Для того чтобы открыть весь список сообщений, необходимо сбросить период отбора и нажать кнопку *Применить фильтр.* ![](/files/-MSX9qo96hSZE_yUke1T) {% hint style="info" %} Для канала ***Telegram** и **Umnico*** имеется возможность напрямую отправить с платформы сообщение лиду. {% endhint %} Для этого необходимо нажать кнопку *Отправить сообщение*. ![](/files/-MSXBSFR6ZM0IeFfVKdg) Далее в открывшейся форме набрать текст, также можно добавить эмодзи и нажать кнопку *Отправить сообщение.* ![](/files/-MSXA_rnFpCQZwsUQGZL) #### Блокировка работы бота По одному любому выбранному Лиду бот можно остановить, нажав на кнопку *Отключение реакции бота на сообщения лида* в блоке **Операции.** ![](/files/3oc8ukolo04VlxnXLvKb) При активном положении данной кнопки у лида: * блокируются рассылки по лиду (лид не попадает в выборку лидов для рассылки, т.е. при планировании или запуске рассылки, по данному лиду не будет даже проверяться v8 условие); * если уже имеются какие-либо запланированные задания на выполнение по времени, то они будут отменены; * если лид самостоятельно в канале Telegram остановит работу бота, а далее ее возобновит через интерфейс мессенджера, то работа бота возобновится, а кнопка перейдет в положение "Отключено", как показано на рисунке выше. #### Отладка бота У лида можно настроить уровень отладки бота, для это необходимо воспользоваться кнопкой *Редактировать уровень отладки бота* в блоке **Операции**. ![](/files/WdT6X7iZf4tt2vvTRQtc) В диалоговом окне необходимо выбрать настройки уровня: * Выключено - параметр по умолчанию; * Только V8 (editor) - уровень editor можно выставлять любым пользователя бота; * V8 и Exceptions (admin) - уровень admin можно выставлять только администраторам платформы или проверенным разработчикам. ![](/files/3z78xkMl7Go9WpHPfFNI) При включенном уровне отладки бота будет выдаваться форматированное сообщение об ошибке V8 в боте. * на русском языке ![](/files/0dZ8diAsRd9cfq6isMJB) * на английском языке ![](/files/5L7o918gTNQQQamEcZCO) #### Сброс беседы Для того, чтоб лид вернулся в первоначальную точку беседы с ботом можно воспользоваться функцией сброса диалога по одному лиду, для это необходимо воспользоваться кнопкой *Сбросить беседу для этого лида* в блоке **Операции**. ![](/files/8R2c1PuBm3i1HAlULe4k) {% hint style="warning" %} Если всему боту требуется обновление, то можно воспользоваться командой **Сбросить все беседы**. {% endhint %} ### Редактирование карточки лида В разделе редактирования лида можно самостоятельно проставить теги, присвоить новый атрибут, поменять статус лида, присвоить статус или ответственного менеджера, а также установить язык или настроить интеграцию (если в боте их две и более), для этого необходимо воспользоваться кнопкой *Редактировать* в блоке **Операции**. ![](/files/6rnDV94I8nLS9Bmm1SlQ) В карточке лида имеется возможность редактирования активной интеграции. Для этого в выпадающем списке есть все NLP интеграции, в том числе и не активные. Это сделано для того, что могут установить интеграцию, а затем снять галку активности, в таком случае после сохранения на форме редактирования карточки было бы сброшено значение. ![](/files/-MaXYPookOAsfBHO6Mio) ![](/files/-MaXYbDVaCgp-xA-JTeN) После установки активной интеграции по лиду, она отображается в параметре *Активная NLP интеграция*. В параметре *nlpLastIntegrationCode* отображается код последней NLP интеграции, а в параметре *nlpLastIntegrationId* - ID последней NLP интеграции. ![](/files/-MaXYsPGwWx-aVDKanJ1)