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.
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 broadcastspermission on your role.
Steps
- Open Broadcasts from the sidebar and click Create broadcast.
- Step 1 - Channel: pick your WhatsApp channel. Omnifox auto-detects the type as WhatsApp Template.
- Step 2 - Audience: choose who receives it (everyone, by groups, by tags, or by custom field). The estimated recipients counter updates automatically.
- Step 3 - Message: give the broadcast a name (internal reference only) and select the WhatsApp template. You'll see a Template Preview.
- 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.
- Step 4 - Schedule: choose Send now or Schedule for later (date and time).
- 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
Related articles
-
How to create a broadcast campaign
Create, segment and schedule a broadcast to your contacts step by step in Omnifox.
-
Best practices to broadcast without getting blocked
Reduce spam reports and blocks by following these rules when sending broadcasts on WhatsApp and other channels.
-
What a campaign is and its statuses (draft, scheduled, sending, completed)
What a broadcast campaign is in Omnifox and what its statuses mean: draft, scheduled, sending and completed.
-
Supported broadcast channels (WhatsApp, Email, SMS, Telegram)
Learn which channels you can use to send broadcasts in Omnifox and what each one requires.
-
Segment your audience: everyone, groups, tags (AND/OR) and custom field
Learn to precisely choose who receives your broadcast by combining groups, tags with AND/OR logic and custom fields.