Редактор блока

Основные поля Редактора блока:

• Верхняя строка редактора блока

• Вкладка "Сообщение"

• Вкладка "API - запрос"

• Вкладка "Калькулятор"

• Вкладка "Действие"

• Вкладка "Кнопки"

• Вкладка "Вложения"

• Вкладка "Аналитика"

Последовательность исполнения полей Редактора блока

1. Калькулятор, сверху вниз построчно.

2. API-запрос и отправка вебхука.

3. Кнопки

4. Отправка текста из поля Сообщение.

Форма редактора блока

Редактор блока по умолчанию открыт при переходе в конструктор воронок:

Если создать (добавить) все необходимые настройки блока, выбрав его тип в том числе, и кликнуть по кнопке "Сохранить", то блок будет создан в поле воронки:

Созданный блок:

Если нужно открыть настройки определенного блока, то кликните по нужному блоку:

После нажатия на блок, откроются его настройки:

На рисунке 1 представлена форма Редактора блока. По умолчанию она представлена в свернутом виде.

Чтобы развернуть полный вид формы, необходимо нажать на "Вложение", "Кнопки", "Действия", "Калькулятор" и/или "API -запрос" в зависимости от того, что хотите добавить (настроить) в блоке:

Тогда форма приобретет следующий вид:

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

Начнем с главных полей, знание которых ОБЯЗАТЕЛЬНО при работе с редактором.

Верхняя строка редактора блока

В верхней строке редактора блока расположено несколько полей:

1. Тип блока

1. Название блока (Описание)

1. Уникальный номер блока

Чтобы скопировать номер блока (ID блока) достаточно кликнуть по номеру блока.

1. Меню дополнительных команд

1. Генерация текста искусственным интеллектом

Поле: Тип блока

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

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

Поле: Название блока (Описание)

Описание: в это поле можно задать краткое описание назначения блока. Полезно для структурирования логики бота, поможет не запутаться, если работаете над сложным проектом с большим количеством блоков. По умолчанию текст берется из поля "Текст сообщения". На работу бота данное поле не влияет.

По умолчанию в названии блока лежит наименование его типа:

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

Поле: Меню дополнительных команд (три точки)

В данном разделе находятся дополнительные команды:

• Создать петлю

Петля - стрелка, которая возвращает пользователя в тот же блок.

Пример использования петли при получении номера телефона пользователя. От блока "Введи номер телефона идут две стрелки: стрелка со сбором данных к блоку "Твой номер... " и стрелка с пустым условием к блоку "Попробуй еще раз". В стрелке со сбором данных в поле Условие указываем регулярное выражение - условие, с помощью которого бот может проверять формат введенных данных: пользователь ввел именно номер телефона или что-то иное. Если пользователь ввел НЕ номер телефона, то ему придёт сообщение из блока "Попробуй ещё раз". У данного блока создана петля. Каждый раз, когда пользователь вводит НЕ номер телефона, он будет возвращаться в блок " Попробуй еще раз". До тех пор пока не введет номер телефона и не перейдет в блок по стрелке со сбором данных с регулярным выражением в блок "Твой номер..."

• Создать блок ниже

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

• Пересчитать статистику

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

• Создать рассылку

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

После выбора типа рассылки ( в мессенджеры или E-mail) откроется форма рассылки. При таком способе создания рассылки текст сообщения, вложения и другие настройки берутся из блока, в котором вызвали команду Создать рассылку:

1) Переход в настройки рассылки при клике на кнопку "Рассылка в мессенджеры"

2) Вкладка "Сообщение" в настройках рассылки

Пример: Отправить пользователей в другой блок

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

Шаг 1. Копируем ID блока, ИЗ которого нужно "забрать" клиентов. Открываем редактор блока - верхняя строка - кликнуть по номеру блока.

Шаг 2. Запустить создание рассылки в блоке, В КОТОРЫЙ необходимо переместить клиентов. Открываем редактор блока КУДА надо переместить клиентов. Верхняя строка редактора -Три точки (Меню дополнительных команд)(1) - Создать рассылку (2)- Рассылка в мессенджеры (3)

Шаг 3. Создание рассылки, заполнение раздела Получатели в форме рассылки. В форме создания рассылки в разделе Получатели отфильтровать по номеру блока ОТКУДА "забираем клиента (получили в шаге 1).

Выберите блок. Перед отправкой пересчитайте количество получателей рассылки. Всё содержание рассылки будет автоматически добавлено из блока, в который пользователи будет переведены данной рассылкой. Шаг 4. Отправить рассылку. После успешной отправки рассылки можно нажать Пересчитать статистику в блоке.

Видео-обзор "Меню блока"

Вкладка: Условие

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

Поле: Условие и поле Выбор соответствия

