WhatsApp templates
A WhatsApp template is a pre-approved message. WhatsApp requires one for every campaign, and for any message you send to a customer outside the 24-hour reply window. You build the template in Contlo, Meta reviews it, and once it is approved you can use it in campaigns, automations and the inbox.
Les guides sont en anglais.
Before you start
- Connect your WhatsApp Business account first. See Connect WhatsApp.
- What you can do here depends on your WhatsApp provider. The table below shows the differences.
| Provider | Create in Contlo | Edit in Contlo | Delete in Contlo | Extras |
|---|---|---|---|---|
| WhatsApp Cloud | Yes | No | Yes | One optional link button |
| MSG91 | Yes | Yes | Yes | Carousel templates, several buttons, MM Lite |
| 360 Dialog and Gupshup | No | No | No | Templates are created with the provider and synced into Contlo |
The template list
Open the WhatsApp settings and choose the Templates tab to see WhatsApp templates.
| Column | What it shows |
|---|---|
| Template name | The template's unique name. |
| Properties | The category (Marketing or Utility) and the message type (for example TEXT, IMAGE, VIDEO, DOCUMENT or CAROUSEL). |
| Message | The body text, with any dynamic link buttons listed below it. |
| Status | Where the template is in Meta's review. |
| Last updated | When the template last changed. |
- Filter the list with All, Approved, Pending and Rejected.
- If you have more than one number on MSG91 or Gupshup, use the number picker to see one number's templates.
- Click Refresh to sync templates and their latest statuses from your provider. You see Templates synced successfully! when it finishes.
- Click Create template to build a new one (WhatsApp Cloud and MSG91).
Create a template
- On the Templates tab click Create template.
- On MSG91, choose the Phone number the template belongs to and the Language. The language starts on English.
- Enter a Template name. Only lowercase letters, numbers and underscores are allowed, for example
order_confirmation. Spaces are turned into underscores as you type. - Choose a Template category: Marketing or Utility.
- On MSG91, choose the Template type: Custom template or Carousel template.
- Choose the Header: Text, Image, Video or PDF document.
- Write the Message body and add variables where the text should change per customer.
- Optionally add Footer text and buttons.
- Check the phone preview on the right, then click Submit for approval.
On success you see Template submitted successfully! and return to the list, where the template waits for Meta's review.
Category
| Category | Use it for |
|---|---|
| Marketing | Promotions, offers, product launches, back-in-stock and win-back messages: anything meant to drive a purchase. |
| Utility | Messages tied to something the customer did, such as an order confirmation or a shipping update. |
Meta makes the final decision on a template's category during review.
Header, body, footer and variables
| Part | Details |
|---|---|
| Header text (optional) | A short title above the message, up to 60 characters. Shown when the header type is Text. |
| Media header | For Image, Video or PDF document, upload a sample file. Meta uses it to review the template. You choose the actual file each time you send. |
| Message body | Required. Up to 1,024 characters. |
| Footer text (optional) | A small line under the message, up to 60 characters. New templates start with a default footer that you can change or clear. |
Variables
Variables are placeholders that are filled with real values for each customer when you send, such as a first name or a discount code.
- Click Add variable to insert the next placeholder into the body. Placeholders are numbered:
{{1}},{{2}}and so on. - For every placeholder, enter a Sample value. Meta needs samples to understand the message, and the template cannot be submitted without them.
- You choose what fills each variable later, when you use the template in a campaign, an automation or a chat.
Carousel templates (MSG91)
A carousel is one message with a row of swipeable cards, each with its own media, text and buttons. Use it to show several products or offers at once.
- Set Template type to Carousel template.
- Write the main Message body that appears above the cards.
- Under Carousel settings, choose the Card media format: image or video. All cards use the same format.
- Upload one Sample media file. It is used as the preview for all cards.
- Under Button configuration, set the type of Button 1 and Button 2: URL, Call, Quick Reply or none. The same button types appear on every card.
- Under Card management, click Add new card for each card you need, up to 10. Select a card to edit it.
- For each card, write the Card body (up to 160 characters), add variables with sample values if needed, and fill in the button text and link or phone number.
- Click Submit for approval.
Approval statuses
Templates are reviewed by Meta before they can be used. Contlo shows the result in the Status column. Click Refresh to pull the latest status.
| Status | Meaning | What you can do |
|---|---|---|
| Pending | Submitted and waiting for Meta's review. | Wait, then click Refresh. The template cannot be sent yet. |
| Approved | Ready to use. Some providers report this as Enabled. | Select it in campaigns, automations, keyword actions and the inbox. |
| Rejected | Meta declined the template. | Fix the content and submit again. See below. |
If a template is rejected
- Check the category. Promotional content submitted as Utility is a common reason.
- Make sure every variable has a realistic sample value and enough surrounding text.
- Check that sample media and link URLs work and match the message.
- On MSG91, open the template with Edit, correct it and click Update template to send it for review again.
- On WhatsApp Cloud, create a new template with a new name. A deleted template's name cannot be reused.
- For 360 Dialog and Gupshup, correct the template with your provider, then click Refresh in Contlo.
Send a test message
- Find the template in the list and click Test.
- In Send test message, enter a phone number under Enter phone number here:.
- Click Send. The template is sent to that number.
A successful test shows Test message sent successfully! If it fails you see Error in sending test message, with the provider's reason when one is returned.
Edit, delete and MM Lite
Open the arrow next to Test on a template's row for more actions. This menu is not shown for 360 Dialog and Gupshup accounts.
| Action | Details |
|---|---|
| Edit | MSG91 only. Opens Edit WhatsApp template. The template name and phone number cannot be changed. Click Update template to save. On other providers you see Template editing is only allowed for MSG91 templates. |
| Enable MM Lite / Disable MM Lite | MSG91 only. Switches Meta's Marketing Messages Lite delivery on or off for this template. You can also check Enable MM Lite while creating a Marketing template. |
| Delete | Asks Are you sure you want to delete the template, and warns that you won't be able to use that name for any template again. Click Yes, delete to confirm. |
Troubleshooting
| What you see | What to do |
|---|---|
| Complete the form carefully before submitting | A required field is empty. Look for the fields marked in red: name, body, sample values, media or button details. |
| Error in submitting template! or a message from Meta | Meta refused the submission. Read the message, which usually names the problem (a duplicate name, an invalid format), fix it and submit again. |
| Please upload a image file (or video, or document) | Image, video and PDF headers need a sample file. Upload one before submitting. |
| Sample URL is required for dynamic URLs | A website button uses {{1}}. Enter a full example link. |
| Maximum 10 cards allowed | A carousel can have up to 10 cards. |
| Error syncing templates | Click Refresh again. If it keeps failing, check that your WhatsApp connection is still valid under Connect WhatsApp. |
| A template is missing when you build a campaign | Only approved templates for the selected number are offered. Check its status here and click Refresh. |
| There is no Create template button | Your provider is 360 Dialog or Gupshup. Create the template with them and click Refresh. |
Guides associés
- Connect WhatsAppConnect your WhatsApp Business account to Contlo, check your number and quality rating, and learn what each WhatsApp settings tab does.
- WhatsApp campaignsSend a one-time WhatsApp message to your subscribers: pick an approved template, fill variables, add media and links, test, and launch.
- Conversations inboxReply to WhatsApp, Instagram, SMS and live chat messages in one inbox: filter, assign, tag, resolve, and share orders or carts with customers.
- Helpdesk settingsSet up your support inbox: away message, notification sounds, custom statuses, auto-assignment, quick replies, keyword actions and tags.
- Automations overviewWhat automations do, how to create one from a template or from scratch, and how to manage and measure them on the Automations page.