Input Nodes
Input nodes ask the customer a question and wait for a response. When the customer replies, the answer is validated, stored in a workflow variable, and the flow continues. All input nodes have a built-in retry mechanism: if the customer's response is invalid, the node re-prompts up to the configured retry limit, then routes down the Invalid path.
Question
The Question node is the most flexible input node. It has two modes:
-
Select (multiple choice): The customer picks from a set of options rendered as buttons. Each option produces its own output handle on the canvas, so the flow can branch based on what the customer chose.
-
Text (free text): The customer types a free-form response. The flow follows the default path on a valid reply, or the Invalid path after retries are exhausted.
|
Field |
Description |
|
Question Type |
Select (multiple choice) or Text (free text). |
|
Question |
The question text displayed to the customer. |
|
Options |
(Select mode only) The answer choices. Each option has a label (what the customer sees), a stored value, and optionally a per-option variable key. |
|
Variable Key |
The workflow variable where the customer's answer is stored. See Variables for a list of available variables and how to create custom ones. |
|
Skip if answered |
When enabled, the node is silently skipped at runtime if the variable already has a value. |
|
Retry Limit |
Maximum number of retry attempts before routing to the Invalid path. Default is 2. |
|
Retry Message |
Message shown on each retry. Supports {{attemptCount}} and {{retryLimit}} for dynamic values. |
|
Placeholder |
The placeholder text for the input field. (Text mode only) |
|
Min Length and Max Length |
The minimum and maximum character limit for the input field. (Text mode only) |
Date
The Date node asks the customer for a date value and validates the format before storing it.
|
Field |
Description |
|
Question |
The question text. Include the expected format to avoid customer confusion (for example, "Please enter as MM/DD/YYYY"). |
|
Variable Key |
The variable where the date is stored. See Variables for a list of available variables and how to create custom ones. |
|
Skip if answered |
Skips the node if the variable already has a value. |
|
Retry Limit |
Maximum retries before routing to the Invalid path. Default is 2. |
|
Retry Message |
Message shown on each retry. |
|
Min Date / Max Date |
Optional. Restricts accepted dates to a specific range. |
Time
The Time node asks the customer for a time value. The response is normalized to HH:MM:SS before being stored, regardless of how the customer typed it.
|
Field |
Description |
|
Question |
The question text. Include the expected format (for example, "You can say something like 3:00 PM"). |
|
Variable Key |
The variable where the time is stored. See Variables for a list of available variables and how to create custom ones. |
|
Skip if answered |
Skips the node if the variable already has a value. |
|
Retry Limit |
Maximum retries before routing to the Invalid path. Default is 2. |
|
Retry Message |
Message shown on each retry. |
|
Min Time / Max Time |
Optional. Restricts accepted times to a specific range. |
|
Format |
Required. The expected time format: HH:MM:SS (24-hour with seconds), HH:MM (24-hour), or 12-hour with AM/PM. |
Number
The Number node asks the customer for a numeric value and validates that the response parses as a number.
|
Field |
Description |
|
Question |
The question text. |
|
Variable Key |
The variable where the number is stored. Must be declared as a number or string type in the workflow's variable registry. See Variables for a list of available variables and how to create custom ones. |
|
Skip if answered |
Skips the node if the variable already has a value. |
|
Retry Limit |
Maximum retries before routing to the Invalid path. Default is 2. |
|
Retry Message |
Message shown on each retry. |
|
Min / Max |
Optional. Enforces a numeric range. |
|
Step |
Optional. The increment for the number input. |
|
Prefix / Suffix |
Optional. Displayed alongside the number in the chat input. |
The Email node asks the customer for an email address and validates the format. Note that this node is different from the Send Email action node: this node collects an address from the customer; Send Email sends an email on the workflow's behalf.
|
Field |
Description |
|
Question |
The question text. |
|
Variable Key |
The variable where the email address is stored. See Variables for a list of available variables and how to create custom ones. |
|
Skip if answered |
Skips the node if the variable already has a value. |
|
Retry Limit |
Maximum retries before routing to the Invalid path. Default is 2. |
|
Retry Message |
Message shown on each retry. |
|
Placeholder |
Optional. Placeholder text shown in the email input field. |
|
Allowed Domains |
Optional. Restricts accepted addresses to specific domains. |
Phone
The Phone node asks the customer for a phone number. It accepts 7 to 20 digits with common formatting characters such as +, -, spaces, and parentheses. The original formatting the customer typed is preserved in the stored variable.
|
Field |
Description |
|
Question |
The question text. |
|
Variable Key |
The variable where the phone number is stored. See Variables for a list of available variables and how to create custom ones. |
|
Skip if answered |
Skips the node if the variable already has a value. |
|
Retry Limit |
Maximum retries before routing to the Invalid path. Default is 2. |
|
Retry Message |
Message shown on each retry. |
|
Default Country Code |
Optional. Pre-fills the country code in the phone input field. |
|
Placeholder |
Optional. Placeholder text shown in the phone number input field. |