Campaigns
Send broadcast WhatsApp messages to your contacts, groups, or tags — with scheduling and delivery tracking.
Overview
Campaigns let you message many contacts at once. Access via Campaigns in the sidebar (/campaigns). Each campaign creates individual recipient records and tracks send status per contact.
Audience selection
| Audience type | Description |
|---|---|
| All contacts | Every contact in your account (excluding opted-out) |
| Contact groups | One or more groups you created |
| Contact tags | Contacts matching selected tags |
| Filter | Custom audience rules |
Create a campaign
-
Go to Campaigns → Create
Enter campaign name and choose message type (text or template).
-
Write message
For text: write your message body. Use placeholders like
{name}for personalization. -
Select audience
Pick all contacts, groups, tags, or a filter.
-
Schedule or send now
Leave schedule empty for immediate send, or set a future date/time.
-
Launch
Review recipient count and confirm. Campaign status changes to processing.
Scheduling & processing
Scheduled campaigns start automatically when the scheduled time arrives. Processing requires cron to be configured (see Installation → Cron jobs).
Campaign statuses:
- draft — Created but not started
- scheduled — Waiting for scheduled time
- processing — Sending to recipients
- completed — All recipients processed
- cancelled — Stopped by user
Delivery tracking
Each recipient has a status: pending, sent, delivered, read, or failed. Status updates come from WhatsApp webhook delivery receipts. View campaign details to see per-recipient status and counts.
Limits & opt-out
- Each sent message counts toward your plan's message limit
- Contacts marked opted out are excluded from campaigns
- Respect WhatsApp's messaging policies — only message contacts who opted in
- Large campaigns are processed in batches via queue/cron to avoid rate limits