> 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)**.** ![Раздел "Лиды"](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSWyxOa2w6Kq5QIEi1_%2F-MSX-1IQgs-yGAIlaIr4%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=df2378c1-0c55-44a0-935a-f547b52a3cde) В лиде на платформе сохраняются все параметры, которые он может приобрести во время общения с ботом. Один из примеров - теги и атрибуты пользователя — те данные, которые бот создает в ходе диалога. Также по каждому лиду платформы хранится вся история диалога, со всеми временными обозначениями. Диалог осуществляется с помощью обмена вебхуков, историю (лог) которых также можно просмотреть через лида, в целях проверки работы видимых или невидимых для пользователя команд бота. В соответствующем разделе на платформе размещается список пользователей - Лидов, которые взаимодействовали с ботом. По лиду производится сбор следующей информации: * **Клиент** - логин пользователя; * **Внешний ID;** * **Канал** - канал интеграции; * **Мессенджер** - при создании лида заполняется данными мессенджера по каналу интеграции; * **Менеджер -** закрепленный за пользователем менеджер; * **Статус** - действующий статус лида на данный момент времени; * **Атрибуты** - список атрибутов, сохраненных в базе, например: значения, тэги, контекст; * **Операции**: * Отключение / включение реакции бота на сообщения лида; * Сообщения- список всех сообщений данного пользователя с ботом; * Редактировать - форма редактирования реквизитов по выбранной строке списка лидов; * Сбросить беседу для этого лида. ### Фильтрация и поиск Фильтрация и поиск данных может производиться по следующим параметрам: * **Лид** - поиск по выпадающему списку всех лидов, взаимодействовавших с этим ботом; * **Тэг** - фильтр, выбор значения *Тэга* из выпадающего списка тэгов, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Переменная** - фильтр, выбор значения *Переменной* из выпадающего списка переменных, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Выключен** - фильтр по параметру включен или выключен бот для лида: * если ДА, то фильтруются лиды, для которых бот *выключен*; * если НЕТ, то фильтруются лиды, для которых бот *включен*. * **Канал** - фильтр, выбор значения *Канала* из выпадающего списка подключенных в данном боте каналов; * **NLP** - фильтр, выбор значения по Активной NLP интеграции из выпадающего списка; * **Статус** - фильтр, выбор значения *Статуса* из выпадающего списка статусов, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Контекст** - фильтр, выбор значения *Контекст* из выпадающего списка контекстных данных, которые были назначены лидам, взаимодействовавшим с этим ботом; * **Значение** - фильтр, выбор *Значения* из выпадающего списка значений, которые были присвоены лидам, взаимодействовавшим с этим ботом; * **Чат передан оператору** - фильтр по параметру передал ли диалог с лидом оператору: * если ДА, то фильтруются лиды, для которых диалог/чат передан оператору; * если НЕТ, то фильтруются лиды, для которых диалог/чат ведется ботом. * **Мессенджер** - фильтр, выбор значения *Мессенджера* из выпадающего списка мессенджеров, через которые общались лиды в данном боте. * **Дата создания** - период, в котором были созданы диалоги лидов с данным ботом. Можно установить дату С и не ограничивать дату По, или наоборот. По умолчанию дата С - не установлена, дата По - текущая дата календаря; * **Последняя активность** - период, в котором была зарегистрирована последняя активность лидов с данным ботом. Можно установить дату С и не ограничивать дату ПО, или наоборот. По умолчанию период устанавливается последняя неделя. После установки параметров фильтрации нажать кнопку ***Применить фильтр***. Если необходимо сбросить все установленные фильтры, то нажать кнопку ***Сбросить фильтр***. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MaXZgC57W7vG4WLWoqX%2F-MaX_EId4ptomineH0rV%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=b1583ed6-bf10-481c-9ca5-d575f88e3df0) Если необходимо сбросить один какой-либо параметр фильтрации, оставив остальные, то надо нажать *крестик* на данном параметре и кнопку *Применить фильтр*. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSWq4Aakl6uI-yGOsl4%2F-MSWu9YZWW1TR861G_K7%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=76be50a4-ab71-4be1-bead-f9699b416ab1) Под наименование раздела Лиды указано количество лидов общее или по примененному в текущий момент фильтру. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSWq4Aakl6uI-yGOsl4%2F-MSWubzjqX2Bq8nilxBZ%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=3e6797df-a2b3-415e-9d42-81bca1345839) ### Сортировка данных В разделе **Лиды** можно сортировать данные по следующим параметрам: * По возрастанию сортировка по дате создания диалога, вначале таблицы отображаются данные с последнего созданного диалога; * По убыванию сортировка по дате создания диалога, вначале таблицы отображаются данные с первого созданного диалога; * По возрастанию сортировка по дате последней активности лида, вначале таблицы отображаются данные с последнего диалога по дате активности; * По убыванию сортировка по дате последней активности, вначале таблицы отображаются данные с первого диалога по дате активности. Необходимо в поле *Сортировка* выбрать нужный параметр и нажать кнопку ***Применить фильтр*** ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSWq4Aakl6uI-yGOsl4%2F-MSWv7RCuqLSuCSEDYda%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=cd6ed000-77e2-4944-bd11-42fe15afa0de) Сортировка может применяться совместно к данным по примененным параметрам фильтрации. По умолчанию установлена обратная сортировка по дате создания диалогов. ### Функциональные возможности #### Экспорт / Импорт лидов Над списком *Лидов* возможно выполнение следующих функций: * *Экспорт* - при нажатии на ссылку формируется файл формата \*.csv; * *Экспорт в JSON* - при нажатии на ссылку экспортируется список лидов в формете json; * *Импорт из JSON* - при нажатии на ссылку импортируется список лидов из формата json; * *Сбросить все беседы* - при нажатии на ссылку происходит сброс бесед по всем лидам, взаимодействовавших с ботом. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSX3JGMYBvxtO3D-avc%2F-MSX4rhDLMDEGgU0mHa2%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=97039736-028d-42ec-9e39-eb4f81963fc6) #### Работа с сообщениями Для просмотра списка сообщений, которые были записаны при взаимодействии лида с ботом, необходимо нажать кнопку *Сообщения*. На значке показано общее количество сообщений с данным лидом. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSX60eNHBBuhKS50afe%2F-MSX7b-cwQvsc45BWYhO%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=f8e6004d-3fe9-4661-8bf1-42155f73dcac) По умолчанию открывается список сообщений лида за последнюю неделю. На экранной форме также отображены все параметры по данной записи доступные для просмотра. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSX60eNHBBuhKS50afe%2F-MSX8Scnej6XcSf6gr5S%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=fd72550a-a9ba-4401-af18-314b282c9ea7) Для того чтобы открыть весь список сообщений, необходимо сбросить период отбора и нажать кнопку *Применить фильтр.* ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSX60eNHBBuhKS50afe%2F-MSX9qo96hSZE_yUke1T%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=4ee97b9b-be6b-4abf-8e14-779d33f1739f) {% hint style="info" %} Для канала ***Telegram** и **Umnico*** имеется возможность напрямую отправить с платформы сообщение лиду. {% endhint %} Для этого необходимо нажать кнопку *Отправить сообщение*. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSX60eNHBBuhKS50afe%2F-MSXBSFR6ZM0IeFfVKdg%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=b36e2cb3-398d-45b6-b8a3-48991e2cd413) Далее в открывшейся форме набрать текст, также можно добавить эмодзи и нажать кнопку *Отправить сообщение.* ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MSX60eNHBBuhKS50afe%2F-MSXA_rnFpCQZwsUQGZL%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=b8d63c18-b107-4c5e-bc5a-57384838f9e7) #### Блокировка работы бота По одному любому выбранному Лиду бот можно остановить, нажав на кнопку *Отключение реакции бота на сообщения лида* в блоке **Операции.** ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2Fv1yqncR8CLvBU7gtv9WS%2Fimage.png?alt=media\&token=c319ee51-e947-496e-ad92-63d8d0454357) При активном положении данной кнопки у лида: * блокируются рассылки по лиду (лид не попадает в выборку лидов для рассылки, т.е. при планировании или запуске рассылки, по данному лиду не будет даже проверяться v8 условие); * если уже имеются какие-либо запланированные задания на выполнение по времени, то они будут отменены; * если лид самостоятельно в канале Telegram остановит работу бота, а далее ее возобновит через интерфейс мессенджера, то работа бота возобновится, а кнопка перейдет в положение "Отключено", как показано на рисунке выше. #### Отладка бота У лида можно настроить уровень отладки бота, для это необходимо воспользоваться кнопкой *Редактировать уровень отладки бота* в блоке **Операции**. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2FzerfdROVkhVcu4LkGaOj%2Fimage.png?alt=media\&token=450aea65-87af-4df9-a379-b6b199862857) В диалоговом окне необходимо выбрать настройки уровня: * Выключено - параметр по умолчанию; * Только V8 (editor) - уровень editor можно выставлять любым пользователя бота; * V8 и Exceptions (admin) - уровень admin можно выставлять только администраторам платформы или проверенным разработчикам. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2FXKHs8OaEnW9vQ3ubyCME%2Fimage.png?alt=media\&token=b179cb1d-504d-4f1f-b930-788baf92ba1e) При включенном уровне отладки бота будет выдаваться форматированное сообщение об ошибке V8 в боте. * на русском языке ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2FlUc6EyV4xfhVkEnCpE6p%2Fimage.png?alt=media\&token=5fb50ebd-b43c-48d8-9298-003cd98b0059) * на английском языке ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2FmtFSuvKV6Xp4GWB9DmrB%2Fimage.png?alt=media\&token=cf4ac660-ca1b-4020-b3d5-5498031f69c6) #### Сброс беседы Для того, чтоб лид вернулся в первоначальную точку беседы с ботом можно воспользоваться функцией сброса диалога по одному лиду, для это необходимо воспользоваться кнопкой *Сбросить беседу для этого лида* в блоке **Операции**. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2FhU9vu0lwnpan3iKaFRqr%2Fimage.png?alt=media\&token=82cbdd75-b0c3-45f2-8ddc-2c5884f261a1) {% hint style="warning" %} Если всему боту требуется обновление, то можно воспользоваться командой **Сбросить все беседы**. {% endhint %} ### Редактирование карточки лида В разделе редактирования лида можно самостоятельно проставить теги, присвоить новый атрибут, поменять статус лида, присвоить статус или ответственного менеджера, а также установить язык или настроить интеграцию (если в боте их две и более), для этого необходимо воспользоваться кнопкой *Редактировать* в блоке **Операции**. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lof4a3yX4z_pjUWqMhw%2Fuploads%2F3urvlulYbAMdYFkqXBY3%2Fimage.png?alt=media\&token=a48ca20b-e41b-44ac-81b3-b566914807ea) В карточке лида имеется возможность редактирования активной интеграции. Для этого в выпадающем списке есть все NLP интеграции, в том числе и не активные. Это сделано для того, что могут установить интеграцию, а затем снять галку активности, в таком случае после сохранения на форме редактирования карточки было бы сброшено значение. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MaXTNNqpmPO405AUk_G%2F-MaXYPookOAsfBHO6Mio%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=f4ae9da3-0e21-4d5b-970e-b26c3e055355) ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MaXTNNqpmPO405AUk_G%2F-MaXYbDVaCgp-xA-JTeN%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=3627f151-a58f-4338-98ad-466806c7b434) После установки активной интеграции по лиду, она отображается в параметре *Активная NLP интеграция*. В параметре *nlpLastIntegrationCode* отображается код последней NLP интеграции, а в параметре *nlpLastIntegrationId* - ID последней NLP интеграции. ![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MaXTNNqpmPO405AUk_G%2F-MaXYsPGwWx-aVDKanJ1%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=78fa8b36-448f-4515-ac4b-d89da8a5259c)