Подробно изучить тему Условия и выбор соответствия можно в этой статье.

Поле: Переменная для сравнения

В данном поле выполняем сравнение значения переменной с проверяемым значением.

Подробно тему Сравнения переменных можно изучить в этой статье.

Расширенные настройки вкладки Условие

В расширенных настройках проверки условия находится поле Строки, на которые не отвечать, Приоритет и ползунок "Отвечать один раз"

Поле: Строки, на которые не надо отвечать

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

Поле: Приоритет

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

Переключатель: Отвечать один раз

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

Переключатель: Срабатывать только на Callback

Данный переключатель есть только в блоках с условием в Расширенных настройках блока.

Если переключатель ВКЛЮЧЕН, то блок с условием будет срабатывать только на полученный callback в диалоге с клиентом.

Если переключатель ОТКЛЮЧЕН, блоки с условием срабатывают по настройкам поля Условие

Вкладка: Сообщение

Поле: Текст сообщения (Ответ)

Ответ - это поле, где вы указываете текст, который придет пользователю в личных сообщениях. Поле можно оставить пустым ( по умолчанию установлено #{none} - проигнорировать сообщение): например, вам нужно прислать просто картинку без сопроводительного текста. Также помимо текста можно указывать переменные в виде #{переменная} — так будет выводиться их значение. Допускается вместо переменной записывать математические действия, например, #{2 + 2} выведет значение 4.

Генерация текста сообщения ИИ

В поле можно генерировать сообщения с помощью искусственного интеллекта:

Кликнув по кнопке, откроется окно модальной формы для генерации текста сообщения:

В пустом поле пропишите, какой именно текст вам нужен, а затем кликните на кнопку "Сгенерировать":

После чего вы увидите текст для своего сообщения:

Чтобы текст появился в окне сообщения, кликните по кнопке "Вставить текст":

Далее вы увидите текст в поле для сообщения:

Дополнительные кнопки

Под полем Текст сообщения есть дополнительные кнопки:

1. Добавить эмодзи: встроенные эмодзи конструктора

1. Вставить переменную: шаблоны встроенных переменных. При клике по кнопке откроется окно с описанием встроенных переменных. Чтобы добавить переменную, кликните по ней.

1. Markdown в Telegram: форматирование (разметка текста) текста, настройка работает только в Telegram.

1. Защитить контент: защита контента от копирования, работает только в Telegram. Защищенные сообщения нельзя переслать, а на телефоне нельзя переслать и сделать скриншот.

Пример сообщения с включенной защитой контента.

1. HTML-разметка Telegram: поможет стилизовать текст в сообщениях в мессенджере

1. Отправка без звука

В некоторых мессенджерах существует возможность отправки сообщений без звука (например, в Телеграм):

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

1. Callback о просмотре для Вконтакте и email:

Коллбек - это уведомление в боте о каком-нибудь совершенном действии клиентом или событии в проекте, которое отображается в диалоге с клиентом:

Данное уведомление клиент не видит, но на колбек можно настроить реакцию.

1. Сохранение переписки в истории переписки с клиентом:

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

Вкладка: API - запрос

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

Поле: Тип запроса

Тип запроса: данное поле представляет собой выпадающий список для работы со сторонними API. Взаимодействие бота со сторонними API подробно описано в данной статье

После выбора типа запроса открываются дополнительные поля API - запроса.

Вкладка: Калькулятор

Поле: Калькулятор

Калькулятор - это поле в Редакторе блока, которое открывается при клике по одноименной вкладке. В этом поле можно совершать логические или арифметические действия, выполнять функции API- запросов конструктора и доступных интеграций. В нем можно присвоить(объявить) переменную человеку, перешедшему в данный блок или назначить значение уже существующим переменным. Например, будет полезно при создании воронки или отслеживания источника трафика. Работа с переменными требует отдельного детального рассмотрения. Прочитать про использование переменных можно здесь

Вкладка: Действия

Поле: Добавить действие

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

Добавление действия:

Чтобы добавить действие в блоке, нажмите "+ Добавить действие".

По умолчанию: тип действия - Действие: никакое действие не выбрано.

Можно добавлять несколько действий:

Действие: Переместить по воронке

Можно выбрать в какое состояние воронки продаж в Salebot CRM будет помещен клиент при переходе в данный блок. Удобно не только для продвижения клиента по этапам воронки, но и для наглядной сегментации клиентов по категориям. Например, заявки от частных лиц в одну колонку, а от организаций - в другую колонку SalebotCRM.

Действие: Добавить в список / Удалить из списка / Переместить в список

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

Действие "Переместить в список" предполагает, что пользователь будет удален из списка А и перемещен в список Б.

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

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

Увидеть список, в котором состоит клиент, можно в разделе "Клиенты" в карточке клиента:

Действие: Добавить метку / Удалить метку

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

Создавать метки и управлять ими можно в разделе Списки - вкладка Метки. После перехода в блок с действием "Добавление метки" данная метка отобразится в диалоге с клиентом.

Действие: Выполнить код на python

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

Пример:

В блоке "Первостепенной проверки условия" назначены переменные first и second.

Далее во втором блоке устанавливаем действие "Выполнить код на Python":

В коде python обращаемся к этим переменным по ключу в словаре data, совпадающим с наименованием переменной из первого блока (создание переменной a), либо можно обратиться к переменной так же, как в выводе текста (создание переменной b).

В конце скрипта, как результат работы скрипта, возвращается переменная result, содержащая {'a': a, 'b': b, 'sum_ab': sum_ab}. Возвращать данные нужно именно в таком формате, тогда запишутся новые переменные, наименованием которых будут ключи возвращаемого словаря, а значениями переменных - соответствующие значения в словаре.

Отработка ботом блоков с выполняемым скриптом на Python:

Ошибки

Не удалось скачать файл - ошибка, из-за которой сохраненный файл с кодом не скачался для выполнения при отправке сообщения

result is not dict - возвращаемое значение должно быть словарем в формате ключ - значение, как на на примере ниже:

Вкладка: Кнопки

Кнопки можно создавать двумя способами: - стрелками с условием (включить настройку Отображать как кнопку)

- в редакторе блока Вкладка Кнопки

Поле: Кнопки

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

Также в этом поле легко менять кнопки местами, зажав левую кнопку мыши и перетянув кнопку в новое положение.

Под визуальным отображением кнопок есть переключатель типа созданных кнопок : Клавиатура (reply кнопки) и Кнопки в тексте (inline кнопки), а также автоматический режим:

Поле: Расширенные настройки кнопок

Чекбокс Показать кнопки

Показать кнопки: по умолчанию данный ползунок включен и клиенту показываются кнопки.

Чекбокс Показать стрелки как кнопки

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

Поле: Подсказка в мессенджерах без кнопок

Поле "Подсказка в мессенджерах без кнопок" необходимо, когда ваш бот должен работать одновременно в мессенджерах с кнопками и без (например, Telegram и обычный Whatsapp). Так как Whatsapp не поддерживает кнопки, то в этом поле вы можете предложить пользователям текст с цифровым меню. Он будет отображаться только в Whatsapp. Применяется для навигации внутри бота.

Поле: Расширенные настройки кнопок - код кнопок

Поле "Расширенные настройки кнопок (код кнопок)" можно использовать для создания уникальных кнопок с помощью кода.

Все возможные настройки кнопок можно прочитать в этой статье.

Вкладка: Вложения(отправка вложений)

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

Существует несколько типов вложений, которые можно отправлять в боте:

1. Ссылка;

2. Видео;

3. Изображение;

4. Файл;

5. Аудио.

Вкладка Аналитика

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

с полями:

• категория события - обобщенное название для каких-либо событий в боте:

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

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

• название события, для которого будет собираться статистика (Обязательное поле!)

Частное из обобщенной категории.

Например, в категории обобщенных действий:

а) пришли: из бота ТГ, из бота ВК, из бота Whatsapp; б) купили: товар1, товар2, товар3 и т.п.

