Skip to main content

​
Overview

WhatsApp Campaigns allow you to send template messages to multiple phone numbers at once using a CSV file. Access:
  • Create Campaign: https://callkaro.ai/dashboard/whatsapp/campaign/create
  • View Analytics: https://callkaro.ai/dashboard/whatsapp/campaign

​
Creating a Campaign

1

Name Your Campaign

Enter a descriptive campaign name
2

Choose Phone Number

Select your WhatsApp phone number to send from
3

Choose Template

Select an approved WhatsApp template
4

Prepare CSV File

Create CSV with proper column headers:Required Columns:
  • First column: phone (always phone numbers)
Parameter Columns (if template has variables):
  • Header variables: header_0
  • Body variables: body_0, body_1, body_2, etc.
  • Button variables: button_0, button_1, button_2, etc.
5

Upload CSV

Upload your prepared CSV file
6

Send Campaign

Click “Send” to start the campaign
Test first! Always test your CSV with your own phone number before sending to all contacts.

​
CSV Format

​
Example Template

Template: “Hi {{1}}, your order {{2}} is confirmed!”

​
CSV Structure

phone,body_0,body_1
+919876543210,John,ORD123
+919876543211,Jane,ORD124
+919876543212,Bob,ORD125

​
Column Headers Reference

Template VariableCSV Column Header
Header {{1}}header_0
Body {{1}}body_0
Body {{2}}body_1
Body {{3}}body_2
Button {{1}}button_0
Button {{2}}button_1
First column must always be phone with phone numbers in international format (e.g., +919876543210)

​
Complete CSV Example

Template with header, body, and button variables: 
phone,header_0,body_0,body_1,button_0
+919876543210,John,Premium Plan,Dec 25,CONFIRM123
+919876543211,Jane,Basic Plan,Dec 26,CONFIRM124
+919876543212,Bob,Pro Plan,Dec 27,CONFIRM125
Maps to:
  • Header: Hi {{1}} (John/Jane/Bob)
  • Body: Your {{1}} subscription starts on {{2}} (Premium Plan + Dec 25)
  • Button: Track order: {{1}} (CONFIRM123)

​
Testing Your Campaign

1

Create Test CSV

Make a CSV with only your phone number
phone,body_0,body_1
+919876543210,Test Name,Test Value
2

Upload and Send

Upload test CSV and send
3

Verify Message

Check your WhatsApp for the message
  • Verify template renders correctly
  • Confirm variables populated properly
4

Fix Issues

If needed, adjust CSV format and retest
5

Send Full Campaign

Once test succeeds, upload full contact list

​
Campaign Analytics

View campaign performance at: https://callkaro.ai/dashboard/whatsapp/campaign

​
Metrics Available

Messages Sent
  • Total messages successfully sent
Messages Errored
  • Failed deliveries (invalid numbers, blocked users, etc.)
Messages Seen
  • Messages read by recipients
  • Note: Only counts users with “Read Receipts” enabled
  • Users with read receipts OFF are NOT counted
Seen count may be lower than actual reads due to privacy settings.

​
Best Practices

  • Send to your own number first
  • Verify all variables populate correctly
  • Check message formatting
  • International format: +[country code][number]
  • India: +919876543210
  • No spaces or dashes
  • Use body_0, body_1, NOT body1 or Body_0
  • Case-sensitive
  • Numbering starts from 0
  • No extra columns
  • No empty rows
  • Proper UTF-8 encoding

​
Troubleshooting

Check:
  • Template is APPROVED
  • Phone number is CLOUD_API
  • CSV format is correct
  • Phone numbers in international format
Issue: Template shows {{1}} instead of valuesSolution:
  • Verify CSV column headers match exactly
  • Check body_0, body_1 numbering
  • Ensure no typos in headers
Common causes:
  • Invalid phone numbers
  • Blocked by recipients
  • WhatsApp account limits reached
Solution:
  • Validate phone numbers
  • Check Meta quality rating
  • Spread campaigns over time
Why: Many users disable read receiptsNote: This is normal. Seen count only includes users with read receipts ON. Actual read rate is likely higher.

WhatsApp Templates

Create and manage templates

WhatsApp Phone Numbers

Manage your numbers