Back to DocumentationMarketing Automation

Bulk Campaign

Send WhatsApp messages to thousands of recipients at once by uploading a CSV file containing contact information. Personalize each message with dynamic variables, select pre-approved templates, preview messages before sending, and automate marketing communications at scale.

Important Limitations

Only Passed Count Shown

After sending, the system displays only the number of successfully processed senders. It will not show details about which specific contacts succeeded or failed.

No Delivery Report

The system does not generate a delivery report. You will not receive a breakdown of which messages were delivered, failed, or bounced.

Server Timeout Risk

When sending to a large number of contacts, there is a risk of timeout or server crash on shared or low-resource hosting environments. Ensure your server has adequate memory and execution time limits.

No Batching - All at Once

The system processes all contacts in one operation. For example, if your CSV contains 5,000 records, the system will attempt to process all 5,000 in a single operation. Performance issues may occur on low-resource servers.

Clean CSV Required

Your CSV must be properly formatted. Any issues in the structure (missing headers, incorrect columns, unsupported characters) may cause the upload or sending process to fail.

We highly recommend downloading the sample CSV file, editing it with your own records, and then uploading it to eliminate most common formatting errors.

How to Create a New Bulk Campaign

Screenshot 1 - Bulk Campaign Creation Interface

Bulk campaign setup form showing campaign name input, CSV file upload area with drag-and-drop, and template selection dropdown.

1

Enter Campaign Name

Give your campaign a descriptive name to identify it later. Examples: Summer Sale 2025 or Newsletter June

2

Upload CSV File with Recipient Details

Upload a CSV file containing the list of recipients. Drag and drop the file into the upload box, or click to browse. Only CSV files are allowed.

CSV Format Requirements

ColumnRequiredDescription
FIRST NAMEYesRecipient's first name
LAST NAMEYesRecipient's last name
PHONEYesPhone number with country code and + sign (e.g., +1 555 123 4567)
EMAILRecommendedValid email address
COUNTRYOptionalRecipient's country

FIRST NAME,LAST NAME,PHONE,EMAIL,COUNTRY

Sample Data,Sample Data,+1 555 123 4567,[email protected],Sample Data

The first row must contain exact column headers. File must be UTF-8 encoded.

3

Choose a Message Template

WhatsApp requires using pre-approved message templates for bulk messaging. Select the appropriate template from the dropdown. Templates include fixed text and placeholders for dynamic content. Learn more about template management.

4

Set Dynamic Variables

Map dynamic variables in your template to columns in your CSV file. For example, if your template says "Hello name!" and your CSV has a name column, each message will replace the placeholder with the actual recipient name.

Screenshot 2 - Dynamic Variables Mapping

Variables configuration panel showing numbered input fields mapped to CSV columns with live message preview on the right.

5

Preview Your Message

Before sending, preview the final message to see exactly how it will appear to recipients. Dynamic variables are replaced with real data in the preview, helping you catch errors or formatting issues before messages go out.