Documentation:Message Templates Builder

WhatsApp Message Templates & Meta Review

The interactive visual template workshop. Draft Meta Cloud API compliant message templates with dynamic variable placeholders ({{1}}), call-to-action buttons, quick replies, and real-time approval status synchronization.

1. Purpose of the Page

Under Meta Platform Rules, any business-initiated WhatsApp message (such as broadcast campaigns, automated order updates, or messages sent after the 24-hour customer window has lapsed) requires a pre-approved message template. This page lets you compose templates, test how they look inside a live WhatsApp mobile mockup, and submit them directly to Meta Cloud API review without logging into Meta Business Manager.

2. Who Uses It (Target Roles)

Content & Copywriters

Drafts engaging messaging copy, verifies character limits, and formats dynamic personalization tokens.

Marketing Specialists

Selects appropriate Meta template categories (MARKETING vs. UTILITY) and adds trackable CTA URLs.

Developers & Integrators

References template names and parameter indexes ({{1}}, {{2}}) when triggering automated API dispatches.

Interactive Visual Preview

TemplateBuilderPage.tsx • /campaigns/templates
Meta v20.0 Synchronized
Template SpecificationReady to Submit
Submit to Meta Review
WhatsApp Preview Canvas
Package In Transit

Hi {{1}}, your order {{2}} has shipped! Track your package in real-time using the button below.

Thank you for choosing NotifyIQ.
🔗 Track Shipment
💬 Contact Support
Meta Status: APPROVED

3. Step-by-Step: Submitting a Message Template

  1. Define Template Identifier: Enter a lowercase name using only letters, numbers, and underscores (e.g. order_update_v1). Special characters, spaces, and capital letters are automatically sanitized.
  2. Choose the Category: Select UTILITY for order/shipping updates, account alerts, and billing receipts; MARKETING for promotions, discounts, and brand awareness; or AUTHENTICATION for one-time passwords (OTPs).
  3. Compose Body with Placeholders: Write your message text. Insert dynamic positional variables by typing {{1}}, {{2}}, etc. Ensure numbered placeholders appear sequentially without skipping indexes.
  4. Add Interactive Buttons (Optional): Configure a Call-to-Action (URL) button (e.g., “Track Order” pointing to your web tracking link) or add Quick Reply buttons for quick user answers.
  5. Submit to Meta Cloud API: Click Submit to Meta Review. NotifyIQ communicates with Meta Graph API v20.0. Most utility and marketing templates are reviewed within 1 to 5 minutes by Meta's automated AI policy checks.

4. Template Fields & Meta Specifications

ComponentCharacter LimitsFormatting AllowedMeta Policy Notes
HeaderMax 60 chars (Text)TEXT, IMAGE, VIDEO, or DOCUMENTBold headline or media banner rendered at the top of the bubble.
BodyMax 1,024 charsBold (*), Italic (_), Variables {{1}}Mandatory core text. Variables cannot be placed at the very start or end of the text.
FooterMax 60 charsPlain text only (no variables)Disclaimers, opt-out guidance (e.g. “Reply STOP to unsubscribe”).
ButtonsMax 25 chars / buttonUp to 2 URL/Phone CTAs or 3 Quick RepliesInteractive pills that allow one-tap customer actions.

5. Behind the Scenes: Meta Cloud API Integration

When submitting a template, NotifyIQ calls POST /api/waba/templates which executes against Meta Graph API:

  • Meta API Call: POST /v20.0/{business_account_id}/message_templates passing the formatted components array (HEADER, BODY, FOOTER, BUTTONS).
  • Template Status Sync: NotifyIQ polls and processes webhook events for message_template_status_update, automatically reflecting status changes from PENDING to APPROVED or REJECTED.
  • Template Deletion: Calling delete triggers DELETE /v20.0/{business_account_id}/message_templates?name={name}, safely unregistering the template from Meta servers.

6. Common Errors & FAQs

Why was my template REJECTED by Meta?

Common reasons include: using promotional wording in a template marked as UTILITY, placing variable placeholders at the very beginning or end of the body without enclosing words, or using vague variable samples. Ensure your template category aligns with its content.

How long does Meta template approval take?

Most standard templates are approved automatically within 1 to 5 minutes by Meta's AI safety scanners. Templates requiring human review can take up to 24 hours.