# Support for WhatsApp buttons & template enhancements

[Buttons](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates) are optional interactive components that can be added to WhatsApp [message templates.](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates) There are two types of buttons, [*Call-To-Action*](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates#call-to-action-buttons) and [*Quick Reply*](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates#quick-reply-button), that perform specific actions when tapped by an end-user.

Meta has introduced support for additional button types, combinations, and limits on WhatsApp message templates, enhancing the existing buttons and lists we are already familiar with. Building on a [previous WhatsApp release](https://guides.clickatell.com/release-notes/q1-jan-mar-2024/channel-updates/whatsapp-buttons-and-template-enhancements), Chat Flow now also supports multiple buttons and the [*Coupon Code*](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates#copy-offer-code) and [*Catalog*](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/showcase-product-catalog-in-message-template) templates in WhatsApp.

### WhatsApp Button Enhancements <a href="#whatsapp-button-enhancements" id="whatsapp-button-enhancements"></a>

#### **More buttons and combinations allowed**

Previously, there was a limit of three buttons per template and you could only add buttons of one type - either Call-To-Action buttons *or* Quick Reply buttons. With this release, a template can now contain up to **10** buttons in total, and the buttons can be a **combination** of Call-to-Action and Quick Reply buttons.

When using a combination of buttons, the types **must** be grouped, i.e., all Call-To-Action buttons must be grouped together and all Quick Reply buttons must be grouped together. Note that further limits may apply to individual button types.

If a message template contains more than three buttons, the first two buttons appear in the delivered message, and the remaining buttons are shown when the end-user taps **See all options** (see screenshots below).

<figure><img src="https://guides.clickatell.com/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2FwmGaDUQBZMvcoFPmfgvf%2Fblobs%2FuaXkIMnuZCrAlKOSwY0o%2Fimage.png&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f7f27afa&#x26;sv=2" alt="" width="563"><figcaption></figcaption></figure>

### **Quick Reply Buttons**

Quick Reply buttons are custom text-only buttons that immediately message the business with the specified text when tapped by the customer.

Message templates are limited to **10** quick reply buttons. If using quick reply buttons with other buttons, buttons must be organized into two groups: quick reply buttons and non-quick reply buttons. If grouped incorrectly, the API will return an error indicating an invalid combination.

{% hint style="info" %}
[Read more](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates#quick-reply-button).
{% endhint %}

#### **Call-To-Action Buttons**

This allows a user to **call a phone number**, **visit a website**, or **copy an offer code** *(new - see* [*below*](https://guides.clickatell.com/release-notes/q1-jan-mar-2024/self-service-chatbot/support-for-whatsapp-buttons-and-template-enhancements#new-coupon-code-templates)*)* with the tap of a button.

*Visit website* buttons open the specified URL in the device's default browser when tapped. Templates are limited to **two** URL buttons.

*Call phone number* buttons call the specified business phone number when tapped. Templates are limited to **one** phone number button.

{% hint style="info" %}
[Read more](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates#call-to-action-buttons).
{% endhint %}

<figure><img src="https://guides.clickatell.com/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2FwmGaDUQBZMvcoFPmfgvf%2Fblobs%2F8TbhBa3wNfFbKw4q2AcP%2Fimage.png&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f1fadea4&#x26;sv=2" alt="" width="375"><figcaption><p>A combination of Quick Reply and Call-To-Action buttons, grouped together.</p></figcaption></figure>

### **NEW: Coupon Code Templates** <a href="#new-coupon-code-templates" id="new-coupon-code-templates"></a>

Coupon code templates are [marketing templates](https://guides.clickatell.com/whatsapp-channel/channel-capabilities/whatsapp-message-templates) that display a single *Copy offer code* button. This new type of Call-To-Action button copies a text string to the device's clipboard when tapped by the customer. This text string is defined when the template message is sent. Templates are limited to **one** *Copy offer code* button, and the button text is not editable.

<figure><img src="https://guides.clickatell.com/~gitbook/image?url=https%3A%2F%2Fcontent.gitbook.com%2Fcontent%2FwmGaDUQBZMvcoFPmfgvf%2Fblobs%2F6lWpu4jWlH8FQ3CAERoB%2Fimage.png&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=46a91faf&#x26;sv=2" alt="" width="375"><figcaption><p>When an end-user taps the "Copy offer code" button, it copies the specified text string to the device's clipboard.</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.clickatell.com/release-notes/release-notes-archive/2024-release-notes/q1-2024/self-service-chatbot/support-for-whatsapp-buttons-and-template-enhancements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.