Skip to content

Commit 2ceba27

Browse files
committed
Add CSV upload for campaign recipients with validation
- Add CSV file upload option in Add Recipients dialog - Validate CSV columns against template parameters - Detect and flag duplicate phone numbers - Show validation preview with error details per row - Update campaigns documentation with CSV upload guide - Remove redundant screenshot folder (images already in docs)
1 parent a2e1886 commit 2ceba27

18 files changed

+517
-44
lines changed

docs/src/content/docs/features/campaigns.mdx

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,60 @@ Campaigns allow you to send bulk WhatsApp messages to multiple contacts at once.
3737

3838
</Steps>
3939

40+
## Adding Recipients
41+
42+
You can add recipients to your campaign in two ways:
43+
44+
### Manual Entry
45+
46+
Add recipients one at a time by entering:
47+
- **Phone Number** - The recipient's WhatsApp number (with country code)
48+
- **Name** - Optional display name
49+
- **Parameters** - Template variable values for personalization
50+
51+
### CSV Upload
52+
53+
For bulk imports, upload a CSV file with your recipient data:
54+
55+
<Steps>
56+
57+
1. **Prepare Your CSV**
58+
59+
Create a CSV file with columns for phone number, name, and template parameters:
60+
```csv
61+
phone,name,param1,param2
62+
+1234567890,John Doe,Order #123,December 25
63+
+0987654321,Jane Smith,Order #456,December 26
64+
```
65+
66+
2. **Upload and Validate**
67+
68+
The system automatically validates your CSV against the selected template:
69+
- Checks for required phone number column
70+
- Validates parameter count matches template requirements
71+
- Detects duplicate phone numbers
72+
- Shows validation errors per row
73+
74+
3. **Review and Import**
75+
76+
Preview the validation results before importing:
77+
- View first 50 rows with status indicators
78+
- See error details for invalid rows
79+
- Only valid rows will be imported
80+
81+
</Steps>
82+
83+
<Aside type="tip">
84+
**CSV Column Names**: The system recognizes various column names:
85+
- Phone: `phone`, `phone_number`, `mobile`, `number`
86+
- Name: `name`, `contact_name`, `customer_name`
87+
- Parameters: `param1`, `param2`, etc. or `variable1`, `variable2`, etc.
88+
</Aside>
89+
90+
<Aside type="caution">
91+
**Duplicate Detection**: If the same phone number appears multiple times in your CSV, only the first occurrence will be valid. Subsequent duplicates will be flagged as errors.
92+
</Aside>
93+
4094
## Campaign Details
4195

4296
![Campaign Details](/whatomate/images/14-campaign-details.png)

0 commit comments

Comments
 (0)