Что такое компоненты
В Isaak из компонентов строится логика работы бота. Каждый из них представляет собой какое-либо действие, которое совершает бот во время диалога с пользователем.
Например, компонент может выводить на экран текст, изображения или выполнять еще какие-либо действия.
Для всех компонентов:
В настройках компонента в графе Целевая платформа можно указать конкретную платформу, для которой сработает данный компонент. Затем скопировать его ID для дальнейшего использования при рассылках, триггерных событиях или указать в настройках при тупике. Также можно отключить выполнение компонента или удалить его.
Для всех компонентов с текстовым блоком:
В настройках компонента доступен пункт Включить предпросмотр ссылок, отвечающий за включение или выключение визуального предварительного просмотра и краткого описания общей ссылки.
Вывод текста
Этот компонент используется для вывода текста пользователю.
Посмотреть видео-урок про данный компонент можно здесь.
Вывод изображения
Компонент Вывод изображения отправляет пользователю заранее загруженное изображение.
В настройках пункт Прикрепить к предыдущему компоненту позволит отправить изображение одним сообщением вместе с предыдущим текстом.
Посмотреть видео-урок про данный компонент можно здесь.
Как добавить изображение
Добавить изображение можно двумя способами: из локального хранилища или по ссылке.
Для добавления изображения со своего компьютера в параметрах компонента нажмите кнопку Загрузить.
Также можно добавить изображение, вставив на него ссылку в настройках компонента.
Сообщение с кнопкой
Посмотреть видео-урок про данный компонент можно здесь.
Компонент Сообщение с кнопкой предназначен для отправки пользователю кнопок, прикрепленных к сообщению.
В настройках компонента в разделе Заголовок кнопки задается название кнопки. Компонент поддерживает два вида функционала:
Переход на экраны
Переход на внешний URL
Для того, чтобы при нажатии кнопки пользователь переходил на следующий экран, нужно указать связь между кнопкой и необходимым компонентом.
Чтобы при нажатии кнопки пользователь переходил по внешней ссылке, в настройках компонента нажмите Внешняя ссылка и в появившейся строке Ссылка вставьте внешний URL.
Кнопки навигации
Компонент Кнопки навигации используется для создания меню внутри окна чата. Отправляет пользователю кнопки, позволяющие выбрать один из вариантов без необходимости набора на клавиатуре.
В настройках компонента можно создать ряды кнопок, переименовать их и выбрать стиль.
Для корректной работы компонента поле Сообщение от бота не должно быть пустым.
Ввод пользователя
Посмотреть видео-урок про данный компонент можно здесь.
Компонент позволяет дождаться от пользователя определенных данных , например, имени или адреса, и записать в переменную, а также отреагировать, если пользователь прислал не то, что ожидалось.
В настройках компонента можно указать ожидаемый тип данных:
ввод текста
ввод числа
ввод даты
запрос файла
ввод email
ввод геоданных
Также можно указать реплику бота, имя переменной и сообщение об ошибке.
HTTP-запрос
Компонент HTTP-запрос позволяет боту получить или передать данные от внешнего ресурса и сохранять их в переменную.
Для корректной работы нужно обязательно указать URL запроса и метод (по умолчанию используется GET). В разделе Заголовки запроса при необходимости указываются заголовки запроса.
Тело запроса
Для всех методов, кроме GET, можно записать тело запроса.
Условие
Компонент Условие позволяет направить бота на определенный компонент в зависимости от выполнения определенных условий. В качестве условий можно использовать шаблонизатор и его хелперы. Условий может быть несколько, и для каждого есть переход на нужный компонент. Таким образом можно программировать нелинейную логику диалога.
При добавлении нескольких условий выполняется логическая операция "ИЛИ".
Текстовые значения при сравнении следует обрамлять либо двойными, либо одинарными кавычками.
Условие Иначе будет выполняться, если ни одно из условий в компоненте не истинно.
Примеры
Логирование
Компонент Логирование предназначен для отладки бота. В настройках компонента можно выбрать, как поступят данные: в бота, на электронную почту или сервис.
Запись переменных
Данный компонент позволяет записать значение или объект в переменную. Для начала работы необходимо добавить список переменных, нажав на значок Список переменных.
После добавления переменных можно использовать компонент Запись переменных и записать/вывести необходимое значение.
Пример:
Значение переменной будет меняться динамически.
Добавление в коллекцию и выборка из коллекции
Коллекции представляют собой небольшие базы данных, в которых можно хранить актуальные значения переменных, которые будут меняться вне зависимости от того, кто на них влияет.
Компонент Добавление в коллекцию позволяет создать локальную базу данных и сохранять в ней информацию.
Компонент Выборка из коллекции позволяет забрать нужную информацию из сохраненных ранее данных.
Пример:
Для начала необходимо в настройках конструктора создать коллекцию и добавить в нее несколько колонок. В данном примере исползуются две колонки name - Имя и date - Дата.
Затем добавляем элемент Выборка из коллекции, в настройках компонента выбираем созданную коллекцию store, отмечаем колонки name и date и записываем коллекцию в переменную shop.
Фразы
Компонент Фразы определяет, что хочет пользователь и переводит его по нужной ветке сценария.
Данный компонент позволяет боту понимать естественный язык при общении с пользователем, а также дает боту возможность следовать по разным веткам сценария в зависимости от ответа пользователя.
Вы можете создать собственную группу фраз, описав ее списком примеров. Нажмите Добавить группу фраз и перечислите слова и фразы, которые могут ввести пользователи, а затем свяжите с нужным компонентом. Если пользователь скажет или напишет что-то, что подойдет под одну из созданных групп фраз, бот переведет его на компонент, с которым создана связь.
Созданная вами группа фраз должна содержать как минимум один пример фразы.
Last updated
