Кабинет администратора ботов

Скрипты, рассылки, триггеры, каналы, интеграции, cтатусы, маршруты, лиды, статистика, атрибуты, cсылки

Бизнесы

На одном сервере Metabot одновременно могут работать несколько компаний или организаций. Для каждого заказчика или нового пользователя создается свой Бизнес — автоматически при регистрации.

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

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

image.png

Существуют следующие роли: 

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

Некоторые структурные возможности такие, как тикет-система в разделе Заявок и Интернет-Магазин в одноименном разделе на данный момент настраиваются только на уровне бизнеса.

Главная страница бизнеса

На главной странице бизнеса отображаются все боты бизнеса:

image.png

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

Для каждого бота также доступны следующие операции:

Выбрать бота на главной странице бизнеса можно и из выпадающего списка в верхней части страницы.

image.png

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

На главной странице доступны следующие функции:

Импорт.png

Настройки бота

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

image.png

image.png

Экспорт бота

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

Кнопки экспорта находятся на главной странице бизнеса. Существует два варианта экспорта:

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

Экспорт.png

При переходе по кнопкам открывается окно настроек экспорта со следующими полями:

image.png

image.png

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

image.png

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

После нажатия на кнопку Экспорт все указанные данные предоставляются в JSON формате.

image.png

Если у пользователя бота есть роль bots_merger, ему будут доступны следующие дополнительные поля:

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

Импорт бота

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

Кнопка Импорт бизнеса/ботов находится на главной странице бизнеса.

Импорт.png

При переходе по кнопке открывается окно настроек импорта со следующими полями:

image.png

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

Максимальный размер импортируемого JSON файла = 20 Мб.

В верхней части окна указано предупреждение о выполняемых действиях: в какой бизнес происходит импорт и куда будут добавлены данные по ботам.

image.png

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

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

Если у пользователя бота есть роль bots_merger, ему будут доступны следующие дополнительные поля:

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

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

Подходит для слияния данных (например, для переноса новой версии бота или данных по бизнесу);

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

Ниже приведена таблица слияния — по каким полям выполняется поиск сущностей в БД для того, чтобы определить есть сущность и нужно ли ее обновлять или добавлять.

Сущность Поле
Данные по ботам
Настройки бота Код
Интеграции  Наименование
Статусы лидов Наименование
Маршруты  Код
Ссылки Наименование
Рассылки  Код
Внутреннее API (Конечные точки) Алиас
Внешнее API (Конечные точки) Код
Системные атрибуты бота По типу и наименованию
Скрипты, команды и меню
Разделы скриптов Наименование
Скрипты  Код
Команды скрипта Алиас (в рамках импортируемого бота и скрипта)
Пункты меню Алиас (в рамках импортируемого бота и скрипта)
Триггеры
Триггеры Код
События на которые подписан триггер По виду события
Привязка триггера к ссылке По наименованию ссылки
Данные по бизнесу
Роли персон Имя
Персоны  guid
Заявки  guid
Виды заявок Наименование
Статусы заявок Наименование
Произвольные поля заявок Наименование
Привязки произвольных полей заявок к видам заявок По виду заявки и наименованию поля
Плагины бизнеса
Плагины  Наименование
Скрипты плагина Наименование
Кастомные таблицы
Параметры таблицы Наименование
Поля таблицы Наименование
Данные  ID каждой записи

Лиды


Меню лидов — это список конечных клиентов или пользователей взаимодействовавших с ботом.

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

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

Снимок экрана 2024-01-31 143251.png

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

В соответствующем разделе на платформе размещается список пользователей — лидов, которые взаимодействовали с ботом. По лиду производится сбор следующей информации:

image.png

Фильтрация и поиск

