Skip to content

Two-way messaging in Canvas using Quick Replies

Phone screen showing a call to action button will reply the text of the button clicked.

WhatsApp’s Quick Reply calls-to-action (CTAs) are a great way to encourage user engagement with your WhatsApp messaging. Braze can process these messages and configure actions based on user selection. Additionally, these CTAs can reduce back-and-forth errors by providing an easily clickable button, eliminating the need for your users to type out responses.

Quick Reply CTA buttons come in as inbound messages to the Braze system, meaning you’ll use the “Inbound WhatsApp message” action step when creating and filtering responses from your users.

What is a quick reply?

Quick replies appear as clickable button options within the conversation but act as if a user replied with text. Braze then processes these as inbound messages and can send back set responses based on the button clicked.

A WhatsApp message showing text and three call to action buttons.

Configure the Quick Reply experiences in Canvas

Step 1: Build out CTAs

First, build out your Quick Reply CTAs in the WhatsApp Message Template Manager within a message template.

The WhatsApp message template manager UI showing how to create a CTA button, providing the button type (custom) and the buton text.

Once your template has been submitted and approved by WhatsApp, you can use it to build a Canvas within Braze.

Step 2: Build your Canvas

Next, build a Canvas with a message step that includes your created template.

Create an action step that follows the message step. Create one group per quick reply option in this action step.

A Canvas where the evaluation action is "send a whatsapp inbound message".

For each quick reply option group, specify the exact text as the button you are matching. Note that the keywords must be in uppercase.

A Canvas step where the action "send a whatsapp inbound message" is set to send when a specific message body is received.

If you would like a default response for users who respond to the message with text instead of quick replies, create an additional group with no matching message body.

Continue building the Canvas as you would otherwise from this point forward.


You will most likely want a reply message for each response. We recommend having a catch-all option for responses that are outside the bounds of quick replies (i.e., for customers who respond with a general message rather than a predetermined prompt). For example, “We’re sorry, we didn’t recognize your response. For support issues, please message ."

A Canvas built out showing the responses for each call-to-action button.

Note that you can use any subsequent actions that the Braze Canvas offers, such as messages in response, user profile updates, or Braze-to-Braze webhooks.

New Stuff!