Skip to main content

Broadcast Campaigns

Broadcast Campaigns allow you to send WhatsApp messages to a large list of contacts at once.

Campaigns

🏢 Business Owner's Guide (Non-Technical)​

1. Preparing Your Audience​

  1. Go to the Contacts page.
  2. Import your customer list via Excel or manually add contacts.
  3. Use Tags to group your contacts (e.g., "Holiday Sale", "VIP Customers").

2. Creating a Campaign​

  1. Navigate to Campaigns and click (+) New Campaign.
  2. Name your campaign (e.g., "Monthly Newsletter").
  3. Select your Target: Filter by tags or select all contacts.
  4. Choose a Template: Select an approved WhatsApp Template.
  5. Schedule: Send immediately or pick a future date and time.

3. Monitoring Results​

Once sent, click on the campaign to see:

  • Sent: Total messages dispatched.
  • Delivered: Messages reached the customer's phone.
  • Read: Customers who actually opened the message.
  • Failed: Messages that couldn't be delivered (e.g., invalid number).

🛠️ Technical Administrator's Guide (Deep-Dive)​

1. Batch Processing​

Campaigns are processed in batches of 20 messages every 5 seconds to comply with Meta's rate limits and ensure high delivery rates.

2. Status Tracking​

The system polls Meta for status updates for 72 hours after a campaign is sent.

  • Sent -> Delivered -> Read
  • If a message fails, the reason (e.g., capability_mismatch) is logged in the MessageLog.

3. Campaign Lifecycle​

  • Draft: Created but not yet scheduled.
  • Scheduled: Waiting for the CampaignService background worker to pick it up.
  • Processing: Messages are currently being sent.
  • Completed: All messages have been attempted.

🎥 Video Tutorials​