Фильтрация и поиск данных может производиться по следующим параметрам:

  • Лид — поиск по выпадающему списку всех лидов, взаимодействовавших с этим ботом;
  • Есть все тэги — проверяет наличие ВСЕХ написанных тегов;
  • Есть любой тэг — проверяет наличие ОДНОГО из написанных тегов;
  • Нет всех тэгов — проверяет отсутствие ВСЕХ написанных тегов;
  • Нет любого тэга — проверяет отсутствие ОДНОГО из написанных тегов;
  • Переменная — фильтр, выбор значения переменной из выпадающего списка переменных, которые были назначены лидам, взаимодействовавшим с этим ботом;
  • Бот выключен — фильтр по параметру включен или выключен бот для лида:
    • Если ДА, то фильтруются лиды, для которых бот выключен;
    • Если НЕТ, то фильтруются лиды, для которых бот включен;
  • Канал — фильтр, выбор значения Канала из выпадающего списка подключенных в данном боте каналов;
  • NLP — фильтр, выбор значения по Активной NLP интеграции из выпадающего списка;
  • Статус — фильтр, выбор значения Статуса из выпадающего списка статусов, которые были назначены лидам, взаимодействовавшим с этим ботом;
  • Контекст — фильтр, выбор значения Контекст из выпадающего списка контекстных данных, которые были назначены лидам, взаимодействовавшим с этим ботом;
  • Значение — фильтр, ввод Значения переменных, которые могли быть присвоены лидам, взаимодействовавшим с этим ботом;
  • Передан оператору — фильтр по параметру передал ли диалог с лидом оператору:
    • Если ДА, то фильтруются лиды, для которых диалог/чат передан оператору;
    • Если НЕТ, то фильтруются лиды, для которых диалог/чат ведется ботом;
  • Мессенджер — фильтр, выбор значения Мессенджера из выпадающего списка мессенджеров, через которые общались лиды в данном боте.
  • Дата создания — период, в котором были созданы диалоги лидов с данным ботом. Можно установить дату С и не ограничивать дату По, или наоборот. По умолчанию дата С — не установлена, дата По — текущая дата календаря;
  • Последняя активность — период, в котором была зарегистрирована последняя активность лидов с данным ботом. Можно установить дату С и не ограничивать дату ПО, или наоборот. По умолчанию период устанавливается последняя неделя.

После установки параметров фильтрации нажать кнопку Применить фильтр.

Если необходимо сбросить все установленные фильтры, то нажать кнопку Сбросить фильтр.

image.png

Если необходимо сбросить один какой-либо параметр фильтрации, оставив остальные, то надо нажать крестик на данном параметре и кнопку Применить фильтр.

Снимок экрана 2024-06-25 152327.png

Под наименование раздела Лиды указано количество лидов общее или по примененному в текущий момент фильтру.

image.png

Сортировка данных

В разделе Лиды можно сортировать данные по следующим параметрам:

Необходимо в поле Сортировка выбрать нужный параметр и нажать кнопку Применить фильтр

image.png

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

Функциональные возможности

Экспорт / Импорт лидов

Над списком лидов возможно выполнение следующих функций:

image.png

При нажатии на Экспорт (в CSV) на странице лидов открывается форма с параметрами экспорта:

image.png

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

Порядок работы с формой:

  1. Выбираем Все атрибуты или Указанные атрибуты.
  2. Если выбрали Указанные, то задаем список атрибутов через запятую.
  3. Выбираем Все записи или Разбивка по страницам.
  4. Если выбрали Разбивка, то указываем размер страницы.
  5. Нажимаем Сгенерировать ссылки.
  6. Скачиваем все csv по сгенерированным ссылкам.

После смены параметров формы не забудьте повторно нажать на кнопку Сгенерировать ссылки, иначе на форме останутся старые ссылки!

Работа с сообщениями

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

image.png

По умолчанию открывается список сообщений лида за последнюю неделю. На экранной форме также отображены все параметры по данной записи доступные для просмотра.

image.png

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

image.png

Для канала Telegram, VK и Umnico имеется возможность напрямую отправить с платформы сообщение лиду.

Для этого необходимо нажать кнопку Отправить сообщение.

image.png

Далее в открывшейся форме набрать текст, также можно добавить эмодзи и нажать кнопку Отправить сообщение.

image.png


Блокировка работы бота

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

image.png

При активном положении данной кнопки у лида:

Отладка бота

