Message Template Guide

Last updated:2023-09-22

WhatsApp supports authentication templates, transaction related templates, and marketing templates, please use the following guidelines to select a template category.

Authentication templates

Authentication templates enable businesses to authenticate users with one-time passcodes (usually 4-8 digit alphanumeric codes), potentially at multiple steps in the login process (e.g., account verification, account recovery, integrity challenges).

Authentication templates are our most restricted. For a template to be classified as authentication, a business must:

  • Use WhatsApp’s preset authentication message templates, which include optional add-ons like security disclaimers and expiry warnings
  • Configure a one-time password button (copy-code or one-tap)
  • Follow content restrictions: URLs, media, and emojis are not allowed for authentication template content or parameters. Additional length restrictions of 15 characters also apply to parameters.

Template Example

Definition Examples
Authentication code
  • "{{1}} is your verification code."
  • "{{1}} is your verification code. For your security, do not share this code."
  • "{{1}} is your verification code. This code expires in 15 minutes."
  • Utility templates

    Utility templates relate to a specific, agreed-upon transaction and accomplish one of the following: Confirm, suspend, or change a transaction or subscription.
    Any template that has a mix of utility and marketing content will be classified as a marketing template.

    Note: Examples are illustrative only, templates containing similar content or content including this example text may be categorized differently based on their exact content.

    Template Example

    Definition Examples
    Confirmation, suspension or termination of an existing transaction
  • "Your order #0021 is confirmed"
  • "Thank you for your reservation! See you next week"
  • "Your payment was received! We hope you enjoy the concert!"
  • "Your consultation is complete, and your prescription is attached below"
  • "Thank you for visiting the doctor, here is your treatment plan"
  • "Your order has been canceled; your refund will be processed in 7-10 days"
  • Change or update to a transaction
  • "You have successfully checked in! Here’s your boarding pass for your flight"
  • "Your order has shipped! It will be delivered on Friday"
  • "Reminder: Your appointment is at 1pm on Tuesday"
  • "Your password was changed"
  • "Your profile was updated"
  • Account, billing, or payment notification
  • "Here is the monthly statement you requested"
  • "Your payment failed, click here to retry"
  • "Your payment was accepted” / "Your payment failed"
  • Reminder: your payment is due on Tuesday"
  • "Here is your low-balance warning for account ending in -XXXX"
  • "Your pre-paid balance is low; click here to top up"
  • Marketing templates

    Marketing templates are our most flexible. They do not relate to a specific, agreed-upon transaction and instead may relate to the business and/or its products/services. These templates may include promotions or offers; welcoming or closing messages; updates, invitations or recommendations; or requests to respond or complete a new transaction.
    Any template that has a mix of utility and marketing content will be classified as a marketing template.

    Note: Examples are illustrative only, templates containing similar content or content including this example text may be categorized differently based on their exact content.

    Basic Template Examples

    Definition Examples
    Promotions or offers
  • "If you buy 2 or more coffees, you’ll get $5 off!"
  • "Thanks for your order! Use code SAVE20 for 20% off your next order!
  • "Your pre-paid balance is low; click here to top up! Get a 10% bonus with code EXTRA10"
  • Welcoming or closing messages
  • "This is Vinny’s Bakery and we are now on WhatsApp!"
  • "Hello, welcome to our profile on WhatsApp!"
  • "I'm sorry for the delay, my name is XX, how can I help you?"
  • "Thank you, have a good day"
  • "Thank you for visiting our store, we really appreciate your visit."
  • "A question for you - how much time are you spending doing your hair?"
  • Updates, invitations, newsletters, or recommendations
  • "Our store has moved. Come and check us out!"
  • "We will be closed next Monday for the holiday"
  • "Good news! The product you saved is back in stock."
  • "Join us for our upcoming holiday gala!"
  • "Here are this month’s coupons – happy shopping!"
  • "Hey members, join us tonight for this event"
  • "We think you will love this – check out our new ice cream flavor"
  • Requests to respond or complete a new transaction
  • "Thank you for your order. We’d love your feedback. Please click here."
  • "Forgot something? We kept your items, click to check out"
  • "Your application is waiting for you. Click here to complete"
  • "You missed your recent appointment, tap here to rebook."
  • Advanced Template Example

    If the template needs to be filled with information such as header, body, footer, buttons, etc., you can refer to the following example:

    Template name content
    sample_flight_confirmation
    Header:Media,Type:file
    Body:This is your flight confirmation for {{1}}-{{2}} on {{3}}.
    Footer:This message is from an unverified business.
    sample_happy_hour_announcement Header:Media,Type:video
    Body:
    Happy hour is here! 🍺😀🍸
    Please be merry and enjoy the day. 🎉
    Venue: {{1}}
    Time: {{2}}
    Footer:This message is from an unverified business.
    sample_issue_resolution Interactive card types
    Body:Hi {{1}}, were we able to solve the issue that you were facing?
    Footer:This message is from an unverified business.
    First button:Yes, second button:No
    sample_movie_ticket_confirmation Header:Media,Type:image
    Body:Your ticket for *{{1}}*
    *Time* - {{2}}
    *Venue* - {{3}}
    *Seats* - {{4}}
    Footer:This message is from an unverified business.
    sample_purchase_feedback Header:Media,Type:image
    Body:Thank you for purchasing {{1}}! We value your feedback and would like to learn more about your experience.
    Footer:This message is from an unverified business.
    Interactive Buttons:Visit Website:https://www.example.com/
    sample_shipping_confirmation Body:Your package has been shipped. It will be delivered in {{1}} business days.
    Footer:This message is from an unverified business.
    在文档中心打开
    icon
    Contact Sales