In short: A message template is a message approved by Meta in advance. It is the only way to write to a customer outside the 24-hour window, and the only kind of message a campaign can send. You can create and send templates in Mumble or through the Mumble API. A template cannot be edited, so get it right before you save it.
Choose the right category
- Marketing: promotions, launches, abandoned cart, surveys. The most expensive. The customer must have opted in.
- Utility: an update about something the customer did: an order, an appointment, a payment. No promotion at all.
- Authentication: a one-time code only, with no links or emojis.
One promotional sentence makes the whole template Marketing. If the content is mixed, split it into two templates. Prices: Paying Meta and WhatsApp Messaging Costs.
What a template can contain
- Header (optional): text, image, video, document or audio. A text header cannot have variables.
- Body (required): up to 1,024 characters, with numbered variables
{{1}},{{2}}in order. A variable cannot open or close the text, and two variables cannot sit side by side. - Footer (optional): plain text, up to 60 characters.
- Buttons (optional): up to 10 in total, including up to 2 link buttons and 1 phone button.
Name rules: up to 30 characters, lowercase English letters, numbers and underscores, unique in the account. Use one language per template, for example welcome_en and welcome_he. In Marketing templates, add the opt-out button from the opt-out word picker. See Opt-Out and Blacklist.
Templates through the API
| Endpoint | What it does |
|---|---|
GET /get-templates |
Lists your templates |
POST /create-template |
Creates a template and sends it to Meta for approval |
POST /send-template |
Sends an approved template with no variables |
POST /send-template-text-variable |
Sends an approved template with variables |
GET /is-active-conv |
Checks if the customer’s 24-hour window is open |
Check the window first: if it is open, you can send free text. If it is closed, send a template. The API key and sending limits are in The Mumble API: The Complete Guide.
Approval
- Save the template in Mumble, or create it through the API. It appears under Pending.
- Mumble sends it to Meta automatically.
- Meta answers within minutes, and at most about 24 hours.
- Approved templates move to Approved and can be sent. Rejected ones move to Rejected with a reason.
To fix a template, delete it and create a new one with a new name. See Message Template Rejected?.
Common questions
The template name is not accepted
It has spaces, capital letters or non-English letters, or the name is taken. Add a suffix like _v2.
An approved template fails through the API
Check that the phone number is in international format with no + or leading 0 (972501234567), and that the number of variables matches the body. Also check your messaging limit.
Some Marketing messages are not delivered
Meta limits how many marketing messages one person gets from all businesses (error 131049), and does not deliver Marketing templates to US (+1) numbers. Do not retry right away.
My template was paused
Too many blocks or spam reports. Meta pauses it for 3 hours, then 6 hours, then disables it. Send to a smaller, opted-in audience.