Skip to content
Contlo by QuestionPro
Browse documentation

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.

App Market → WhatsApp → TemplatesReviewed by MetaText, image, video or PDF headerVariables and buttons

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.
ProviderCreate in ContloEdit in ContloDelete in ContloExtras
WhatsApp CloudYesNoYesOne optional link button
MSG91YesYesYesCarousel templates, several buttons, MM Lite
360 Dialog and GupshupNoNoNoTemplates 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.

ColumnWhat it shows
Template nameThe template's unique name.
PropertiesThe category (Marketing or Utility) and the message type (for example TEXT, IMAGE, VIDEO, DOCUMENT or CAROUSEL).
MessageThe body text, with any dynamic link buttons listed below it.
StatusWhere the template is in Meta's review.
Last updatedWhen 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

  1. On the Templates tab click Create template.
  2. On MSG91, choose the Phone number the template belongs to and the Language. The language starts on English.
  3. Enter a Template name. Only lowercase letters, numbers and underscores are allowed, for example order_confirmation. Spaces are turned into underscores as you type.
  4. Choose a Template category: Marketing or Utility.
  5. On MSG91, choose the Template type: Custom template or Carousel template.
  6. Choose the Header: Text, Image, Video or PDF document.
  7. Write the Message body and add variables where the text should change per customer.
  8. Optionally add Footer text and buttons.
  9. 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

CategoryUse it for
MarketingPromotions, offers, product launches, back-in-stock and win-back messages: anything meant to drive a purchase.
UtilityMessages 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

PartDetails
Header text (optional)A short title above the message, up to 60 characters. Shown when the header type is Text.
Media headerFor 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 bodyRequired. 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.

Buttons

WhatsApp Cloud

Under Buttons choose None or Call to action. For a call to action, enter the Button title. You don't enter the link here: the URL is added when you create a campaign with this template.

MSG91

ButtonLimitWhat you enter
Quick replyUp to 3The Quick reply text the customer taps to answer.
Visit websiteUp to 2Button text and Website URL. Add the {{1}} variable to the end of the URL to make it dynamic, then give a full Sample URL.
Call phone number1Button text and the Phone number, including the country code.
Copy offer code1Button text and the Coupon code the customer can copy.

Every button needs its text, and each type needs its own detail. Missing fields are flagged when you submit, for example Button text is required or Sample URL is required for dynamic URLs.

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.

StatusMeaningWhat you can do
PendingSubmitted and waiting for Meta's review.Wait, then click Refresh. The template cannot be sent yet.
ApprovedReady to use. Some providers report this as Enabled.Select it in campaigns, automations, keyword actions and the inbox.
RejectedMeta 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

  1. Find the template in the list and click Test.
  2. In Send test message, enter a phone number under Enter phone number here:.
  3. 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.

ActionDetails
EditMSG91 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 LiteMSG91 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.
DeleteAsks 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 seeWhat to do
Complete the form carefully before submittingA 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 MetaMeta 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 URLsA website button uses {{1}}. Enter a full example link.
Maximum 10 cards allowedA carousel can have up to 10 cards.
Error syncing templatesClick 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 campaignOnly approved templates for the selected number are offered. Check its status here and click Refresh.
There is no Create template buttonYour provider is 360 Dialog or Gupshup. Create the template with them and click Refresh.

Related guides

Can't find something? Email us