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.

Email

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.