Skip to main content

Button Group

Creates a group of buttons for user interaction 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​

  • ID - The unique identifier for the button group.

Options​

  • Labels - An array of text labels for the buttons.
  • Custom Labels - An array of custom label objects with additional properties.
  • Custom Action - Specifies a custom action to be performed. Currently supports "Clear" action.

Output​

  • Payload - The response object containing information about the user's interaction with the buttons.

How It Works​

The Button Group node creates interactive buttons in chat interfaces. When executed, the node:

  1. Creates a group of buttons with the specified labels
  2. Displays the buttons in the chat interface
  3. Waits for user interaction with the buttons
  4. Returns a payload with information about the user's selection

Requirements​

  • A valid chat interface or messaging platform
  • Properly configured button labels or custom labels

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid ID
  • Invalid label format
  • Issues with custom label objects
  • Communication errors with the messaging platform

Usage Notes​

  • Button labels are automatically converted to snake_case for internal use
  • Custom actions can be used to modify button behavior
  • The payload output contains information about which button was selected
  • Button groups are useful for creating interactive chat experiences