У лида можно настроить уровень отладки бота, для это необходимо воспользоваться кнопкой Редактировать уровень отладки бота в блоке Операции.

image.png

В диалоговом окне необходимо выбрать настройки уровня:

image.png

При включенном уровне отладки бота будет выдаваться форматированное сообщение об ошибке V8 в боте.

На русском языке:

image.png

На английском языке:

image.png

Сброс беседы

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

image.png

Если всему боту требуется обновление, то можно воспользоваться командой Сбросить все беседы.

Редактирование карточки лида

В разделе редактирования лида можно самостоятельно проставить теги, присвоить новый атрибут, поменять статус лида, присвоить статус или ответственного менеджера, а также установить язык или настроить интеграцию (если в боте их две и более), для этого необходимо воспользоваться кнопкой Редактировать в блоке Операции.

image.png

В карточке лида имеется возможность редактирования активной интеграции.

image.png

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

image.png

После установки активной интеграции по лиду, она отображается в параметре Активная NLP интеграция.

В параметре nlpLastIntegrationCode отображается код последней NLP интеграции, а в параметре nlpLastIntegrationId — ID последней NLP интеграции.

image.png

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

Скрипты

Скрипты — это элементы сценария взаимодействия бота с пользователем.

Первый и самый важный шаг в дизайне ботов — это создание диалоговых скриптов, которые связаны между собой. Можно переходить от одного разговора к другому, создавая автоматизированный поток.

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

На экранной форме нажать кнопку Создать скрипт.

image.png

При создании  нового скрипта необходимо заполнить следующие параметры:

Рекомендуем также ознакомиться со страницей Разделы скриптов.

Скрипт, имеющий тип Fallback используется с командами: Отправить текст и Повторить вопрос.

Скрипт, имеющий тип Fallback в чат-боте применяется один раз!

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

Включить обнаружение NLP Action при обнаружении NLP намерения позволяет в запущенном скрипте начать поиск нового намерения. Опция действует только если включено обнаружение намерения NLP. 

image.png

При наведении на иконку справки показывается более точная информация. 

image.png

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

В разделе Скрипты располагается список скриптов данного бота с доступными операциями:

image.png

Со скриптами так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в Справочнике по функциям JS.

Разделы скриптов

Разделы скриптов предназначены  для группировки скриптов по смысловой принадлежности.

Этой функцией можно воспользоваться для удобства визуализации списка скриптов на экране.

Для этого на экранной форме нужно нажать кнопку Создать раздел.

image.png

При создании  нового раздела скриптов необходимо заполнить название раздела, например, "Скрипты меню" и нажать кнопку Создать.

image.png


На экранной форме расположения всех скриптов бота Разделы визуально выделяются серой полосой.

image.png


Для разделов скриптов доступны следующие операции:

Снимок экрана 2024-02-05 123004.png

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

  1. Зайти в свойства скрипта. 

    image.png

  2. Поменять раздел. 

    image.png

  3. Сохранить.

Редактор скрипта

Редактор скрипта — это форма для наполнения скрипта различными командами и пунктами меню.

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

image.png


Наполняя скрипт командами, вы создаете разговорный сценарий, а именно:


А так же используя платформу вы сможете:

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

Экранная форма редактора скрипта состоит из двух блоков:

​Команды выполняются последовательно, сверху вниз, когда для пользователя запускается диалог.

Ветвление в разговорах помогает отправлять пользователей по разным путям в зависимости от определенных условий.

Параметры скрипта можно менять не выходя из него вверху страницы.

image.png



Создание Меню

Меню скрипта — способ взаимодействия пользователя с ботом в виде настроенных пунктов меню.

В начале настройки бота необходимо создать главное меню бота. Для создания Меню необходимо перейти в раздел главного меню Настройки бота подраздел Скрипты.

Для этого необходимо:

  1. На экранной форме нажать кнопку Создать новый скрипт.image.png
  2. Указать название скрипта — "Меню", нажать кнопку Создать, оставив остальные параметры без изменения.image.png
  3. Перейти в редактирование скрипта по одноименной операции в правой части строки.

    image.png

  4. Создание пунктов меню производится в блоке Меню. Нажать кнопку Добавить пункт меню.

    image.png

  5. При создании  нового пункта меню необходимо заполнить следующие параметры:

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

    6. Нажать кнопку Создать

