Skip to main content

Create selectable menus using the List Option block

Overview

The List Option block lets your bot offer chatters a list of selectable items. The item the chatter selects is saved as a variable to be used as you see fit. You can create the list of options manually, or populate the list with saved variables.

lob_chatter-facing.png

Here are some use cases for the List Option block:

  • Selecting a product (e.g. retail item selection)

  • Selecting items from an order list (e.g. to indicate an item missing from a delivery)

  • Identifying reasons for requesting an agent during the handoff process

Note

The List Option block is currently only available for chatters using Ada's chat user interface. Supporting additional platforms is a priority for us, however, and our teams are working on this functionality for future releases.

Use the List Option block

  1. On the Ada dashboard, go to Build > Answers.

  2. Select an Answer or create a new one, then drag and drop the List Option block from the block drawer into the Answer editor.

  3. Configure the List Option block according to what you want to present to your chatters. Use the following table as a guide.

    Prompt

    Add a message telling the chatter how they should use the list. It could be as simple as "Pick an option," but should also include specific instructions when necessary.

    Example: "Click the checkboxes to select all options that apply to you, then click Confirm to submit."

    Options

    This is where you create your list of items for chatters to choose from. Add one item per field.

    • To insert variables instead of text, click the three-dot menu on the right, then click Variable. The information contained in the variable displays as that option to the chatter.

      Note

      If the variable in an option is empty, that option is omitted from the list the chatter sees.

    • Click Add Option to create additional fields for your list.

      To delete options, hover your cursor to the right of an option field and click the negative sign to remove that option.

    • Select the Multiple Select checkbox to allow your chatters to choose more than one option.

    Error Answer

    Create and assign an error Answer to display to your chatters in the event that an error occurs.

    Save Response as Variable

    Create or select the variable for storing the chatter selection for use later in your Answer or Answer flow.

    Note

    If you enabled Multiple Select, you must use the List type variable.

    Required

    If the Required toggle is:

    • Disabled – A Skip button appears which the chatter can use to skip selecting from the list and move on to the next block in your Answer.

    • Enabled – The chatter must make a selection from the list, or click Never mind to quit the Answer entirely. Clicking this button redirects the chatter to the Cancel Capture Answer.

      • Hide Cancel Button – Enable this option to prevent the chatter from cancelling the Answer.

    completed_LOB.png

Variable Types

When creating a target variable for your options list, the variable type you choose depends on whether you allow the chatter to select only one item from the options list or multiple items.

Note

Text, Number, and Yes or No variables can only be used with List Option blocks that allow the chatter to select one option. They cannot be used in a List Option block with multiple select enabled.

  • Text – A Text target variable can be used with any type of option variable.

  • Number – To use a Number target variable, all option variables in the list must be number variables.

  • Yes or No – The Yes or No target variable can only be used when the option variables in the list are also yes or no variables.

  • List – If you allow your chatters to select more than one item from the options list, you must save their selections as a List variable. Items collected in a List variable are separated by semicolons.

Nesting Within Other Blocks

You can nest the List Option block in other Operations blocks, such as the Conditional block or the Scheduled block. This is useful if you want to provide different lists of options to the chatter based on conditionals or a predetermined schedule.

The List variable

Once collected using the multiple select functionality, List variables can be used as you would any other variable.

multi-select_variable.png

Here are a few examples:

  • Added to a block to relay the information back to the user, with each item separated by semicolons (e.g. "The items your shipment was missing are: lipstick; mascara; blush.")

  • In a Conditional block

Example: When asking a chatter to indicate items missing from an order, assume you have separate sets of instructions for chatters missing one item versus those who are missing multiple items. You can use the Conditional block to serve one set of instructions if the list length equals one item, and the second set of instructions if the list length equals two or more items.

Chatter Experience

  • The List Option block produces a list of options for the chatter to choose from. Chatters can only pick one item at a time.

  • Chatters select an option by clicking or tapping their choice. The message input field is hidden, so chatters can't type their selection.

  • If you activate the Required toggle, a Never mind button appears in place of the message input field. Clicking this button ends the Answer flow, and presents the chatter with the Cancel Capture Answer.

  • If you don't activate the Required toggle, a Skip button appears in place of the message input field. Clicking this button lets the chatter skip the List Option block, and move to the next block in the Answer's sequence.

Have any questions? Contact your Ada team—or email us at help@ada.support.