Является обязательным полем.

• значение события - число или переменная клиента/сделки, указанная в формате #{cost}:

Далее при прохождении клиента через блок, в котором настроены события, просмотреть данные можно в разделе "Аналитика":

Необходимо создать виджет в разделе "Клиенты":

Далее выбрать необходимые настройки:

1) указать период аналитики

2) прописать название виджета;

3) выбрать вид отображения данных для аналитики (круговая диаграмма, столбчатая и тп)

4) выбрать данные, которые будут отображены в виджете:

Шаг 1. Выберите вкладку конверсии:

Шаг 2. Укажите способы подсчета данных Аналитики:

Что считать - параметры подсчета каждого шага:

• Количество - сколько клиентов прошло через выбранное событие

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

• Среднее значение - среднее значение события для всех клиентов, прошедших через него. Может показать сколько единиц товара в среднем продается одному клиенту.

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

Как считать - параметры для подсчета количества прохождения клиента

• Уникальное прохождение - подсчет уникальных пользователей, которые впервые прошли через воронку (данный блок, в котором настроена Аналитики);

• Все прохождения - подсчет всех прохождений (как первых, так и повторных) через данный блок воронки.

Как считать %

• подсчет с первого шага.

• подсчет с последнего шага.

Шаг 3. Добавьте шаг для подсчета:

Шаг 4. Выберите категорию (если есть) и событие, которое ранее указали в блоке бота и сохранили его:

Если необходимо отображать только определенное значение событий, то пропишите необходимое значение в строке "Значение событий":

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