B S W A G I C
Documentation

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.
Create New Bulk Campaign
  • 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 name or order_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 name column, each message replaces name with 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.