image.png

Например, меню будет содержать 4 пункта:

Так оно будет выглядеть в скрипте Меню:

image.png

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

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

Скрипт Меню должен быть добавлен в первоначальный скрипт разговора с командой Выполнить скрипт.

image.png

Дерево скриптов

Дерево скриптов — это удобная визуализация списка скриптов.

Для упрощения навигации в скриптах бота на платформе реализована удобная визуализация списка скриптов в виде дерева. Для ее использования, необходимо в списке скриптов перейди по гиперссылке Отобразить скрипты в виде дерева скриптов.

image.png

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

image.png

Маршруты

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

Маршруты — это начальная точка взаимодействия бота и пользователя при получении очередного сообщения пользователя ботом. Маршруты позволяют настроить условия запуска созданных скриптов. ​

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

Если не найден ни один маршрут, то выполняется резервный скрипт с типом Fallback.

Маршруты необходимо создавать в разделе главного меню Настройки бота подраздел Маршруты.

На экранной форме следует нажать кнопку Создать маршрут.

image.png

При создании  нового маршрута необходимо заполнить следующие параметры:

Как составить свое произвольное регулярное выражение можно узнать на странице Регулярные выражения.

image.png

В регулярном выражении есть возможность указания флагов маршрута в формате:

рег_выражение:FLAGS[список флагов через запятую]

Регулярное выражение можно не указывать, тогда запись будет выглядеть так :FLAGS[список флагов через запятую]

Например:

.*:FLAGS[EMPTY,NO_RUN]

Доступные флаги:

Данный функционал используется при работе с геолокацией.

В разделе Маршруты располагается список маршрутов данного бота с доступными операциями:

image.png

Маршруты разделены на 2 группы:

Каждая группа маршрутов обладает своей сортировкой. Сортировка влияет на порядок поиска (и запуска) маршрута. Запускается только первый маршрут подходящий под все условия отбора. Если маршрут найден, то очищается беседа и запускается скрипт указанный в маршруте.

Убедитесь, что в стартовом маршруте НЕ проставлена галочка в пункте Действует в диалоге.

Для всех маршрутов с диплинками считается, что у них включена опция Действует в диалоге. Даже если эта опция отключена, при обработке маршрута с диплинком считается, что она включена.

Даже если случайно сбросим эту опция в базе данных, то на логику это не повлияет.

Более подробно как опция на логику: если включена опция Обработка Deep Link, то после сохранения маршрута (редактирование/создание), на бэке будет автоматически установлена опция Действует в диалоге.

Каналы

Раздел Каналы служит для привязки созданного бота к каналам связи. 

Каналы необходимо создавать в разделе главного меню Настройки бота подраздел Каналы.

На экранной форме нажать кнопку Новая привязка.

image.png

При создании  нового привязки бота к каналу  необходимо заполнить следующие параметры:

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

Атрибуты

Атрибуты — раздел просмотра сохраненных атрибутов для пользователей, взаимодействовавших с ботом.

В раздел Атрибуты можно перейти по одноименной кнопке из панели управления раздела Настройки бота выбрать пункт меню Атрибуты.

image.png

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

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

Доступность операций над списком (редактировать, удалить) назначается с учетом полномочий в зависимости от Роли, назначенной на учетную запись.
  • Если у пользователя платформой назначена роль — Editor (это администратор бизнеса), то ему доступны операции Редактирования и Удаления атрибутов;
  • Если у пользователя платформой назначена роль — Viewer, то ему доступен только просмотр данного списка.
Редактировать атрибут можно, перейдя по кнопке Редактировать атрибут по строке соответствующей записи.

image.png

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

image.png

Для поиска атрибутов доступны фильтры:

image.png

С атрибутами так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в Справочнике по функциям JS

 

Триггеры

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

Триггеры можно создавать в разделе главного меню Настройки бота подраздел Триггеры

image.png

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

image.png

Пример

