Mercuri Docs
  • Welcome to Mercuri
  • ๐Ÿ“ฉCommunication Channels
    • WhatsApp Integration
      • Prerequisites
      • Onboarding on WhatsApp Business
      • Creating Your First WhatsApp Template
      • FAQ
    • SMS Integration
      • SMS Policies
      • Getting started with TFN
      • TFN verification process
      • Issues with TFN verification
      • SMS Length
  • ๐ŸงคFeatures
    • Conversations Inbox
      • Interactive Message Options for WhatsApp Conversations
    • Contacts
    • Marketing
    • Automations
      • Automated workflow for e-commerce businesses
        • Order Cancelled Template
        • Order Created Template
        • Cart Abandoned Template
        • FulFilment Created Template
      • Automated Workflow For Booking Related Events
        • Booking ConfirmedTemplate
        • Booking Rescheduled Template
        • Booking CanceledTemplate
      • Automated Workflow For Restaurant Table Reservations
        • Table Reservation Created Template
        • Table Reservation Canceled Template
      • Automated Workflow For Restaurant Order Events
        • Restaurant Order Accepted Template
        • Restaurant Order Fulfilled Template
        • Restaurant Order Cancelled Template
        • Pickup / Delivery Order Created Template
      • Automated Workflow For Consumer Signup
      • Automated Workflow For Forms
    • Templates
      • Creating Your First WhatsApp Template
      • Understand WhatsApp Template components
    • Users Management
    • WhatsApp Widget
  • ๐Ÿ›๏ธIntegrations Guide
    • Pipedrive
      • Install the Mercuri in Pipedrive
      • Using Mercuri in Pipedrive
        • SMS & WhatsApp Inbox
        • Configuring SMS
        • Adding Agents to the Shared Inbox
        • SMS and WhatsApp Marketing
    • Microsoft Teams
      • Install the Mercuri App in Microsoft Teams
      • Configure Mercuri for Microsoft Teams
      • WhatsApp Onboarding
      • How to use Mercuri?
Powered by GitBook
On this page
  • 1. Template Category
  • 2. Template Header
  • 3. Template Buttons
  • Different URL Types in Call-to-Action Buttons
  1. Features
  2. Templates

Understand WhatsApp Template components

This section provides a detailed walkthrough of the various components within a WhatsApp message template.

PreviousCreating Your First WhatsApp TemplateNextUsers Management

Last updated 2 days ago

Explore Different WhatsApp Template Components


1. Template Category

WhatsApp classifies the templates into 3 categories :

  • Marketing

Used for promotional or upsell messages such as offers, product recommendations.

Example Use Case: Special discount offer

Sample Message:๐ŸŽ‰ Hey {{1}}, enjoy 20% off on your next purchase with code WELCOME20! Offer valid till {{2}}. Donโ€™t miss out โ€” click below to shop now! [Shop Now]


  • Utility

Used to send important updates or information that customers need, such as order confirmations, reminders, account updates, or shipping notifications.

These messages are generally triggered based on user actions.

Example Use Case: Shipping confirmation

Sample Message:Hello {{1}}, your order #{{2}} has been shipped via {{3}}. Tracking number: {{4}} Expected delivery in 3โ€“5 business days. Tap below to track your package. [Track Now]


  • Authentication

Used for sending OTP codes and login verification messages securely.

  • Example Use Case: One-time password for login

  • Sample Message: Your login code is: {{1}} This code is valid for 10 minutes. Do not share it with anyone.


2. Template Header

The header is the top section of a WhatsApp message template and can include either text or media to add context or emphasis to your message.

  1. Text Header

  • A simple line of text that highlights the main message.

  • Only one variable in the text header is allowed(e.g., customer name or order ID)

  1. Media Header

  • Supports images, videos, documents, or locations to visually enhance the message.

Media Type

Aspect
Static Media
Dynamic Media

Definition

The same media (image, video, etc.) is sent to every user.

The media changes based on the recipient or event.

Use case

Promotional banner, brand logo, standard brochure.

Product image based on userโ€™s order, personalized invoice, etc.

Personalization

No personalization ,same content for all.

Highly personalized ,tailored for each user.

Media support

Supports all media (images,videos,documents,location)

As of now , wix and shopify support only dynamic images

