All Products
Search
Document Center

Chat App Message Service:Message template design

Last Updated:Apr 29, 2025

This topic describes how to design a message template in the Chat App Message Service console, as well as how to edit and modify the template.

Template types

  • Marketing templates

    Marketing templates are the most flexible templates of WhatsApp, and are not tied to specific completed transactions. Instead, they may relate to the business or its products or services. These templates can include promotional offers, welcome messages or farewells, dynamic updates, invitations or recommendations, or responses to inquiries or completion of new transactions. Marketing templates support custom templates, catalog message templates, and multi-product message (MPM) templates. With the custom template format, you can customize the message content and layout according to your actual needs. To switch template formats, select the desired option from the template format drop-down list in the upper-right corner of the Template Design page. For template examples, see Marketing templates.

    • Custom templates

      View buttons in custom templates

      Button

      Description

      04

      Adds languages.

      05

      Undoes the most recent operation.

      06

      Cancels the most recent undo operation.

      07

      Adds a message header.

      Note

      Only one header is supported in a message template.

      image.png

      Adds a limited-time offer.

      • If the Expiration Time option is turned off and a Promo Code button has been added, place the Promo Code button in the first position.

      • If the Expiration Time option is turned off and no Promo Code button has been added, place a URL button in the first position.

      Note

      Only one limited-time offer is supported in a message template.

      08

      Adds a message footer.

      Note
      • Only one footer is supported in a message template.

      • Message footers are not supported in limited-time offer templates.

      09

      Adds a URL button.

      Specify Button Name, URL Type, and URL.

      Note
      • Only two URL buttons are supported in a message template.

      • URL buttons are not supported in catalog message templates and MPM templates.

      10

      Adds a Call button.

      Specify Button Name, Country/Region, and Mobile Number.

      Note
      • Only one Call button is supported in a message template.

      • Call buttons are not supported in catalog message templates and MPM templates.

      11

      Adds an Auto-reply button.

      Specify the Button Name and Event Type parameters. Valid values of Event Type:

      • Open Message: Select a message template.

      • External Event: Specify the business system, intent, and default message.

      Note
      • A message template can contain up to 10 buttons, including URL buttons, Call buttons, Auto-reply buttons, and Promo Code buttons.

      • Auto-reply buttons are not supported in catalog message templates and MPM templates.

      image.png

      Adds a Promo Code button.

      The name of a Promo Code button cannot be changed to Copy Promo Code. You can add text variables for promo code copying.

      Note

      Only one Promo Code button is supported in a message template. When used in conjunction with a limited-time offer, place the Promo Code button in the first position.

      010

      Adds a Stop Promotion button.

      If you want to use a Stop Promotion button, you must agree to the agreement in the button settings.

      Note

      Only one Stop Promotion button is supported in a message template.

      WhatsAppFlow

      Adds a WhatsApp Flow button.

      Click Synchronous Flow and select a published WhatsApp Flow from the dropdown list.

      Note

      The WhatsApp Flow must first be created and published in Facebook Messenger Platform. Afterwards, it can be selected in Chat App Message Service through WhatsApp Flow synchronization.

    • Catalog message templates and MPM templates

      Both the catalog message template and MPM template are marketing templates related to the Meta ecommerce catalog. Before using these templates, you must first authorize and link your product catalog. For information about authorization and binding of the catalog, see Catalog management. For information about creating and sending product catalog templates, see Best practices for product catalog templates.

  • Utility templates

    Important

    Any templates that mix utility and marketing content will be classified as marketing templates.

    • Utility templates are used for specific transactions that have been completed, to accomplish one of the following: confirming, terminating, or modifying a transaction or subscription.

    • The design of utility templates differs from marketing templates in that they do not support certain marketing features. For example, utility templates do not support buttons for limited-time offers, promo codes, or stopping promotions.

    • For template examples, see Utility templates.

  • Authentication templates

    • Authentication templates are the most stringent templates of WhatsApp. Businesses must use WhatsApp-predefined authentication templates, which may include optional add-ons such as security disclaimers and expiration warnings. Additionally, authentication templates must be configured with an OTP button (to copy the password or auto-fill it).

    • Through authentication templates, businesses can verify user identities using an OTP.

    • The content or parameters of authentication templates do not allow the use of URLs, media, or emojis. Parameters are also subject to a 15-character limit

    • For more information about authentication templates, see Best practices for authentication templates.

    • For template examples, see Authentication templates.

Procedure

Prerequisites

Create a message template

  1. Log on to the Chat App Message Service console.

  2. In the left-side navigation pane, click Channel Management

  3. On the Channel Management page, find the WhatsApp channel and click its ID or Manage in the Actions column.

  4. On the page that appears, click Template Design in the left-side navigation pane.

  5. On the Template Design page, click Add.

  6. In the Add dialog box, set the parameters, including Template Name, Category, and Language.

    Important

    WhatsApp may update the category of a template based on its content. For example, if a utility template passes the review and the WhatsApp monitoring system later determines that the content is marketing, WhatsApp will update the approved utility template to a marketing template and bill it as a marketing message.

    The actual category of the message template will be determined by the billing statement.

  7. Click OK to start designing the template. To set variables or upload materials, see Create variables or Upload materials.

  8. Click Save to save the template.

  9. Click Submit. After WhatsApp approves the template, you can use it to send messages.

Edit the message template

  1. On the Template Design page, find the template, and then click the template name or click Edit in the Actions column.

  2. On the page that appears, edit the template based on your needs. To set variables or upload materials, see Create variables or Upload materials.

    Note

    Editing of WhatsApp message templates in any review status is supported. However, please note that editing an approved template requires resubmission for review and will have the following impacts:

    1. The template cannot be sent from the time it is submitted for review until it is re-approved.

    2. Any ongoing sending tasks for the template will fail once it is submitted for review.

    Exercise caution when editing an already approved message template.

Delete the message template

  1. On the Template Design page, find the template and click Delete in the Actions column.

  2. In the message that appears, click OK.

    Note
    • According to WhatsApp regulations, you cannot create a template with the same name within 30 days after deleting a WhatsApp message template.

    • Deleting an approved message template will result in the failure of any ongoing sending tasks.

    • Please exercise caution when performing deletion operations.

What to do next

Send WhatsApp messages

References