image.png

image.png

Создадим триггер без подписки на событие, для этого заполним следующие параметры:

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

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

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

Для запуска могут быть указаны как Скрипт, так и Триггер одновременно.

image.png

Параметр Запустить указанный Скрипт/Триггер через (минут) игнорируется, если указано точное время запуска, т.е. если указан параметр Запустить указанный Скрипт/Триггер в.

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

Если поле JS условия пусто, то оно всегда истинно при проверке.

После заполнения параметров следует нажать кнопку Создать.

image.png

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

image.png

На экранной форме в разделе Триггеры будет располагаться список созданных триггеров для данного бота.

image.png

Этапы запуска и установки триггера:

В разделе Триггеры располагается список созданных триггеров для данного бота с доступными операциями:

image.png

С триггерами так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в Справочнике по функциям JS

Рассылки

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

Раздел Рассылки служит для создания рассылок по заданному условию для списка подписчиков.

Рассылки необходимо создавать в разделе главного меню Настройки бота подраздел Рассылки.

На экранной форме нажать кнопку Новая рассылка.

image.png

При создании новой рассылки необходимо заполнить следующие параметры:

После заполнения параметров следует нажать кнопку Создать.

image.png

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

image.png

В данном разделе размещается список рассылок с доступными операциями по ним:

image.png

image.png

После выполненной рассылки в Списке лидов отображается общее количество лидов, на которых была отправлена рассылка.

image.png

При переходе по ссылке Лиды открывается список лидов, которым была отправлена рассылка.

image.png

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

Статусы

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

При создании бота необходимо создать минимальный набор статусов:

  1. В разделе Настройки бота выбрать пункт меню Статусы;
  2. На экранной форме находятся две кнопки:
    • Создать — список статусов, созданный пользователем, при конфигурировании бота;
    • Синхронизировать — данная функция используется при интеграции бота с CRM-системами. В CRM-системах есть свой список статусов, который должен быть синхронизирован в Metabot24.

Синхронизация статусов нужна, чтобы связать между собой статусы в Umnico со статусами в вашем боте на платформе Metabot24. После установки связки напротив каждого статуса появится Внешний ID (т.е. идентификатор статуса в системе Umnico), что означает что связь статусов произошла. Теперь вы сможете менять статус заявок в Umnico из бота, выполняя команду Изменить статус лида в скриптах.

image.png

Для корректной работы бота необходимо создать как минимум один статус — Первичное касание:

  1. Нажать на кнопку Создать;
  2. Указать название статуса, например, Первичное касание;
  3. Нажать на форме кнопку Создать.

После настройки интеграции канала, например Uminco или Битрикс24 , необходимо выполнить синхронизацию статусов:

image.png

Синхронизация завершена успешно, если в списке Статусов появятся записи с заполненным полем Внешний ID, которое является идентификатором статуса в Umnico.

image.png

Как только проведена синхронизация платформы Metabot с Umnico, то появляется возможность из Metabot управлять статусами в Umnico.

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

image.png

Со статусами так же можно работать с помощью JS методов. Все методы и их описание вы можете посмотреть в Справочнике по функциям JS

Интеграции


Раздел Интеграции служит для привязки созданного бота к сторонним сервисам. 

Интеграции необходимо создавать в разделе главного меню Настройки бота подраздел Интеграции.

Для этого на экранной форме нажмите кнопку Новая привязка.

image.png

В диалоговом окне заполните следующие параметры:

Затем следует нажать кнопку Создать.

image.png

В разделе Интеграции с ботом располагается список всех настроенных интеграционных привязок для данного бота с доступными операциями: 

image.png


Статистика

Статистика — раздел для контроля за накопленной статистикой за период времени.

В раздел Статистика можно перейти по одноименной кнопке, которую можно найти в выпадающем списке Аналитика в верхнем меню бота, или из панели управления раздела Настройки бота выбрать пункт меню Статистика.

статистика.png

На экранной форме можно увидеть какой на текущий момент у него Тариф, общее количество Активных лидов и сколько лидов разрешено по тарифу.

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

