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
- In the Template Builder, find Actions in the Block Toolbox
- Click to add an Actions block
- Configure the default button (or add more — up to 5 per block)
Each button needs:
| Field | Required | Description |
|---|
| Label | Yes | Text on the button (e.g. “Approve”, “View Details”) |
| Action ID | Yes | Unique identifier for routing (e.g. approve_request) |
| Style | No | Primary (green), Danger (red), or Default (gray) |
| Value | No | Data passed when clicked (e.g. {{request.id}}) |
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}}
You can configure each button to:
- Send a webhook — HTTP request to your API (see Button webhooks)
- Update the message — Replace or append content (see Message updates)
- 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