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

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

⚡Quick answer -

WhatsApp templates allow either

(a) up to 2 Call-to-Action (CTA) buttons—​1 Phone + 1 URL—​or

(b) 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:

2. 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:

❌ Quick Reply + CTA
✔ Only Quick Replies
✔ Only CTA buttons

If you try mixing, WhatsApp will reject the template.

RULE 2 — Maximum Count

  • 3 Quick Replies
  • 2 CTA buttons

It is not recommended to exceed these limits.

RULE 3 — CTA Button Rules

  • If 2 CTAs are used:
    • One must be called
    • One must be on the website

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