BookbagBookbag

WhatsApp templates

Create and manage the WhatsApp message templates your campaigns send. Covers categories, languages, variables, headers and footers, and approval status.

View as Markdown

WhatsApp requires that any message you send to open a conversation use a pre-approved message template. Templates are the building block of Outbound campaigns: a campaign picks a template, fills in its variables per recipient, and sends it.

Where to find it

Open an agent → Outbound → the Templates manager. Here you create, edit, and delete the templates available to campaigns.

Anatomy of a template

Each template has a few defining fields:

FieldWhat it is
NameA lowercase identifier (letters, numbers, underscores), e.g. order_shipped.
CategoryHow WhatsApp classifies the message: marketing, utility, or authentication.
LanguageThe template language code, e.g. en_US.
BodyThe message text, with {{1}} / {{name}} placeholders for variables.
HeaderAn optional header (text or media) shown above the body.
FooterAn optional short line of text below the body.
Statusapproved, pending, or rejected — only approved templates can be sent.

Template categories

WhatsApp routes and prices messages by category, and the category affects what content is allowed:

CategoryUse it forExamples
MarketingPromotions and re-engagement.Sales, product launches, win-back offers.
UtilityTransactional updates tied to an action the customer took.Order confirmations, shipping updates, appointment reminders.
AuthenticationOne-time passcodes and verification.Login OTPs, password resets.
Pick the right category

Choosing the accurate category improves approval odds and deliverability. Don't label a promotion as utility — WhatsApp may reject or reclassify it.

Create a template

  1. 1
    Open the Templates manager
    In the Outbound tab, switch to Templates and click New template.
  2. 2
    Set name, category, and language
    Use a clear lowercase name. Choose the category that matches the message and the language code your customers read.
  3. 3
    Write the body with variables
    Add the message text and insert {{1}}, {{2}}, … (or named placeholders) wherever content should be personalized per recipient.
  4. 4
    Add a header or footer (optional)
    Headers can carry a title or media; footers are a short trailing line such as an opt-out note.
  5. 5
    Save
    Bookbag counts the variables and stores the template so campaigns can use it.
order_shipped (utility, en_US)
Hi {{1}}, good news — your order {{2}} is on its way!
Expected delivery: {{3}}. Reply here with any questions.

Variables

Placeholders in the body are detected automatically and counted. When a campaign uses the template, each variable is mapped to a contact field, a custom attribute, or a static value and rendered per recipient. See Outbound campaigns → Personalization.

Keep variable numbering tidy

Use sequential placeholders ({{1}}, {{2}}, {{3}}) and make sure every one maps to a real value at send time. Unmapped placeholders render literally, which looks broken to the customer.

Approval status

In production, WhatsApp reviews templates before they can be sent, so a template moves through pending → approved (or rejected). Only approved templates can be selected in a campaign — attempting to send an unapproved template is blocked.

info

Templates you create in Bookbag are available to campaigns immediately for design and simulation; real sends require the template to be approved on your WhatsApp account.

Editing and deleting

  • Edit a template to change its body, category, language, header, or footer. Changing the body re-counts variables.
  • Delete a template you no longer use. Existing campaigns keep a snapshot of the template text they sent, so deleting a template doesn't alter past campaigns.

What's next