Skip to main content

Button Group

Displays a group of buttons for user selection in chat interfaces.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Session Id - Unique identifier for the UI client connection.
  • Label - Optional label for the button group.
  • Description - Optional description for the button group.

Options​

  • Multi Select - Specifies whether users can select single or multiple buttons. Can be either "Single" or "Multi".
  • Button Array - Array of buttons to display.
  • Custom Labels - Custom labels for buttons.

Output​

  • Result - User selection result from the button group.

How It Works​

The Button Group node creates an interactive widget with multiple buttons that users can select from. When executed, the node:

  1. Validates the provided Session ID
  2. Checks that the session is not in conversational mode
  3. Builds the button options from the provided array or custom labels
  4. Creates a button group widget with the specified label and description
  5. Sends the widget to the client with the specified session ID
  6. Waits for the user's selection
  7. Parses the response as JSON or string
  8. Returns the parsed selection as the result

Requirements​

  • A valid session ID for an active client connection
  • Properly configured client interface that can handle button group widgets
  • Session must not be in conversational mode

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Session ID
  • Session not found for the provided ID
  • Button list is required but not provided
  • Failed to build button options
  • Cannot use button group in conversational mode
  • Failed to send widget to client
  • Timeout while waiting for user selection
  • Failed to parse user response

Usage Notes​

  • The Session ID must match an active client connection
  • The Label and Description fields are optional but can help users understand what they're selecting
  • In Single Select mode, users can only choose one button
  • In Multi Select mode, users can choose multiple buttons
  • The returned selection will be in the format provided by the client (JSON or string)
  • Button groups cannot be used in conversational mode