Триггеры
Last updated
Last updated
Триггер — это внешнее событие, которое вызывает ответную реакцию бота.
Представим ситуацию: Пользователь написал сообщение боту и получил ответ. Почему бот решил отправить сообщение именно в этот момент? Произошло внешнее событие: пользователь отправил сообщение. В данном примере отправка сообщения — это триггер, который привел к ответной реакции. Этот механизм лежит в основе всех сценариев.
Триггеры делятся на две группы:
Пользовательские триггеры — имеют дополнительные настройки.
Системные триггеры — настроек не имеют.
При создании виртуального ассистента используются следующие виды пользовательских триггеров:
Намерение. Присутствие в сообщении пользователя ранее описанного запроса (намерения). Для использования этого триггера в описании сценария необходимо выбрать одно из намерений.
Сущность. Присутствие в сообщении пользователя ранее созданной сущности. Для использования этого триггера в описании сценария необходимо выбрать одну из сущностей
Выход. Окончание сценария. Используя этот триггер, мы даем возможность перейти из одного сценария в другой. Есть три вида этого триггера:
выход из сценария только в определившийся QA;
выход из сценария только в другой сценарий согласно определившемуся интенту;
выход из сценария в определившийся QA или другой сценарий согласно определившемуся интенту.
Расположение областей (главное меню, основная рабочая область, дополнительная рабочая область) подробно описано на странице «Начало работы с проектом».
На странице создания сценария триггеры отображаются в дополнительной рабочей области в правой части экрана.
Триггеры добавляются драг-энд-дропом в основную рабочую область (в центр экрана). Для настройки триггера его нужно добавить в сценарий, а затем кликнуть по добавленному кубику.
Настройка триггера заключается в выборе намерения из выпадающего списка уже существующих в проекте намерений.
Список содержит только активные намерения. Удаленные и заархивированные намерения не отображаются.
В одном триггере могут быть проставлены сразу несколько намерений. После выбора первого намерения в дополнительной рабочей области появляется ещё одно окошко с выпадающим списком.
Все добавленные намерения отображаются на визуальном блоке триггера в сценарии.
Одно и то же намерение не может быть добавлено в один триггер дважды.
Если бот обнаружил в сообщении пользователя хотя бы одно из намерений, указанных в блоке триггера, то триггер сработает и произойдет реакция, описанная в сценарии.
Представим ситуацию: в сценарий добавлен триггер с намерением «Заказать пиццу». Для этого намерения предварительно определены фразы пользователя. Если пользователь пришлет сообщение, которое распознается как намерение в нашем примере, например «Хочу заказать пиццу», то сработает триггер и будет запущен сценарий его обработки (например, выдача пользователю текстовки).
Настройка триггера заключается в выборе сущности из выпадающего списка.
Список содержит только активные на данный момент сущности. Удаленные сущности не отображаются. Один триггер может соответствовать только одной сущности.
Пример: Пользователь прислал сообщение: «Мой телефон для связи с курьером +79001234567». Оно содержит сущность типа «Телефон». При обнаружении номера телефона в сообщении (срабатывании триггера) Лия сможет провести пользователя по ветке с сущностью «phone» и выдать ему соответствующую этой ветке реакцию.
Настройка триггера заключается в выборе из выпадающего списка «Выход» одного из трех пунктов:
out — выход из сценария в определившийся QA или другой сценарий согласно определившемуся интенту.
qa — выход из сценария только в определившийся QA.
flow — выход из сценария только в другой сценарий согласно определившемуся интенту.
Пример: Пользователь шел по основному сценарию, но в его середине решил задать другой вопрос, не предусмотренный вариантами реакций пользователя внутри сценария. При наличии триггера «Выход» на этом шаге пользователь перейдет в сценарий определившегося при этом интента или в определившийся QA.
В работе бота используются следующие системные триггеры:
Триггер «Старт» — начало взаимодействия с пользователем. Например, открытие виджета на странице сайта.
Триггер «Стикер» — отправка пользователем стикера. Такая возможность предоставляется популярными мессенджерами (Viber, WhatsApp, Telegram и другими), через которые можно общаться с ботом.
Триггер «Фото» — триггер этого типа не имеет настроек. Событие происходит при отправке пользователем графического изображения. Поддерживаются следующие форматы файлов изображений: jpg, gif, png.
Триггер «Аудио» — отправка пользователем аудиозаписи. Поддерживаются следующие форматы аудиофайлов: mp3, wav.
Триггер «Видео» — отправка пользователем видеозаписи. Поддерживаются следующие форматы видеофайлов: mp4, avi.
Триггер «Файл» — отправка пользователем какого-либо файла, кроме фото-, видео- и аудиофайлов. Поддерживаются различные форматы файлов: doc, xls, rar и другие.
Триггер «Гео» — отправка пользователем своей геопозиции. Этот вид триггера используется после того, как бот в качестве реакции прислал интерактивную карту для выбора точки.
Триггер «Прочее» — отправка пользователем сообщения, не содержащего ни одного из вышеописанных элементов. Чаще всего это текстовые сообщения, которые не смог распознать бот. Этот триггер также используется в сценариях, если мы хотим отреагировать определенным образом на что угодно, отправленное пользователем. В случаях, когда нет разницы, отправит пользователь файл или ответит запросом, который распознается как работающий в проекте интент, мы используем только триггер «Прочее», реагирующий на абсолютно любое сообщение.
