Перейти к основному содержимому

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Массив объектовКнопки, которые будут отправлены вместе с запросом. Укажите значение в формате:
actions =
  [{
    «buttons»: [{
      «name»: «Текст кнопки»,
      «transition»: «/Путь до стейта»
    }],
    «type»: «buttons»
  }]
Нет

Использование в сценарии

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();