DocsMass Campaigns
Back to Docs

Mass Campaigns

Send bulk WhatsApp messages to your contact list using approved templates.

Requirements Before Starting

Before creating a campaign, ensure you have:
β€’ A WABA (Official API) instance connected β€” Campaigns do NOT work with WhatsApp Web/Baileys.
β€’ An approved Meta message template (approval takes 2-24 hours via Meta Business Manager).
β€’ A CSV/Excel file with your contacts' phone numbers.

Warning: Sending unsolicited bulk messages can get your WhatsApp number banned. Only message people who have opted in.

Creating a Campaign Step-by-Step

1. Go to Dashboard β†’ Campaigns β†’ New Campaign.

2. Step 1 β€” Details:
   β€’ Enter a campaign name.
   β€’ Select your WABA instance.
   β€’ Optionally set a scheduled date/time to send later.
   β€’ Click Next.

3. Step 2 β€” Leads:
   β€’ Upload a .xlsx file. Required column: phone (format: 923001234567).
   β€’ Add optional variable columns (e.g. name, product) to personalize messages.
   β€’ Preview your leads and click Next.

4. Step 3 β€” Content:
   β€’ Select a WABA template from your approved templates.
   β€’ Map your spreadsheet columns to the template's variables.
   β€’ Preview the final message.

5. Click Finish & Create. The campaign will be queued (or scheduled).

Monitoring Campaign Results

After creating, go to Campaigns and click on your campaign to view:
β€’ Total Leads β€” Number of contacts in the list.
β€’ Sent β€” Successfully delivered.
β€’ Failed β€” Delivery failed (invalid number, blocked, etc.).
β€’ Pending β€” Not yet processed.

Common failure reasons:
β€’ Invalid phone number format.
β€’ Contact has blocked your number.
β€’ Daily messaging limit reached.