WhatsApp template campaigns: parameters, header media, and validation

Build a WhatsApp broadcast using Meta-approved templates: fill body variables, attach an image or video in the header, and clear validation without delivery errors.

Jun 26, 2026

WhatsApp campaigns in Omnifox run on Meta-approved templates. A template is a pre-approved message that can carry variables ({{1}}, {{2}}...), a text or media header, and buttons. This guide shows how to fill those parameters correctly so your broadcast goes out without rejections.

Requirements

  • Available on all plans (from Lite), with monthly caps based on your plan: broadcasts per month, recipients per send and recipients per month.
  • A connected, active official WhatsApp channel (Cloud API or Coexistence). The WhatsApp via QR channel doesn't allow broadcasts.
  • Keep in mind that Meta charges separately for each template message sent.
  • At least one approved template on that channel. Templates that are pending or rejected won't appear in the picker.
  • The Manage broadcasts permission on your role.

Steps

  1. Open Broadcasts from the sidebar and click Create broadcast.
  2. Step 1 - Channel: pick your WhatsApp channel. Omnifox auto-detects the type as WhatsApp Template.
  3. Step 2 - Audience: choose who receives it (everyone, by groups, by tags, or by custom field). The estimated recipients counter updates automatically.
  4. Step 3 - Message: give the broadcast a name (internal reference only) and select the WhatsApp template. You'll see a Template Preview.
  5. Fill in the Template Parameters:
    • Header (text): if the header has variables, type each value.
    • Header (image/video/document): paste a public URL of the file into the header media field. It must be reachable from the internet (no private or local link).
    • Body: fill every {{N}} variable. You can personalize with {{first_name}}, {{last_name}}, {{company}}, and so on.
    • Button URLs: if the template has a dynamic URL button, enter the value substituted into the link.
  6. Step 4 - Schedule: choose Send now or Schedule for later (date and time).
  7. Step 5 - Review: confirm channel, audience, and message, then click Send broadcast (or Schedule broadcast).

Verify

After you confirm, Omnifox takes you to the broadcast detail screen, where you can watch the status and delivery progress. Each recipient shows its result as Meta confirms delivery.

If it doesn't work

  • No templates listed: make sure the template is approved by Meta and tied to the selected channel.
  • Can't move to step 4: validation requires every {{N}} variable in the body and text header to have a value, and the media URL to be filled when the header is image/video/document. Check the fields marked in red.
  • Meta rejects the send with an opaque error: it's almost always an empty variable or an unreachable media URL. Confirm the link opens in an incognito window.
  • You hit a plan cap: there are limits on broadcasts per month, recipients per send, and total recipients per month. When reached, the send button is blocked with a notice.

Tips

  • Host header images on stable storage (avoid temporary links that expire), because Meta downloads the file at send time.
  • Test the template on yourself by creating a one-contact audience before firing the full campaign.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp