Source: https://gitlab-test-org.docs.pageloop.ai/external-templates/whatsapp/create-marketing-whatsapp-templates

# Create a Marketing WhatsApp Template

Use a Marketing template to send promotions, announcements or campaign notifications to users. Creating one takes four steps:

1. [Create the template](#step-1-create-the-template)
2. [Build the message](#step-2-build-the-message), as a **Common** message, a **Carousel** or a **Calling Permission Request**
3. [Add more languages](#step-3-add-more-languages-optional) (optional)
4. [Save or send for approval](#step-4-save-or-send-for-approval)

## Step 1: Create the template

Navigate to **Templates → External → WhatsApp Templates**, then click **Create**. Fill in the dialog and click **Create Template**.

![](assets/waext-v-2-create-dialog.png)

| Field             | What to enter                                                                                                                   |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Template Name** | A unique name in lowercase, with underscores instead of spaces. For example, `summer_sale_offer`.                               |
| **Integrations**  | The WhatsApp Business Account to create the template in. The template can only send messages from this account's phone numbers. |
| **Category**      | Select **Marketing**.                                                                                                           |
| **Language**      | One or more languages. You can add or remove languages later.                                                                   |

## Step 2: Build the message

In **Template Type**, choose the type of message:

| Template type                  | Use it to                                                           |
| ------------------------------ | ------------------------------------------------------------------- |
| **Common**                     | Send a standard message with a header, body, footer and buttons.    |
| **Carousel**                   | Send up to 10 swipeable cards, each with its own media and buttons. |
| **Calling Permission Request** | Ask users for permission to call them on WhatsApp.                  |

#### Common

A standard WhatsApp message with a header, body, footer and buttons.

![](assets/waext-v-2-editor-common.png)

1. **Add a header (optional)**

   The header appears at the top of the message. Choose one type.
   #### Text
   Enter a short title in **Header Content** (maximum 60 characters). You can include one variable.

   ![](assets/waext-v-2-header-text.png)
   #### Image
   Click **Choose JPG or PNG file** and upload a sample image (maximum 5 MB).

   ![](assets/waext-v-2-header-image.png)
   #### Video
   Click **Choose MP4 file** and upload a sample video (maximum 16 MB).

   ![](assets/waext-v-2-header-video.png)
   #### Document
   Click **Choose PDF file** and upload a sample document (maximum 100 MB).

   ![](assets/waext-v-2-header-document.png)
   #### Location
   Shows a location, with its name and address, above the message body.

   ![](assets/waext-v-2-header-location.png)
   > [!NOTE]
   >
   > Media samples are only used by Meta to review your template. Do not include any customer information.
2. **Write the body**

   Enter the main message (maximum 1,032 characters). You can format text and add variables. Provide a sample value for every variable so Meta can review the message.

   ![](assets/sample-for-body-content-marketing.png)
3. **Add a footer (optional)**

   A short line at the bottom of the message, such as a disclaimer or opt-out instructions. Maximum 60 characters, with no variables.

   ![](assets/sample-footer-marketing.png)
4. **Set the message validity period**

   Choose how long Meta tries to deliver the message, for example 30 days. If it isn't delivered in time, you aren't charged and the recipient doesn't see it.

   ![](assets/message-validity-period.png)
5. **Add buttons (optional)**

   Click **Add Button** and choose a type. The menu shows how many of each type you can add.

   ![](assets/waext-v-2-add-button-menu.png)
   #### Quick Reply: Custom
   The user sends a predefined reply, such as **Yes** or **No**.

   ![](assets/quick-reply-button.png)
   #### Quick Reply: Marketing Opt-Out
   Lets users opt out of receiving marketing messages.
   #### Call to Action: Visit Website
   Opens a website. Use a **static URL** to send the same link to everyone, or select **Dynamic URL** to send a different link to each user, such as a payment link. Select **Track URL** to track clicks with [Fyno Shorty](../../url-shortener).

   ![](assets/waext-v-2-cta-visit-website.png)
   #### Call to Action: Call Phone Number
   ![](assets/call-phone-number.png)
   #### Call to Action: WhatsApp Voice Call
   ![](assets/whatsapp-voice-call.png)
   #### Call to Action: Copy Coupon Code
   ![](assets/copy-coupon-code.png)
   #### Flow
   Opens a WhatsApp Flow.

   ![](assets/type-flow-button-marketing.png)
   | Field               | What to enter                                                                   |
   | ------------------- | ------------------------------------------------------------------------------- |
   | **Button Title**    | The button text users see.                                                      |
   | **Flow ID**         | The ID of the flow, generated in Meta.                                          |
   | **Flow Action**     | **Navigate** opens a specific screen. **Data Exchange** sends or receives data. |
   | **Navigate Screen** | The name of the first screen of the flow.                                       |
   | Button type                     | Maximum |
   | ------------------------------- | ------- |
   | Call to Action buttons in total | 4       |
   | Visit Website                   | 2       |
   | Call Phone Number               | 1       |
   | WhatsApp Voice Call             | 1       |
   | Copy Coupon Code                | 1       |
   | Marketing Opt-Out               | 1       |
   | Flow                            | 1       |

#### Carousel

A swipeable message with up to **10 cards**, shown below a message body. Each card has its own text, media and buttons. Use it for product catalogs, multiple offers, event listings or booking options.

![](assets/waext-v-2-carousel-editor.png)

1. **Write the body**

   Enter the message shown above the cards (maximum 1,032 characters). You can add variables.
2. **Add cards**

   Under **Cards**, click **Add** to add a card. The counter shows how many you've added, for example **Add (1/10)**. Select a card to edit it, or click **X** on it to remove it.
3. **Write the card content**

   Enter the caption for the card in **Card Content**. You can add variables, and you must provide sample values for them.
4. **Add the card media**

   Every card needs media. In **Media Type**, choose **Image** or **Video** and upload a sample. The sample is only used for Meta's review, so don't include any customer information.
   #### Image
   Click **Choose JPG or PNG file** and upload a sample image.

   ![](assets/waext-v-2-carousel-sample-image.png)
   #### Video
   Click **Choose MP4 file** and upload a sample video.

   ![](assets/waext-v-2-carousel-sample-video.png)
5. **Add card buttons**

   Buttons are set per card, with up to **2 buttons per card**. Click **Add Button** and choose a type.
   #### Quick Reply
   ![](assets/quick-reply-button.png)
   #### Visit Website
   Use a **static URL** to send the same link to everyone, or select **Dynamic URL** to send a different link to each user. Select **Track URL** to track clicks.

   ![](assets/visit-website-curousel.png)

#### Calling Permission Request

Asks users for permission to call them on WhatsApp. The message shows a fixed permission card, "Can \[BIZ\_NAME] call you?", with a **Choose Preference** option.

![](assets/waext-v-2-calling-permission.png)

1. **Add a header (optional)**

   Choose **None**, or **Text** and enter a short title in **Header Content** (maximum 60 characters).
2. **Write the body**

   Enter the message shown above the permission card (maximum 1,032 characters). You can add variables.
3. **Add a footer (optional)**

   Maximum 60 characters, with no variables.
4. **Set the message validity period**

   Choose how long Meta tries to deliver the message, for example 30 days.

> [!NOTE]
>
> You can't add or edit buttons for this template type. It supports only one button type, and the button text is fixed.

## Step 3: Add more languages (optional)

To reach users in different regions, click **Add** next to **Languages** and add a version of the template in each language. Translate the message and button text, and keep the same variables in every language.

## Step 4: Save or send for approval

When your template is ready, save it as a draft or send it to Meta for approval. See [Save as Draft vs Send for Approval](/external-templates/whatsapp/save-or-send-for-approval).
