> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://myoperator.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How do button types and button organising rules work in a WhatsApp message template?

⚡ Quick answer — WhatsApp templates allow either:
- Up to 2 Call-to-Action (CTA) buttons — 1 Phone + 1 URL, or
- Up to 3 Quick Reply buttons.

Mixing CTA and Quick Reply buttons in the same template is never allowed, and all Quick Replies must appear together.

## When should I use this guide?

Read this guide before creating or editing any WhatsApp template in MyOperator (or via API) so your button choices pass Meta review on the first attempt.

---

## 1. Prerequisites

* WhatsApp Business Account (WABA) with template-creation permission
* Template header and body already drafted

---

## 2. TYPES OF BUTTONS ALLOWED IN WHATSAPP TEMPLATES

WhatsApp allows two major button types in templates:

### 1. QUICK REPLY BUTTONS

1. Up to 3 quick reply buttons
2. User taps → sends a predefined text response back to the business
3. Cannot contain URLs
4. Cannot trigger phone calls
5. Cannot contain dynamic parameters

### 2. CALL-TO-ACTION (CTA) BUTTONS

You can add up to 2 CTA buttons, but with rules.

#### CTA Button Types

* Visit Website → URL
* Call Phone Number → Phone call button

---

## 3. BUTTON ORGANISING RULES (VERY IMPORTANT — WHERE PEOPLE MAKE MISTAKES)

### RULE 1 — You CANNOT MIX Quick Replies and CTAs

Meaning:

* Not allowed: Quick Reply + CTA
* Allowed: Only Quick Replies
* Allowed: Only CTA buttons

If you try mixing, WhatsApp will reject the template.

### RULE 2 — Maximum Count

* 3 Quick Replies
* 2 CTA buttons

Do not exceed these limits.

### RULE 3 — CTA Button Rules

* If 2 CTAs are used:
  * One must be Call Phone Number.
  * One must be Visit Website (URL).

You cannot have:

* 2 Website buttons
* 2 Phone Call buttons

### RULE 4 — Dynamic Parameters Only in URL CTAs

Only the URL CTA can use placeholders like `{{1}}`.

Quick reply buttons cannot use variables.

Call CTAs cannot use variables.

### RULE 5 — Website CTA requires proper URL

Allowed:

* Full URL (https:// required)
* One dynamic parameter

Not allowed:

* Missing https://
* More than 1 parameter
* Deep links with special characters that break encoding

---

## 4. When does Meta reject a template?

| Mistake | Review outcome | Fix |
| --- | --- | --- |
| Mixed CTA and Quick Reply buttons | ❌ Rejected | Separate into two templates |
| 2 URL CTAs | ❌ Rejected | Keep only one URL CTA |
| Quick Replies split by a CTA | ❌ Rejected | Group Quick Replies together |
| Emoji in Quick Reply text | ❌ Rejected | Remove emoji; use plain text |
| Button list > 3 items | ❌ Rejected | Reduce to the allowed limit |

---

Keywords: WhatsApp template buttons, CTA vs Quick Reply, button limits, Meta approval rules, MyOperator