В подпункте Лиды и сообщения можно посмотреть статистику отдельно по всем ботам и по бизнесу. В таблице указаны:

В подпункте Активности можно посмотреть статистику заданий и вебхуков всего бизнеса.  В таблице указаны:

Кастомные отчеты

Функционал Кастомных отчетов позволяет создавать настраиваемые отчеты со статистикой лидов и активностей.

В меню Кастомных отчетов можно перейти по пункту Отчеты из выпадающего списка Аналитика.

отчеты.png

В открывшемся меню доступен выпадающий список в котором можно выбрать один из трех видов отчетов:

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

Активности: Превышение лимитов по всем бизнесам

При выборе вида отчета Активности: Превышение лимитов по всем бизнесам, на странице появятся следующие поля и кнопки:

image.png

В сформированном отчете отображаются следующие данные:

Лиды

При выборе вида отчета Лиды, на странице появятся следующие поля и кнопки:

image.png

В сформированном отчете отображаются следующие данные:

Активности: Все бизнесы

При выборе вида отчета Активности: Все бизнесы, на странице появятся следующие поля и кнопки:

image.png

В сформированном отчете отображаются следующие данные:

Ссылки

В Metabot есть три вида ссылок: пользовательские ссылки, ссылки для магазина в боте и deep link. С помощью создания пользовательских ссылок вы сможете отслеживать статистику переходов по ним, а при помощи deep link создавать новые точки входа в бота.

О ссылках для магазина вы можете подробнее узнать из раздела Магазин в боте

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

 

Для создания ссылки следует на экранной форме нажать кнопку Создать.

ссылки.png

Откроется окно Создания ссылки со следующими параметрами:

image.png

После нажатия на кнопку Создать ссылка появится в таблице:

ссылки.png

Здесь отображается вся информация о ссылке, макропеременная для вызова ссылки (1), привязанные к ней триггеры (2) и информация о них, а так же статистика (3) лидов, взаимодействовавших с ссылкой и общее число переходов.

Теперь макропеременную ссылки можно добавить в любом месте бота с помощью команды Отправить текст

image.png

Deep Linking

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

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

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

Примеры внешнего связывания с вещами в физическом мире:

В каждом случае пользователь при открытии deep link попадет в чат-бот и активирует определенный сценарий, уникальный для этой конкретной ссылки. Через deep link в чат-бот можно передать параметры, например, токен заказа или идентификатор страницы, с которой совершен переход.

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

 Что такое каналы и как их настраивать можно узнать в разделе Каналы

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

image.png

В меню создания ссылок будут храниться все настроенные вами диплинки и ссылки других типов. Создание новой ссылки производится любой из кнопок Создать.

Снимок экрана 2023-03-01 113714.png

Перед вами откроется диалоговое окно со следующими полями:

image.png

После нажатия кнопки Создать диплинк появится в меню ссылок:

image.png

Последним этапом является добавление маршрута привязанного к диплинку.

Что такое маршруты и как их создавать вы можете узнать в разделе Маршруты

Особенности создания маршрута с диплинком:

image.png

Именно этот маршрут будет активирован при переходе пользователя по диплинку.

Использование deep link

Внешние мессенджеры

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

В ссылке для Telegram бота — ( https://app.metabot24.com/deeplink/telegram/{имя-бота-telegram}/... ) {имя-бота-telegram} — следует заменить на соответствующий ID бота в мессенджере.

В ссылке для WhatsApp бота — ( https://app.metabot24.com/deeplink/whatsapp/{телефон-whatsapp}/... ) {телефон-whatsapp} — следует заменить на номер телефона в формате 79ххххххххх соответствующий боту.

После подстановки ссылку с данным URL можно размещать в интернете. При необходимости к ней можно добавить параметры, как это стандартно делается для http-ссылок.

image.png

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

Для использования полученных из диплинка параметров можно воспользоваться следующим кодом:

let jsonD = lead.getJsonAttr('sys_last_script_request_params');
let foo = jsonD.deeplink.foo;
let boom = jsonD.deeplink.boom;

lead.setAttr("foo", foo);
lead.setAttr("boom", boom);