# Use interactive buttons in message templates

When [creating your template](/whatsapp-channel/channel-capabilities/whatsapp-message-templates/add-message-templates.md) in Facebook Business Manager, you can add one of two types of interactive buttons to your template:&#x20;

* [**Call to Action**](#call-to-action-buttons)
* [**Quick Reply**](#quick-reply-button)

A template can have a mixture of **up to 10 buttons in total.** Limitations may apply to individual buttons of the same type, as well as to the combination of buttons allowed.

<figure><img src="/files/GtYoInEFqEecq3hlhVgO" alt=""><figcaption><p>You can add quick reply and call-to-action buttons to your message template.</p></figcaption></figure>

## **Call to action buttons**

This allows your customer to **call a phone number**, **visit a website**, or **copy a code** with the tap of a button.

From the drop-down select the type of action button you want to add:

* [Visit Website](#visit-website)
* [Call Phone Number](#call-phone-number)
* [Copy Offer Code](#copy-offer-code) *(shared model only)*

<figure><img src="/files/4JS1WsIqkrwg4Wotd0kt" alt=""><figcaption><p>Example of the available action buttons you can add to your template.</p></figcaption></figure>

#### ***Visit Website***

When tapping this button, the customer is directed to the specified website in their device's default browser.

The website URL is expected in the format:

* Static URL: **http(s)://[www.example.com](http://www.example.com)**
* Dynamic URL: **http(s)://[www.example.com/{{1](http://www.example.com/{{1)}}**&#x20;

{% hint style="info" %}

* Only **two** URL buttons per template are allowed.
* All variables (e.g., {{1}}) are set when [sending the message via One API](https://docs.clickatell.com/channels/one-api/one-api-reference/#operation/sendMessageREST_1), where you can specify the parameters in the payload.&#x20;
  {% endhint %}

#### ***Call Phone Number***

When tapping this button, a call is initiated from the customer's device to the specified number.

* Specify the country linked to the phone number.
* Enter the phone number in the international format, e.g. “**+14111111111**”.&#x20;

{% hint style="info" %}

* Only **one** phone number button per template is allowed.
  {% endhint %}

#### *Copy Offer Code*

When tapping this button, a text string ("code") is copied to the customer device's clipboard.

{% hint style="info" %}

* Templates are limited to **one** copy code button.
* Coupon code templates are currently not supported by WhatsApp Web.
* Codes are limited to 15 characters.
* Button text cannot be customized.
  {% endhint %}

<figure><img src="/files/FAsvh3hL5FdRLLdFrFJ1" alt="" width="311"><figcaption><p>Example of the copy code button on a customer's device.</p></figcaption></figure>

## **Quick reply button**

These custom text-only buttons allow your customer to **respond** **quickly** with a **custom**, **pre-defined** text message. When tapping this button, the customer sends the response to the business as part of the conversation.

From the drop-down select the type of action button you want to add:

* **Custom**
* **Marketing opt-out** *(Marketing templates only)*
  * Adding the optional "[Opt-Out](https://www.facebook.com/business/help/448422200528701)" quick-reply button gives your end-users an easy way to opt out of all marketing messages.
  * Note that it is still *your* responsibility to remove these customers from your contact list.&#x20;

<figure><img src="/files/Dud8cXyhaQLy3mepaNr8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

* The quick-reply button text can be a maximum of **25** characters long.
* The text on every button used in a template must be **unique.**
  {% endhint %}

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.

If a template has more than three buttons, two buttons appear in the delivered message and the remaining buttons can be seen when tapping *See all options*.

<figure><img src="/files/CINqd1RK5ReKghYIzNSi" alt="" width="563"><figcaption><p>Example of a combination of interactive buttons on a customer's device. If more than three buttons, only two will be shown immediately, and the rest can be viewed by tapping "See all options".</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/whatsapp-channel/channel-capabilities/whatsapp-message-templates/use-interactive-buttons-in-message-templates.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.
