🇪🇸 Español 🇬🇧 English 🇧🇷 Português

Trigger: Button Clicked

Fires when a contact taps a WhatsApp quick-reply button, letting you branch the workflow by which button they chose.

Jul 11, 2026

The Button Clicked trigger fires when a contact taps one of the quick-reply buttons (Reply Buttons) on an interactive WhatsApp message you sent them. It's ideal for branching the conversation by which button was chosen, without the customer typing anything.

When to use it

  • Confirm or cancel an appointment based on the "Confirm" / "Reschedule" button.
  • Advance a satisfaction-survey flow based on the option picked.
  • Route to a different team depending on the button ("Sales" vs. "Support").

Requirements

A connected WhatsApp channel with interactive messages using Reply Buttons already sent to the contact. Remember Meta requires every button id to be unique within your setup.

Filters available

  • Specific channel.
  • Button ID: blank = any button; fill it in to branch by a specific option (e.g. "confirm" vs. "cancel").

Variables available

  • $button.id: the ID you defined when creating the message
  • $button.title: the visible label the contact tapped
  • $message.id: the inbound message ID carrying the reply
  • Conversation and contact variables

How to build it

  1. Go to WorkflowsNew workflow.
  2. Drag a Trigger node → pick Button Clicked (under Messages).
  3. Filter by Button ID if you want a dedicated workflow per option.
  4. Add an action using $button.title to personalize the response.
  5. Save and activate.

Example

Workflow "Appointment confirmation": fires on button ID "confirm_appointment" → Log activity: Appointment confirmed by {{contact.display_name}}Notify team.

Tips

Use descriptive, unique button IDs (e.g. confirm_appointment_v2) so they don't collide with interactive messages from other campaigns.

Troubleshooting

If the trigger never reacts, confirm the original message used Reply Buttons (not a List) — that case is covered by the List Option Selected trigger instead.

Was this helpful?

Related articles