Skip to main content

Interactive reply buttons messages

Updated: Nov 3, 2025 Interactive reply buttons messages allow you to send up to three predefined replies for users to choose from. Users can respond to a message by selecting one of the predefined buttons, which triggers a messages webhook describing their selection.

Request syntax

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send an interactive reply buttons message to a WhatsApp user.

Request parameters

Example Request

Example request to send an interactive reply buttons message with an image header, body text, footer text, and two quick-reply buttons.

Example Response

Webhooks

When a WhatsApp user taps on a reply button, a messages webhook is triggered that describes their selection in a button_reply object:
&lt;BUTTON_ID&gt; — The button ID of the button tapped by the user. &lt;BUTTON_LABEL_TEXT&gt; — The button label text of the button tapped by the user.

Example Webhook

Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Request syntax Request parameters Example Request Example Response Webhooks Example Webhook