# Contact List Campaigns
Contact list campaigns allow you to send WhatsApp messages to large numbers of individual contacts using multiple WhatsApp accounts for increased speed and deliverability. This campaign type is perfect for lead generation, customer re-engagement, and personalized mass communication.
{% hint style="success" %}
**Scalable Outreach**: Distribute campaigns across multiple WhatsApp accounts to send thousands of messages per day while staying within safe limits per account.
{% endhint %}
## Campaign Creation Process
### Step 1: Campaign Settings & Message Crafting
#### Campaign Configuration
**Basic Settings:**
* **Campaign Name**: Descriptive name for internal organization
* **Contacts Per Day Per Phone**: Maximum messages each WhatsApp account sends daily
* **Start Date**: When the campaign begins sending messages
* **Time Zone**: Campaign timing reference for scheduling
**Daily Limit Recommendations:**
* **New Accounts**: 20-30 messages per day
* **Warm Accounts**: 50-100 messages per day
* **Established Business Accounts**: 100-200 messages per day
{% hint style="warning" %}
**Safe Limits**: Start conservatively and increase limits gradually based on account performance and recipient response quality.
{% endhint %}
#### Message Variation Creation
Create multiple message variants to avoid repetitive content and reduce spam detection:
**Message Variation Benefits:**
* **Reduced Pattern Detection**: Different messages appear more organic
* **A/B Testing**: Compare performance of different approaches
* **Audience Segmentation**: Different variants can appeal to different segments
* **Natural Appearance**: Avoid looking like mass broadcast
**Variation Elements:**
* **Message Content**: Different wording, tone, or approach
* **Call-to-Action**: Various ways to request response or action
* **Personalization Level**: Different degrees of customization
* **Message Length**: Short vs. detailed versions
#### Multi-Part Message Sequences
Break messages into natural conversation sequences:
**Sequential Message Benefits:**
* **Natural Conversation Flow**: Appears as ongoing conversation
* **Increased Engagement**: Recipients more likely to read shorter messages
* **Reduced Spam Appearance**: Multiple messages feel more personal
* **Better Pacing**: Control information delivery timing
**Example Multi-Part Sequence:**
```
Message 1: "Hi {{first_name}}, hope you're doing well!"
[2-3 second delay]
Message 2: "I wanted to share something that might interest you based on your work in {{industry}}..."
[3-4 second delay]
Message 3: "Would you be open to a quick 5-minute conversation about how this could help your business?"
```
### Attachment Integration
Add rich media to enhance message effectiveness:
**Supported Attachment Types:**
* **Images**: Product photos, infographics, screenshots
* **Videos**: Product demos, testimonials, explainer videos
* **Documents**: Brochures, price sheets, case studies
* **Audio**: Voice messages, podcast clips, audio testimonials
**Attachment Best Practices:**
* **Relevant Content**: Ensure attachments add value to message
* **Professional Quality**: High-quality, branded materials
* **File Size Management**: Keep files reasonably sized for mobile
* **Format Compatibility**: Use widely supported file formats
**Attachment Distribution:** Each message variant can have different attachments, and multi-part messages can distribute attachments across different parts of the sequence.
### Step 2: Contact Selection Methods
WhatSnap provides five different methods to build your campaign contact list:
{% tabs %}
{% tab title="Import CSV" %}
**CSV File Import**
Upload contact lists using a standardized CSV format.
**Required CSV Format:**
```csv
name,phone,context
John Smith,+1234567890,Met at trade show
Sarah Johnson,+1987654321,Website inquiry
Mike Chen,+1555123456,Referral from existing client
```
**CSV Requirements:**
* **Name Column**: Contact's full name for personalization
* **Phone Column**: Complete phone number with country code
* **Context Column**: Additional context for personalization (optional but recommended)
**Import Process:**
1. **Prepare CSV**: Format your contact data according to specifications
2. **Upload File**: Select and upload your CSV file
3. **Field Mapping**: Verify column mapping is correct
4. **Data Validation**: Review imported contacts for accuracy
5. **Duplicate Handling**: Resolve any duplicate entries
**CSV Best Practices:**
* **Clean Data**: Remove invalid or incomplete entries
* **Phone Formatting**: Include country codes for international contacts
* **Context Value**: Include meaningful context for better personalization
* **Regular Updates**: Keep contact information current
{% endtab %}
{% tab title="WhatsApp Group Export" %}
**Extract Contacts from WhatsApp Groups**
Pull contact information from WhatsApp groups for targeted outreach.
**Group Export Process:**
1. **Group Link Input**: Paste WhatsApp group invite links
2. **Member Extraction**: WhatSnap extracts member phone numbers
3. **Contact Creation**: Converts group members to campaign contacts
4. **Multiple Groups**: Support for extracting from multiple groups simultaneously
**Group Export Benefits:**
* **Targeted Audiences**: Groups often contain relevant, interested contacts
* **Pre-Qualified Lists**: Members likely share common interests
* **Easy Scaling**: Quickly build large contact lists
* **Context Relevance**: Group membership provides context for personalization
**Important Considerations:**
* **Permission**: Ensure appropriate permissions for group member contact
* **Relevance**: Only use groups where your offering would be welcome
* **Quality Over Quantity**: Focus on relevant groups rather than maximum numbers
* **Respect Privacy**: Honor members' privacy expectations
{% hint style="info" %}
**Bulk Group Messaging**: If your goal is to message WhatsApp groups directly, use [Group Campaigns](https://github.com/WhatSnap/documentation/blob/main/Outreach/group-campaigns.md) instead of extracting individual contacts.
{% endhint %}
{% endtab %}
{% tab title="GHL Contacts" %}
**GoHighLevel Contact Integration**
Select contacts from your existing GoHighLevel database using tag-based filtering.
**GHL Contact Selection:**
* **Tag-Based Filtering**: Select contacts based on assigned tags
* **Multiple Tag Support**: Combine multiple tags for precise targeting
* **Dynamic Lists**: Include contacts that gain relevant tags after campaign creation
* **Integration Benefits**: Leverage existing contact data and history
**Tag-Based Campaign Examples:**
* **Industry Targeting**: Select all contacts tagged "Healthcare" or "Real Estate"
* **Engagement Level**: Target "Engaged Leads" or "Previous Customers"
* **Geographic Filtering**: Select contacts tagged with specific regions
* **Behavior-Based**: Target contacts tagged based on previous interactions
**GHL Integration Advantages:**
* **Rich Contact Data**: Access to complete contact profiles and history
* **Segmentation Power**: Use sophisticated tag combinations
* **CRM Integration**: Seamless integration with existing workflows
* **Performance Tracking**: Enhanced tracking through GHL analytics
**Selection Process:**
1. **Tag Selection**: Choose relevant tags from your GHL system
2. **Contact Preview**: Review selected contacts before campaign creation
3. **Data Validation**: Ensure contacts have required phone numbers
4. **List Refinement**: Add or remove specific contacts as needed
{% endtab %}
{% tab title="Previous Campaign" %}
**Reuse Contacts from Previous Campaigns**
Leverage contact lists from successful previous campaigns.
**Previous Campaign Benefits:**
* **Proven Audiences**: Reuse lists that have performed well
* **Easy Segmentation**: Target responders vs. non-responders from previous campaigns
* **Campaign Sequences**: Create follow-up campaigns for specific audiences
* **Performance Optimization**: Build on successful campaign foundations
**Campaign Reuse Options:**
* **Full List Reuse**: Use entire previous campaign contact list
* **Response-Based Filtering**: Target only responders or non-responders
* **Engagement Filtering**: Select based on previous engagement levels
* **Custom Segmentation**: Combine previous campaign data with new criteria
**Follow-Up Campaign Strategies:**
* **Non-Responder Re-engagement**: Target non-responders with different messaging
* **Responder Advancement**: Move engaged contacts to next campaign stage
* **Segmented Messaging**: Different messages based on previous responses
* **Campaign Series**: Create connected campaign sequences
**Selection Process:**
1. **Campaign Selection**: Choose from your previous campaigns
2. **Filtering Options**: Apply response or engagement filters
3. **List Review**: Verify selected contacts meet current campaign needs
4. **Messaging Adjustment**: Adapt messages based on previous interactions
{% endtab %}
{% tab title="Manual Addition" %}
**Add Contacts Manually**
Directly input individual contacts for small, targeted campaigns.
**Manual Addition Process:**
1. **Contact Entry**: Input name, phone number, and context
2. **Batch Addition**: Add multiple contacts in sequence
3. **Data Validation**: Verify contact information accuracy
4. **List Management**: Review and organize manually added contacts
**When to Use Manual Addition:**
* **Small VIP Lists**: High-value contacts requiring personal attention
* **Test Campaigns**: Limited lists for campaign testing
* **Specific Targeting**: Contacts that don't fit other import methods
* **Quality Control**: When you need maximum control over contact quality
**Manual Addition Benefits:**
* **Complete Control**: Full control over each contact added
* **Quality Assurance**: Verify each contact individually
* **Contextual Information**: Add rich context for each contact
* **Personalization Setup**: Prepare personalized approaches for each contact
**Best Practices:**
* **Double-Check Data**: Verify phone numbers and names carefully
* **Rich Context**: Add meaningful context for personalization
* **Systematic Approach**: Use consistent formatting and information
* **Quality Over Quantity**: Focus on high-value, relevant contacts
{% endtab %}
{% endtabs %}
### Step 3: Contact Management & Distribution
{% stepper %}
{% step %}
#### Contact Review & Organization
After importing contacts, review and organize your campaign list:
**Contact List Management:**
* **Duplicate Removal**: Identify and handle duplicate entries
* **Data Validation**: Verify phone numbers and contact information
* **Contact Enrichment**: Add additional context or segmentation data
* **Quality Assessment**: Remove low-quality or irrelevant contacts
**Segmentation Options:**
* **Geographic Segmentation**: Group by location or region
* **Industry Segmentation**: Organize by business type or industry
* **Engagement History**: Segment based on previous interactions
* **Custom Categories**: Create custom groupings based on campaign needs
{% endstep %}
{% step %}
#### WhatsApp Account Distribution
Distribute contacts across multiple WhatsApp accounts for optimal performance:
**Distribution Strategies:**
{% tabs %}
{% tab title="Even Distribution" %}
**Balanced Account Loading**
Distribute contacts evenly across all available WhatsApp accounts.
**Benefits:**
* **Risk Distribution**: Spread risk across multiple accounts
* **Optimal Speed**: Maximize sending speed with parallel accounts
* **Balanced Load**: Prevent overloading any single account
* **Performance Tracking**: Compare account performance equally
**Example Distribution:**
* 1,000 contacts across 4 accounts = 250 contacts per account
* Each account sends 50 messages/day = Campaign completes in 5 days
{% endtab %}
{% tab title="Account Specialization" %}
**Purpose-Based Distribution**
Assign specific account types to appropriate contact segments.
**Specialization Examples:**
* **Geographic**: East/West coast accounts for regional contacts
* **Industry**: Specialized accounts for different industry verticals
* **Stage-Based**: Different accounts for leads vs. customers
* **Performance-Based**: High-performing accounts for priority contacts
**Benefits:**
* **Relevance**: Match account characteristics to contact needs
* **Performance**: Use best-performing accounts for important segments
* **Organization**: Clear account purposes and responsibilities
* **Tracking**: Better attribution and performance analysis
{% endtab %}
{% tab title="Custom Allocation" %}
**Manual Account Assignment**
Manually assign specific contacts or segments to preferred accounts.
**Custom Assignment Benefits:**
* **Full Control**: Complete control over account-contact matching
* **Strategic Planning**: Align account capabilities with contact importance
* **Risk Management**: Protect high-value accounts by careful assignment
* **Performance Optimization**: Use historical data to inform assignments
**Assignment Considerations:**
* **Account Performance History**: Use best performers for important contacts
* **Account Warmth**: Match account establishment to contact importance
* **Geographic Relevance**: Align account locations with contact regions
* **Capacity Planning**: Ensure realistic daily limits per account
{% endtab %}
{% endtabs %}
{% endstep %}
{% step %}
#### Campaign Timeline Planning
Calculate and optimize campaign timeline:
**Timeline Factors:**
* **Total Contacts**: Number of contacts in campaign
* **WhatsApp Accounts**: Number of accounts available for distribution
* **Daily Limits**: Messages per day per account
* **Campaign Duration**: Total days required to complete campaign
**Timeline Calculation:**
```
Campaign Duration = Total Contacts ÷ (Number of Accounts × Daily Limit per Account)
Example:
2,000 contacts ÷ (5 accounts × 50 messages/day) = 8 days
```
**Timeline Optimization:**
* **Add Accounts**: Reduce duration by adding more WhatsApp accounts
* **Adjust Limits**: Increase daily limits for established accounts
* **Prioritize Segments**: Send high-priority contacts first
* **Stagger Start**: Begin with smaller test group before full campaign
{% endstep %}
{% endstepper %}
### Step 4: Campaign Review & Launch
{% stepper %}
{% step %}
#### Pre-Launch Review
**Campaign Details Verification:**
* **Campaign Name**: Descriptive and organized naming
* **Start Date**: Appropriate timing for your audience
* **Contact Count**: Verify total contacts to be reached
* **Daily Limits**: Confirm sustainable sending rates
* **Account Distribution**: Review contact allocation across accounts
**Message Quality Check:**
* **Content Review**: Verify all message variants are well-written
* **Personalization Test**: Confirm merge fields work correctly
* **Attachment Verification**: Test all attachments load properly
* **Link Testing**: Verify all links are functional and tracked
* **Mobile Optimization**: Ensure content displays well on mobile devices
**Timeline Confirmation:**
* **Completion Estimate**: Review estimated completion date
* **Resource Allocation**: Ensure team capacity for response handling
* **Monitoring Plan**: Prepare performance tracking and monitoring
* **Response Management**: Set up processes for handling replies
{% endstep %}
{% step %}
#### Campaign Launch
**Launch Process:**
1. **Final Verification**: Last-minute check of all campaign elements
2. **Team Notification**: Alert team members about campaign start
3. **Monitoring Setup**: Activate performance tracking and alerts
4. **Campaign Activation**: Launch the campaign
**Post-Launch Immediately:**
* **Delivery Monitoring**: Watch initial message delivery rates
* **Account Health Check**: Monitor WhatsApp account status
* **Response Handling**: Begin managing incoming responses
* **Performance Tracking**: Start collecting campaign metrics
**First Hour Checklist:**
* [ ] Messages sending successfully from all accounts
* [ ] No account warnings or restrictions
* [ ] Attachments delivering properly
* [ ] Response tracking functioning
* [ ] Team ready for incoming replies
{% endstep %}
{% endstepper %}
## Campaign Performance Optimization
### During Campaign Execution
**Real-Time Monitoring:**
* **Delivery Rates**: Monitor successful message delivery across accounts
* **Response Quality**: Track positive vs. negative responses
* **Account Health**: Watch for any account restrictions or warnings
* **Engagement Metrics**: Monitor open rates and response times
**Mid-Campaign Adjustments:**
* **Message Optimization**: Adjust underperforming message variants
* **Account Rebalancing**: Redistribute load if accounts perform differently
* **Timing Adjustments**: Modify sending times based on response patterns
* **Content Refinement**: Update content based on early feedback
### Campaign Analytics
**Key Performance Indicators:**
* **Delivery Rate**: Percentage of messages successfully delivered
* **Open Rate**: Percentage of recipients who read messages
* **Response Rate**: Percentage of recipients who respond
* **Conversion Rate**: Percentage achieving campaign objectives
* **Account Performance**: Individual WhatsApp account effectiveness
**Performance Analysis:**
* **Variant Comparison**: Compare performance of different message variants
* **Account Comparison**: Identify best and worst performing accounts
* **Timing Analysis**: Determine optimal sending times
* **Audience Segmentation**: Identify highest-performing contact segments
## Best Practices for Contact Campaigns
### Contact Quality Management
{% hint style="success" %}
**Quality Over Quantity**: Focus on high-quality, relevant contacts rather than maximum volume. Better contacts lead to better results and account safety.
{% endhint %}
**Contact Quality Factors:**
* **Relevance**: Contacts should have genuine interest in your offering
* **Permission**: Contacts should expect or welcome your communication
* **Current Information**: Phone numbers and details should be up-to-date
* **Context**: Rich context enables better personalization and relevance
### Message Personalization
**Personalization Strategies:**
* **Name Usage**: Include first names naturally in conversations
* **Context Integration**: Reference how you obtained their contact information
* **Industry Relevance**: Tailor content to their business or interests
* **Behavioral Triggers**: Reference previous interactions or behaviors
**Merge Field Examples:**
* `{{first_name}}`: Personal name usage
* `{{company}}`: Company or business name
* `{{industry}}`: Industry or business type
* `{{context}}`: How you obtained their information
* `{{location}}`: Geographic or regional references
### Campaign Safety
**Account Protection:**
* **Conservative Limits**: Start with lower daily limits and increase gradually
* **Quality Messaging**: Ensure all content is valuable and non-spammy
* **Response Monitoring**: Track recipient feedback and adjust accordingly
* **Account Rotation**: Don't overuse any single WhatsApp account
* **Opt-Out Respect**: Honor unsubscribe requests immediately
## Troubleshooting Contact Campaigns
### Common Issues and Solutions
Low Delivery Rates
**Possible Causes:**
* WhatsApp accounts disconnected or restricted
* Invalid phone numbers in contact list
* Daily limits set too high for account warmth
* Message content triggering spam filters
**Solutions:**
* Verify all WhatsApp accounts are connected and active
* Clean contact list and remove invalid numbers
* Reduce daily sending limits per account
* Review and improve message content quality
* Test with smaller groups before full campaign
Poor Response Rates
**Possible Causes:**
* Low-quality or irrelevant contact lists
* Generic or non-personalized messaging
* Poor timing or frequency
* Weak call-to-action or value proposition
**Solutions:**
* Improve contact list quality and relevance
* Increase personalization and context usage
* Test different sending times and schedules
* Strengthen message content and clear value proposition
* A/B test different message approaches
Account Restrictions
**Possible Causes:**
* Sending too many messages too quickly
* Poor message content quality
* High spam complaints from recipients
* New accounts being used too aggressively
**Solutions:**
* Reduce daily sending limits immediately
* Review and improve message content
* Clean contact lists and remove uninterested recipients
* Use more established accounts for campaigns
* Implement better opt-out procedures
**Campaign getting accounts restricted?** Salvador can review your setup and help you optimize for better deliverability and account safety → [Get help from Salvador](https://wa.me/17543029801?text=Hey%20Salvador%2C%20my%20campaign%20is%20causing%20account%20restrictions)
## Advanced Contact Campaign Strategies
### Sequential Campaign Series
Create connected campaigns that build on each other:
**Campaign Series Example:**
1. **Awareness Campaign**: Introduce your company and value proposition
2. **Education Campaign**: Provide valuable content and establish expertise
3. **Engagement Campaign**: Invite interaction and relationship building
4. **Conversion Campaign**: Present offers and drive specific actions
### Segmented Messaging
Use different messages for different contact segments:
**Segmentation Examples:**
* **Industry-Specific**: Different messages for different industries
* **Geographic**: Location-appropriate content and offers
* **Engagement History**: Different approaches for engaged vs. cold contacts
* **Company Size**: Tailored messaging for small business vs. enterprise
### Integration with GHL Workflows
Connect campaigns with GoHighLevel automation:
**Workflow Integration:**
* **Response Triggers**: Automate follow-up based on campaign responses
* **Lead Scoring**: Update lead scores based on campaign engagement
* **Pipeline Movement**: Move contacts through sales pipelines automatically
* **Assignment Rules**: Assign respondents to appropriate team members
## Next Steps
After mastering contact list campaigns:
1. [**WhatsApp Group Campaigns**](https://github.com/WhatSnap/documentation/blob/main/Outreach/group-campaigns.md) - Learn to message WhatsApp groups directly
2. [**Campaign Analytics**](https://github.com/WhatSnap/documentation/blob/main/Outreach/campaign-analytics.md) - Master campaign performance tracking and optimization
3. [**Advanced Strategies**](https://github.com/WhatSnap/documentation/blob/main/Outreach/campaign-strategies.md) - Implement sophisticated campaign techniques
4. [**Workflow Integration**](https://github.com/WhatSnap/documentation/blob/main/conversations/workflow-automation.md) - Connect campaigns with automated follow-up sequences
{% hint style="info" %}
**Campaign Success**: Effective contact list campaigns combine high-quality contact data, personalized messaging, appropriate account distribution, and careful performance monitoring.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://whatsnap.gitbook.io/whatsnap-docs/outreach/contact-campaigns.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.