Bulk Campaign
The Bulk Campaign feature in Bswagic allows you to send WhatsApp messages to many recipients at once by uploading a CSV file that contains their contact information. This tool helps you save time and effort by automating marketing messages, notifications, and other important communications.
- IMPORTANT NOTES : Please read these limitations carefully before proceeding:
- • Only Passed Count Shown : After sending completes, only the number of successfully processed senders is displayed. Specific contact success or failure details are not shown.
- • No Delivery Report : The system does not generate a delivery report. No breakdown of delivered, failed, or bounced messages is available.
- • Server Timeout or Crash : Sending to many contacts may cause timeouts or crashes on shared or low-resource hosting. Ensure sufficient memory and execution time limits.
- • PHP Timeout Issue : Increase PHP execution time limit if timeout errors occur. This requires server-side configuration changes by your hosting provider or administrator.
- • No Batching – All at Once : Bulk imports process all records at once. For example, a CSV with 5,000 rows will attempt to process all 5,000 simultaneously. Performance depends on server capacity and resources.
- • Requires Clean CSV : Ensure your CSV is properly formatted with correct headers, columns, and supported characters. Use the sample CSV provided to avoid formatting errors and ensure smooth import.
How to Create a New Bulk Campaign
Follow these simple steps to create and send your bulk WhatsApp messages:
-
1. Enter Campaign Name
: First, give your campaign a name to identify it later.
- • Example : Summer Sale 2025 or Newsletter June
- • Instruction : Type the name into the Campaign Name input box.
-
2. Upload CSV File with Recipient Details
: To send bulk messages, upload a CSV file containing recipients and their details.
- • CSV Columns : Include phone numbers and any personalization fields (e.g., names, order IDs).
- • File Format : Ensure correct formatting. A sample CSV and instructions are available for guidance.
- • Upload Options : You can either drag and drop the file into the dashed upload box or click inside the box to browse and select it from your computer.
- CSV Format Requirements
- • Mandatory Columns
- • FIRST NAME : required
- • LAST NAME : required
- • PHONE : required — must include country code and + sign (e.g., +1 555 123 4567)
- • EMAIL : optional but recommended
- • COUNTRY : optional
- • Header Row : The first row of the CSV must contain the exact column headers as listed above.
- • Encoding : The file must be encoded in UTF-8 to prevent character or formatting issues.
-
3. Choose a Message Template
: WhatsApp requires using pre-approved message templates for bulk messaging.
- • Template Selection : After uploading your CSV file, select the appropriate template from the dropdown menu.
- • Template Details : Templates include fixed text and placeholders for dynamic content.
- • Importance : Choosing the correct template ensures compliance with WhatsApp policies and successful message delivery.
-
4. Set Dynamic Variables
: Many templates include placeholders for personalized data, such as
nameororder_number.- • Mapping : Map the dynamic variables in your template to the columns in your CSV file.
-
•
Example
: If the template says "Hello name!" and your CSV has a
namecolumn, each message replacesnamewith the actual recipient's name. - • Purpose : Personalization makes messages feel more personal and increases engagement.
-
5. Preview Your Message
: Before sending, preview the message to see how it appears to recipients.
- • Dynamic Replacement : The preview shows how dynamic variables are replaced with real data.
- • Benefit : Helps catch errors or formatting issues before sending.