Send List
The Send List action allows you to send a structured list of selectable options to users within a chatbot conversation.
Instead of displaying buttons, this feature presents options in a scrollable list format, allowing users to browse and select one item from multiple choices.
Send List is useful when you need to present more than three options, keeping the conversation organized and easy to navigate.
When to Use Send List
Use the Send List action when users must choose from a larger set of options.
Common Use Cases
Product or service categories
Help center options
Support request categories
Order tracking and account options
Multi-option menus
Example list shown to users:
Main Menu View Products Pricing Plans Track Order Contact Support
When the user selects an option, the chatbot continues the flow based on the selected item.
How to Add Send List
Follow these steps to add a Send List action in your bot workflow:
Open Bot Builder
Click Add Node
Navigate to the Send category
Select Send List
Configure the list message and options
Click Create
Once added, the Send List node will appear in the bot flow where users can select one of the available options.
Send List Configuration
When creating a Send List action, you must configure several fields.
Action Name
The Action Name identifies the action within the bot builder workflow.
This name is visible only inside the bot configuration.
Example:
Main Menu List Support Menu Service Selection
Header Text
The Header Text appears at the top of the list message and provides context for the available options.
Example:
Main Menu
This field helps users understand the purpose of the list.
Body Text
The Body Text contains the main message displayed before the list options.
Example:
Welcome! Please select one of the options below to continue.
The body text can also include variables and formatting.
Footer Text
The Footer Text appears below the message and provides additional instructions.
Example:
Choose an option to proceed
Button Text
The Button Text defines the label shown on the expandable list button.
Example:
View Options
When users tap this button, the full list of options appears.
List Type
The Send List action supports two list types.
Static List
In a Static List, the options are manually added inside the configuration panel.
You can add up to 10 list options.
Each option includes:
Option Title
Description
ID
Example:
Option
Description
View Products
Browse available products
Pricing Plans
View subscription plans
Track Order
Check your order status
Contact Support
Get help from our team
Static lists are best when the options are fixed and do not change frequently.
Dynamic List
A Dynamic List retrieves options from a variable containing structured data.
This allows list items to be generated dynamically from:
API responses
Database results
Previous workflow steps
Dynamic configuration fields include:
Variable Name
Variable Path
Variable Key Title
Variable Key Description
Variable Key ID
Dynamic lists are useful when displaying changing or real-time data.
Adding List Options
When using a static list, you must configure each option.
Each option includes the following fields:
Option
The title of the list item.
Example:
Track Order
Description
Additional details explaining the option.
Example:
Check your order status
ID
A unique identifier for the option.
The system uses this ID to track the selected option and trigger the next action.
Adding More Options
To include additional options:
Click Add New Menu
Enter the option title
Add a description
Provide a unique ID
A maximum of 10 options can be included in a single Send List message.
Error Attempt
Users may sometimes reply with text instead of selecting an option.
The Error Attempt field determines how many invalid responses are allowed.
Example:
Error Attempt: 2
If the user exceeds the allowed attempts, the chatbot will trigger the selected Action on Invalid.
Error Message
The Error Message is displayed when the user provides an invalid input.
Example:
Please select a valid option to proceed.
This helps guide the user back to the available list options.
Action on Invalid
This option determines what happens when the user exceeds the allowed error attempts.
Available options include:
End the Flow
Stops the chatbot flow.
Skip the Question
Allows the chatbot to continue to the next step.
Fall Back Flow
Redirects the user to another predefined action.
Fallback flows help guide users back to the correct conversation path.
Store Response in Variable
You can store the selected list option in a variable.
Example:
Variable: selected_menu_option
This stored value can be used later in:
Conditional logic
Personalized messages
Workflow automation
Example Interaction
Example chatbot interaction using Send List:
Message:
Welcome! Please select one of the options below.
List Options:
View Products Pricing Plans Track Order Contact Support
If the user selects Track Order, the chatbot can automatically redirect them to the order tracking flow.
Best Practices
Follow these recommendations when using Send List.
Organize options clearly
Group related options under a clear menu title.
Keep option titles short
Short titles improve readability and selection.
Use helpful descriptions
Descriptions help users understand what each option does.
Limit list size
Avoid overwhelming users with too many options.
Summary
The Send List action enables chatbot builders to present multiple selectable options in a structured list format.
With Send List, you can:
Display up to 10 selectable options
Provide descriptions for each option
Organize menu-based conversations
Retrieve dynamic list data from variables
Store user selections for workflow automation
This feature helps create organized, scalable, and user-friendly chatbot interactions.
Last updated