Buttons
Displays a set of buttons inside the chat widget, such as URL buttons to open a webpage, or Text buttons to send preset replies that keep the conversation flowing smoothly.
Configuration
Section titled “Configuration”Below are the configuration options for the Buttons action:
Action Name
Section titled “Action Name”A short, specific identifier that tells the Agent what this action does (e.g. best_sellers_buttons, support_button). This name is internal and helps the AI understand the action’s purpose.
When to Use
Section titled “When to Use”A detailed description instructing the AI agent on exactly when and why it should trigger this action. When applicable, you can specify one or more of the following in your instructions:
- Positive cues/phrases: Example utterances and keywords that signal this action (e.g. “Trigger this when they ask about pricing”).
- Preconditions: What must be true before running (e.g. “Only trigger after asking for their email”).
- Do not use when: Explicit exclusions to avoid false triggers.
Frequency
Section titled “Frequency”Specify how often the Agent is allowed to invoke this action to avoid overusing it or spamming the chat:
- Once per chat: The buttons will only ever be shown a single time per conversation session.
- Whenever applicable: The agent can trigger the buttons multiple times if the context requires it.
Buttons
Section titled “Buttons”Add the actual buttons that you want to display in the chat UI. Buttons can be of two types:
- URL button: Opens an external webpage in a new tab when clicked. You must specify the target URL.
- Text button: Acts as a quick-reply. When clicked, it sends a message back to the AI agent on the user’s behalf. If a specific “Message” is provided, that hidden text will be sent. Otherwise, the visible button label will be sent as the message.
To reorder the buttons, click the drag handle next to a button and move it up or down to your preferred position.