Skip to main content
Interactive buttons turn static messages into workflows. When a user clicks a button, you can send a webhook, update the message, or open a modal. This guide covers adding and configuring buttons.

Prerequisites

Add an Actions block

  1. In the Template Builder, find Actions in the Block Toolbox
  2. Click to add an Actions block
  3. Configure the default button (or add more — up to 5 per block)
Empty Actions block

Button configuration

Each button needs:
FieldRequiredDescription
LabelYesText on the button (e.g. “Approve”, “View Details”)
Action IDYesUnique identifier for routing (e.g. approve_request)
StyleNoPrimary (green), Danger (red), or Default (gray)
ValueNoData passed when clicked (e.g. {{request.id}})
Button configuration panel
Use descriptive action IDs and short, action-oriented labels. Keep action IDs unique across the template.

Example: Approval workflow

Button 1 — Approve:
  • Label: ✓ Approve
  • Action ID: approve_request
  • Style: Primary
  • Value: {{request.id}}
Button 2 — Reject:
  • Label: ✗ Reject
  • Action ID: reject_request
  • Style: Danger
  • Value: {{request.id}}

What happens when a button is clicked

You can configure each button to:
  1. Send a webhook — HTTP request to your API (see Button webhooks)
  2. Update the message — Replace or append content (see Message updates)
  3. Open a modal — Collect more input (see Modals)
Configure the action in the button settings: Add Action → choose Webhook, Message Update, or Modal.

Next steps