While the WhatsApp Business API supports dynamic media (image, video, document, location), platforms like Wix and Shopify currently allow only dynamic image headers. Dynamic videos, documents, and locations are not supported on these platforms at the moment.

Media Type
Max Size

Images

5 MB

Videos

16 MB

Documents

100 MB

Steps to add Static and Dynamic Media

Use case

A restaurant wants to notify all customers about a festive offer.

Header Image: Diwali offer banner (diwali_offer.png)

  • Usage: The same banner is shown to all users.

  • Result: Everyone receives the same image, regardless of their order or preferences.

Steps to Add a Static Image in the header :

  1. Select Media as the header from the drop-down. Select the required media (here image is selected).

  2. Set the type to Static.

  3. Upload a sample image in the sample value box

Use case

A D2C skincare brand wants to send shipping updates with a picture of the exact product the customer ordered.

Header image: Image of the exact serum that the customer has ordered.

Steps to Add a Dynamic Image in the header :

  1. Select Media as the header from the drop-down. Select the required media (here image is selected).

  2. Set the type to Dynamic.

  3. Set the variable value as Product Image URL and upload a sample image in the sample value section.


3. Template Buttons

Adding buttons to a WhatsApp template enhances user experience by enabling easy, one-tap actions directly from the message.

For example, instead of just sending shipment details in text, including a โ€œTrack Nowโ€ button allows the user to directly open the tracking page, improving efficiency and engagement.

Types Of Template Buttons

  • Quick Reply Button

  • Call to Action Button

Quick Reply Buttons

Purpose

Quick reply button provides predefined options for users to choose from in response to a message. Ideal for gathering information, providing quick answers, or guiding users through a workflow.

Examples

  • "Yes, Iโ€™m interested."

  • "Change Delivery Time"

  • "Cancel Booking"

One can include a maximum of 3 Quick Reply Buttons per Template

Call to Action Buttons

Purpose

To redirect users to take a specific action, such as visiting a website, calling a number, or copying an offer code.

Options

  1. Visit Website

  • Opens a link in the browser.

  1. Call Phone Number

  • Opens the phone dialer with a predefined number.

  • Helpful for customer support, reservations, or service inquiries.

  1. Copy Offer Code

  • Let users copy a promo code with a tap, without needing to select or highlight.

One can include a maximum of 2 Call-to-Action buttons per template.


Different URL Types in Call-to-Action Buttons

When setting up Call-to-Action (CTA) buttons in WhatsApp templates, URLs help guide users to specific web pages.

These URLs can be categorized into two types: Static URLs and Dynamic URLs, depending on whether the link remains the same for all users or varies based on user-specific data.

Static URLs

A Static URL is a fixed web address that remains the same for all users. It does not change based on user inputs or user-specific actions.

Use Case

Use Static URLs when:

  • You want to direct all users to a common page like:

    • Registration page

    • Contact Us page

    • FAQs or Help Center

Example

https://example.com/register This URL will always take users to the same registration page, regardless of who clicks it.


Dynamic URLs

A Dynamic URL contains placeholders that are replaced with user-specific values when the message is sent. This allows each recipient to receive a personalized link.

Use Case

Use Dynamic URLs when:

  • The destination URL varies by user, such as:

    • Order tracking page

    • Appointment confirmation page

    • Personalized offer or invoice link

Example

https://example.com/{{1}} Here, {{1}} is a dynamic parameter that gets replaced with a unique value, such as an order ID or user ID.

  • For User A: https://example.com/ORDER12345

  • For User B: https://example.com/ORDER67890

This enables each user to access personalized content securely and directly.

Can be static (same for all users) or dynamic (personalized per user, e.g., https://track.com/{{1}}).

๐Ÿงค
[Click here to understand the Difference between static and dynamic URLs]
Cover

Template Categories

Understand different WhatsApp Template categories: Marketing , Utility , Authentication

1. Template Category

Cover

Header

Explore different media types available .Understand when and how to use static and dynamic media type.

2. Template Header

Cover

Template Buttons

Explore different template buttons to enhance customer experience and engagement.Understand when to use Static and Dynamic URLs for CTA Buttons

3. Template Buttons

Template header
Static Image in header
Dynamic Image as header
Different Types of Available buttons