Message templates

Templates are how you start a conversation on WhatsApp. Every template passes internal review before it reaches Meta.

Why templates exist

WhatsApp does not allow unsolicited free-form messages. To message someone outside the 24-hour service window you must use a template that Meta has pre-approved. Wappr adds a layer on top: your workspace's own review, so nothing hits Meta half-finished.

Creating a template

  1. 1Templates → New template. Give it a lowercase, underscore-separated name (e.g. order_shipped).
  2. 2Choose a category: Marketing, Utility or Authentication. Category affects both approval odds and Meta's pricing.
  3. 3Pick the language, then write an optional header, the body, and an optional footer.
  4. 4Add buttons if useful — quick replies or call-to-action (URL / phone).
  5. 5Save as draft, preview, then submit for review.

Variables and buttons

  • Variables are numbered placeholders: {{1}}, {{2}}. Provide a sample value for each — Meta rejects templates without them.
  • A variable can never be the first or last character of the body.
  • Quick-reply buttons return a payload you can branch on in the flow builder.
  • URL buttons may contain one trailing variable, useful for order or tracking links.

The two-stage approval flow

  1. 1Stage 1 — internal review. A workspace admin (or a platform super-admin, depending on your setup) checks the template in the review queue and approves or rejects it with a note.
  2. 2Stage 2 — Meta review. On internal approval the template is submitted to the WhatsApp Business API. Meta usually responds within minutes, occasionally up to 24 hours.
  3. 3Status updates arrive over the webhook and appear on the template automatically.

Reviewers

The platform review queue lives at /admin/templates and is visible to super-admins only, with SLA timers on pending items.

Template statuses

StatusWhat it means
DraftBeing edited. Not visible to reviewers.
Pending reviewWaiting on internal approval.
Rejected (internal)Sent back with a reviewer note. Edit and resubmit.
SubmittedWith Meta, awaiting their decision.
ApprovedUsable in campaigns and to reopen conversations.
Rejected (Meta)Meta declined. The reason code is shown on the template.
Paused / disabledLow quality rating; fix content or reduce sends.

Common rejection reasons

  • Missing or unrealistic variable samples.
  • Marketing content submitted under the Utility category.
  • Promotional language in what should be a transactional notification.
  • Broken or shortened URLs, or links that don't match your business.
  • Spelling and grammar errors, or ALL-CAPS shouting.