Skip to main content


The InputNumber action allows your bot to ask the user to enter a number within the specified range and save it into a variable.


promptStringThe message prompting the user to enter a number.
If you intend to use HTML markup in the message, leave this parameter empty (prompt =) and fill out the html parameter instead.
varNameStringVariable name. The number entered by the user will be stored in $session.<varName>.
Use the following characters: Aa–Zz, _, 0–9. The first character should be a letter. JavaScript reserved words are not allowed.
htmlStringThe message prompting the user to enter a number, with HTML markup.
If you don’t intend to use HTML markup, omit this parameter and use prompt only.
htmlEnabledBooleanIf set to true, the bot message will use the html parameter value, and the error message will use failureMessageHtml.
If omitted or set to false, the prompt and failureMessage values will be used instead.
failureMessageArray of stringsThe list of error messages.
The bot will randomly select and send one of these messages if the user enters a number not within the allowed range or not a number at all.
failureMessageHtmlArray of stringsThe list of error messages with HTML markup.No
thenStringThe state the dialog will switch to if the tag script completes without errors.No
minValueNumberThe minimum allowed number value.Yes
maxValueNumberThe maximum allowed number value.Yes
actionsArray of objectsButtons that will be displayed along with the request. Use the following format for the value:
actions =
"buttons": [{
"name": "Button text",
"transition": "/State path"
"type": "buttons"

How to use

state: RatingSurvey
prompt = How likely are you recommend our service, on a scale from 1 to 5?
failureMessage = ["Would you mind trying that again?", "Please enter a number in the range 1–5."]
minValue = 1
maxValue = 5
varName = rating
then = /RatingSurvey/GetRating

state: GetRating
a: Thank you for rating us!