> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Multiple WhatsApp Instances
> Our Integration allows you to connect multiple WhatsApp accounts to a single CRM location, giving you the flexibility to manage different numbers for various purposes. This powerful feature enables businesses and agencies to scale their WhatsApp communication effectively.
## What are Multiple Instances?[](#what-are-multiple-instances "Direct link to What are Multiple Instances?")
Multiple instances let you connect and manage several numbers simultaneously within a single CRM location - whether those numbers are **WhatsApp accounts, iMessage accounts, or SMS numbers**. Each instance operates independently with its own phone number, connection status, and message queue.
Regardless of the channel, the integration uses the **same priority-based number selection logic** to decide which number to send each outbound message from. See [Number Selection](/multiple-instances/number-selection) for the shared algorithm and the per-channel tag and override syntax.
### Key Benefits[](#key-benefits "Direct link to Key Benefits")
* **Department Separation**: Use separate numbers for sales, support, billing, and different business functions
* **Regional Operations**: Assign local numbers for different geographic areas or time zones
* **User-Specific Numbers**: Assign dedicated numbers to specific team members
* **Campaign Segmentation**: Use different numbers for various marketing campaigns or customer segments
* **Load Distribution**: Spread message volume across multiple accounts for better deliverability and compliance
* **Redundancy**: Ensure business continuity if one account faces issues
## How Number Selection Works[](#how-number-selection-works "Direct link to How Number Selection Works")
The integration uses an intelligent priority-based algorithm to automatically select the best instance for each message, ensuring optimal delivery and proper business routing. This logic is **identical across WhatsApp, iMessage, and SMS** - only the tag and override syntax differs per channel.
When you send a message through the integration, the system follows a strict priority hierarchy:
**Manual Override** - Force a specific instance with a per-channel pattern (e.g. `{ WA#N }`, `{IM#N}`)
**Contact Tags** - Use tagged numbers (e.g. `wa:`, `im:`, `sms:`)
**User Assignment** - Route to the assigned team member's instance
**Default Instance** - Fall back to the location's default number
**Any Available** - Use any connected instance as a last resort
For the full breakdown - including the temporary-switch pattern, the exact syntax for each channel (WhatsApp, iMessage, and SMS), advanced configuration examples, and best practices - see [Number Selection](/multiple-instances/number-selection), the exact syntax for each channel (WhatsApp, iMessage, and SMS), advanced configuration examples, and best practices - see [Number Selection](/multiple-instances/number-selection).
## Who Should Use Multiple Instances?[](#who-should-use-multiple-instances "Direct link to Who Should Use Multiple Instances?")
### For Agencies[](#for-agencies "Direct link to For Agencies")
* **Client Separation**: Manage different numbers for different clients
* **Brand Management**: Maintain separate brand identities with dedicated numbers
* **Team Distribution**: Assign team members to specific client accounts
* **Scalability**: Handle multiple sub-locations with appropriate number assignments
### For Businesses[](#for-businesses "Direct link to For Businesses")
* **Department Organization**: Sales team uses one number, support uses another
* **Regional Coverage**: Local numbers for different markets or locations
* **Customer Segmentation**: VIP customers get a dedicated support line
* **Compliance Management**: Separate numbers for different types of communications
### For Sales Teams[](#for-sales-teams "Direct link to For Sales Teams")
* **Personal Branding**: Each salesperson has their own number
* **Lead Management**: Different numbers for different lead sources
* **Follow-up Organization**: Specific numbers for different stages of the sales funnel
### Key Features[](#key-features "Direct link to Key Features")
The system provides detailed error codes (101-106) to help you quickly diagnose and resolve any messaging issues.
* **Real-Time Monitoring**: Live connection status for all instances
* **Flexible Configuration**: Set default instances, user assignments, and contact preferences
* **Automatic Failover**: Smart fallback when instances are disconnected
* **Tag-Based Routing**: Route messages based on contact tags or user assignments
* **Error Diagnostics**: Comprehensive error codes with step-by-step resolution guides
## Getting Started[](#getting-started "Direct link to Getting Started")
### Setup Guide
Follow our complete setup guide to connect multiple accounts to your CRM location.
[Setup Now →](/whatsapp/full-setup)
## Common Use Cases[](#common-use-cases "Direct link to Common Use Cases")
### Scenario 1: E-commerce Business[](#scenario-1-e-commerce-business "Direct link to Scenario 1: E-commerce Business")
```text theme={null}
Order Confirmations: +1-555-ORDERS Customer Support: +1-555-SUPPORT (Default) Billing Inquiries: +1-555-BILLING Marketing Campaigns: +1-555-PROMO
```
### Scenario 2: Real Estate Agency[](#scenario-2-real-estate-agency "Direct link to Scenario 2: Real Estate Agency")
```text theme={null}
John Smith (Agent): +1-555-JOHN-RE Sarah Wilson (Agent): +1-555-SARAH-RE Main Office Line: +1-555-MAIN-RE (Default) Lead Qualification: +1-555-LEADS-RE
```
### Scenario 3: Digital Marketing Agency[](#scenario-3-digital-marketing-agency "Direct link to Scenario 3: Digital Marketing Agency")
```text theme={null}
Client A (Brand X): +1-555-BRANDX Client B (Brand Y): +1-555-BRANDY Agency Main Line: +1-555-AGENCY (Default) Reporting & Analytics: +1-555-REPORTS
```
## Best Practices[](#best-practices "Direct link to Best Practices")
### Setup Recommendations[](#setup-recommendations "Direct link to Setup Recommendations")
Ensure one instance is marked as default for fallback scenarios
Set up alerts for disconnected instances
Keep a record of which numbers are used for what purposes
Verify that number selection works as expected
## Plans & Pricing[](#plans--pricing "Direct link to Plans & Pricing")
WhatsApp instances scale cost-effectively per sub-account.
* Included: 5 WhatsApp numbers are included in every sub-account plan.
* Add-ons: Each additional WhatsApp number is \$9/month per sub-account.
Pricing applies per sub-account. Add-on charges are calculated only for active additional numbers beyond the included five. For example, a sub-account using 8 numbers pays for 3 add-ons: \$27/month.
## What's Next?[](#whats-next "Direct link to What's Next?")
Start with understanding the selection logic, then explore error handling, and finally implement advanced configurations for your specific use case.
Once you understand the basics of multiple instances, dive deeper into:
* [**Number Selection**](/multiple-instances/number-selection): The shared priority logic and per-channel syntax for WhatsApp, iMessage, and SMS
* [**Number Selection Errors**](/multiple-instances/number-selection-errors): Detailed troubleshooting with error codes 101-106
* [**Advanced Setup**](/whatsapp/whatsapp-contact-tags): Configure user assignments and contact tagging
***
## Need Help?[](#need-help "Direct link to Need Help?")
Our team can help you design the optimal multi-instance strategy for your specific business needs and troubleshoot any configuration issues.
If you need assistance setting up multiple instances or have questions about number selection, our support team is here to help. Contact us through the WhatsApp button below.