InputNumber
Действие InputNumber
позволяет боту запросить у пользователя число в указанном диапазоне и сохранить его в переменную.
Параметры
Параметр | Тип | Описание | Обязательный |
---|---|---|---|
prompt | Строка | Сообщение, которым бот должен запросить число. Если вы хотите использовать в сообщении HTML-разметку, оставьте этот параметр пустым ( prompt = ) и заполните параметр html . | Да |
varName | Строка | Имя переменной. Введенное пользователем число будет сохранено в $session.<varName> . Используйте символы Aa–Zz, _, 0–9. Первым символом в имени должна быть буква. Нельзя использовать зарезервированные слова JavaScript. | Да |
html | Строка | Сообщение, которым бот должен запросить число, с использованием HTML-разметки. Если вы не хотите использовать HTML-разметку, вы можете не указывать этот параметр и использовать только prompt . | Нет |
htmlEnabled | Логический | Если значение параметра true , в сообщении бота будет отправлено значение параметра html , а в сообщении об ошибке — failureMessageHtml . Если параметр не указан или установлен в false , будет использовано значение prompt и failureMessage соответственно. | Нет |
failureMessage | Массив строк | Список сообщений об ошибке. Бот случайно выберет и отправит одно из этих сообщений, если пользователь введет число не в допустимом диапазоне или не число. | Нет |
failureMessageHtml | Массив строк | Список сообщений об ошибке с использованием HTML-разметки. | Нет |
then | Строка | Стейт, в который перейдет диалог, если сценарий тега будет выполнен без ошибок. | Нет |
minValue | Число | Минимальное допустимое значение числа. | Да |
maxValue | Число | Максимальное допустимое значение числа. | Да |
actions | Массив объектов | Кнопки, которые будут отправлены вместе с запросом. Укажите значение в формате:
| Нет |
Использование в сценарии
state: RatingSurvey
InputNumber:
prompt = Насколько вы готовы порекомендовать наш сервис по шкале от 1 до 5?
failureMessage = ["Не могли бы вы попробовать еще раз?", "Пожалуйста, введите число в диапазоне 1–5."]
minValue = 1
maxValue = 5
varName = rating
then = /RatingSurvey/GetRating
state: GetRating
a: Спасибо за вашу оценку!
script:
$analytics.setSessionResult($session.rating);
$jsapi.stopSession();