Importing recipients from CSV

Upload a CSV file to add hundreds or thousands of recipients to your campaign at once.

CSV format

Your CSV must have at minimum a phone number column. Additional columns map to template variables.

Basic format (no personalization)

phone_number,name
+919876543210,John Doe
+919876543211,Jane Smith
+919876543212,Bob Wilson

With template parameters

If your template has variables like {{1}}, {{2}}, {{3}}:

phone_number,name,order_id,delivery_date
+919876543210,John Doe,ORD-123,May 30
+919876543211,Jane Smith,ORD-456,May 31
+919876543212,Bob Wilson,ORD-789,June 1

Column mapping:

• Column 1 (phone_number) → recipient phone
• Column 2 (name) → {{1}} (first variable)
• Column 3 (order_id) → {{2}} (second variable)
• Column 4 (delivery_date) → {{3}} (third variable)

How to import

1. In your campaign, click "Add Recipients"
2. Select the "CSV" tab
3. Click "Choose File" and select your CSV
4. AIsoule validates the file:
   • Checks phone number format
   • Verifies column count matches template variables
   • Reports any invalid rows
5. Click "Import"

Validation

AIsoule checks each row for:

• ✅ Valid phone number (with country code)
• ✅ Correct number of columns (matching template variables)
• ❌ Invalid rows are skipped with an error message

Download sample CSV

Click "Download Sample" in the CSV tab to get a pre-formatted CSV template that matches your selected message template.

After import

• Recipients appear in the campaign's recipient list
• You'll be asked if you want to save them as a reusable contact list
• Duplicate phone numbers are automatically skipped

Tips

1. Always include country code — +91 for India, +1 for US
2. Remove formatting — No spaces, dashes, or parentheses in phone numbers
3. Use UTF-8 encoding — For special characters and non-English names
4. Test with 10 rows first — Verify format before importing thousands
5. Check the sample — Download the sample CSV to see the exact format needed