# Dual-SIM and Multi-Account Usage

## Can I Use 1 SIM and Phone for Multiple Sub-Accounts?

**No**, you cannot share the same SIM card across multiple GoHighLevel sub-accounts.

{% hint style="danger" %}
**One SIM = One Sub-Account**: Each SIM card must be dedicated to a single GoHighLevel sub-account. Attempting to share a SIM across multiple sub-accounts will cause message routing conflicts and delivery failures.
{% endhint %}

### Why You Can't Share SIMs

**Technical Limitations:**

* Each SIM card gets assigned to one WhatSnap account
* Messages route based on sub-account tags
* Sharing would create conflicts in message routing
* GoHighLevel can't determine which sub-account should receive inbound messages
* Outbound messages wouldn't know which account context to use

**The Rule:**

```
1 SIM card = 1 Android device = 1 WhatSnap account = 1 GHL sub-account
```

***

## Using Dual-SIM Phones

**Good news**: You **can** use a dual-SIM Android phone with **two separate SIM cards**, and route them to **different GoHighLevel sub-accounts**.

### How Dual-SIM Works with WhatSnap

**Setup:**

1. Install 2 SIM cards in your dual-SIM Android device
2. Install WhatSnap Gateway app
3. During device setup, you'll see both SIM cards listed
4. **Select which SIM(s)** you want WhatSnap to use
5. Configure each SIM for different purposes

{% hint style="success" %}
**Dual-SIM Benefits**: Use one phone to manage two numbers, save on hardware costs, and run two separate accounts or campaigns from a single device.
{% endhint %}

### Dual-SIM Configuration Options

#### Option 1: Both SIMs for Same Sub-Account

**Use Case**: Increase messaging capacity for one business

**Setup:**

1. Both SIMs connected to same GoHighLevel sub-account
2. Each SIM gets unique WhatSnap account tag
3. Distribute contacts across both tags using workflows
4. Each SIM handles \~100-250 messages/day = 200-500 total

**Benefits:**

* Double your messaging capacity
* Load balancing across two carriers
* Redundancy if one SIM has issues
* One device to manage instead of two

**Considerations:**

* Ensure device has adequate RAM (4 GB+ recommended)
* Monitor both SIMs for deliverability
* Warm up each SIM separately (staggered schedule)

#### Option 2: Each SIM for Different Sub-Account

**Use Case**: Agency managing multiple client accounts

**Setup:**

1. SIM 1 → GoHighLevel Sub-Account A (Client 1)
2. SIM 2 → GoHighLevel Sub-Account B (Client 2)
3. Each SIM/sub-account operates independently

{% hint style="warning" %}
**Important**: When setting up dual-SIM for different sub-accounts, you'll need to configure WhatSnap separately for each sub-account and assign the correct SIM to each.
{% endhint %}

**Benefits:**

* Manage multiple clients from one phone
* Cost savings on hardware
* Each client has dedicated number
* Separate billing and management

**Considerations:**

* Must carefully separate which contacts belong to which client
* Tag management is critical
* More complex to troubleshoot
* Consider using separate devices for cleaner separation

#### Option 3: Personal + Business Separation

**Use Case**: One SIM for business, one for personal

**Setup:**

1. SIM 1 → WhatSnap for business (connected to GHL)
2. SIM 2 → Personal use (not connected to WhatSnap)
3. When setting up WhatSnap, **uncheck the personal SIM**

**Benefits:**

* Keep business and personal separate
* One phone to carry
* Personal messages never sync to CRM

**Considerations:**

* Use `whatsnap-blacklist` tag for any personal contacts on business SIM
* Monitor to ensure no personal messages leak to GHL
* Better approach: Use completely separate devices when possible

***

## Setting Up Dual-SIM with WhatSnap

### Step-by-Step Configuration

{% stepper %}
{% step %}

#### Install Both SIM Cards

1. Power off your Android device
2. Insert both SIM cards into SIM slots
3. Power on device
4. Verify both SIMs are detected and active
5. Test that both can send/receive SMS independently
   {% endstep %}

{% step %}

#### Install WhatSnap Gateway App

1. Follow standard [SMS Installation & Setup](https://whatsnap.gitbook.io/whatsnap-docs/account-management/sms/sms-installation-setup)
2. Install WhatSnap Gateway APK
3. Grant all required permissions
   {% endstep %}

{% step %}

#### Configure SIM Selection

During WhatSnap setup:

1. You'll see a list of detected SIM cards:
   * **SIM 1**: \[Phone Number 1]
   * **SIM 2**: \[Phone Number 2]
2. **Check the boxes** for SIMs you want WhatSnap to use:
   * ✅ SIM 1 - Check if using for WhatSnap
   * ✅ SIM 2 - Check if using for WhatSnap
   * ❌ Uncheck any SIM not meant for CRM/business use
3. Save configuration
   {% endstep %}

{% step %}

#### Name Each SIM Distinctly

In WhatSnap dashboard:

1. Navigate to your connected device
2. You'll see both SIMs listed as separate accounts
3. Name each clearly:
   * **Good**: "Sales-Main-Number", "Support-Backup"
   * **Bad**: "SIM 1", "SIM 2"
     {% endstep %}

{% step %}

#### Note Each SIM's Tag

WhatSnap creates unique tags for each SIM:

* SIM 1 Tag: `whatsnap-account-android-sales-main`
* SIM 2 Tag: `whatsnap-account-android-support`

Write these down for message routing.
{% endstep %}

{% step %}

#### Assign to Sub-Account(s)

**For Same Sub-Account:**

* Both SIMs automatically available in same GHL sub-account
* Use tags to route contacts to each SIM

**For Different Sub-Accounts:**

1. In WhatSnap dashboard, assign SIM 1 to Sub-Account A
2. Assign SIM 2 to Sub-Account B
3. Each sub-account only sees its assigned SIM
   {% endstep %}
   {% endstepper %}

***

## Managing Messages Across Dual-SIM

### Message Routing

**How WhatSnap Routes Messages:**

{% @mermaid/diagram content="graph TD;
A\["Contact in GHL"] --> B{"Which Tag?"};
B -->|"Tag: SIM-1"| C\["📱 Send via SIM 1"];
B -->|"Tag: SIM-2"| D\["📱 Send via SIM 2"];
C --> E\["Message from Number 1"];
D --> F\["Message from Number 2"];

```
G["Inbound to Number 1"] --> H["📱 Received on SIM 1"];
I["Inbound to Number 2"] --> J["📱 Received on SIM 2"];
H --> K["Syncs to GHL with SIM-1 Tag"];
J --> L["Syncs to GHL with SIM-2 Tag"];" %}
```

**Tag-Based Routing:**

* Add tag `whatsnap-account-android-sim1` → Messages send via SIM 1
* Add tag `whatsnap-account-android-sim2` → Messages send via SIM 2
* No tag → Message fails (no route defined)

### Distributing Contacts Across SIMs

**Use GHL workflows to distribute load:**

```
Trigger: New contact added
↓
Split Action (50/50):
  → Path 1: Add tag "sim1"
  → Path 2: Add tag "sim2"
↓
Messages automatically route to assigned SIM
```

See: [Multiple SMS Accounts - Distribution Strategies](https://whatsnap.gitbook.io/whatsnap-docs/account-management/sms/multiple-sms-accounts#message-distribution-strategies)

### Replying to Conversations

**Critical**: Always reply from the same SIM/number the contact originally messaged.

**How to Ensure Correct Routing:**

1. Check contact's tag to see which SIM they're assigned to
2. Reply will automatically use that SIM (tag-based routing)
3. Don't manually change tags mid-conversation

**If Wrong Number:**

* Contact expects messages from Number 1
* But they're tagged for SIM 2
* They'll receive from Number 2 (confusing!)
* **Fix**: Update tag to match their expectation

***

## Dual-SIM Performance Considerations

### Device Requirements

**Minimum Specs for Dual-SIM:**

* **4 GB RAM** (minimum, 6 GB recommended)
* Android 9.0 or higher
* Reliable dual-SIM hardware (avoid ultra-budget phones)

{% hint style="warning" %}
**Performance Impact**: Running two SIMs simultaneously uses more resources than single-SIM. Devices with less than 4 GB RAM may struggle with dual-SIM WhatSnap operation.
{% endhint %}

### Volume Capacity

**Combined Capacity:**

* SIM 1: 100-250 messages/day (after warm-up)
* SIM 2: 100-250 messages/day (after warm-up)
* **Total: 200-500 messages/day**

**Factors Affecting Capacity:**

* Device performance (RAM, CPU)
* Carrier restrictions on each SIM
* Warm-up status of each SIM
* Message quality and personalization

### Warm-Up Strategy

**Don't warm up both SIMs simultaneously:**

**Recommended Approach:**

**Week 1:**

* Warm up SIM 1 only
* SIM 2 stays inactive

**Week 2:**

* SIM 1 increases volume
* Start warming up SIM 2

**Week 3+:**

* Both SIMs at full capacity

**Why Stagger:**

* Less strain on device
* Learn from SIM 1 experience
* Reduce risk of dual blocks
* More natural growth pattern

See: [Database Reactivations - SIM Warm-Up](https://whatsnap.gitbook.io/whatsnap-docs/faq/sms/broken-reference)

***

## Dual-SIM vs. Two Separate Devices

### When to Use Dual-SIM Phone

**Good For:**

* ✅ Budget-conscious setups
* ✅ Low-to-moderate volume (200-400 msgs/day total)
* ✅ Personal + business separation on one phone
* ✅ Testing before scaling to multiple devices

**Limitations:**

* ❌ Single point of failure (one device down = both SIMs offline)
* ❌ Device performance constraints
* ❌ More complex troubleshooting
* ❌ Harder to scale beyond 2 SIMs

### When to Use Separate Devices

**Good For:**

* ✅ High volume operations (500+ msgs/day)
* ✅ Different clients/sub-accounts (clearer separation)
* ✅ Redundancy and reliability
* ✅ Easier scaling (add more devices as needed)
* ✅ Better device performance per SIM

**Considerations:**

* Higher hardware cost (multiple phones)
* More physical devices to manage
* More power outlets needed
* Cleaner, more reliable operation

**Recommendation:**

* Start with dual-SIM to prove concept
* Scale to separate devices as volume grows
* Use separate devices for different clients

***

## Troubleshooting Dual-SIM Issues

### Only One SIM Sending Messages

**Problem**: Messages only send from one SIM, not both

**Solutions:**

1. ✅ Check both SIMs are **checked/enabled** in WhatSnap Gateway settings
2. ✅ Verify both SIMs can send regular SMS (test in Messages app)
3. ✅ Confirm contacts have correct tags for each SIM
4. ✅ Check both SIMs are active with carrier (not suspended)
5. ✅ Restart WhatSnap Gateway app

### Messages Sending from Wrong SIM

**Problem**: Contact receives message from unexpected number

**Solutions:**

1. ✅ Verify contact's tag matches the SIM you want to use
2. ✅ Check workflow isn't overwriting tags
3. ✅ Remove conflicting tags (contact should have only one SIM tag)
4. ✅ Review message routing configuration

### Device Performance Degraded

**Problem**: Slow, laggy, or crashing with dual-SIM

**Solutions:**

1. ✅ Reduce volume on both SIMs
2. ✅ Check device has adequate RAM (4 GB minimum)
3. ✅ Clear cache and free up storage space
4. ✅ Disable unnecessary background apps
5. ✅ Consider upgrading to higher-spec device
6. ✅ Or switch to two separate devices

### One SIM Blocked, Other Working

**Problem**: Carrier blocked one SIM but not the other

**Solutions:**

1. ✅ Stop sending on blocked SIM immediately
2. ✅ Continue using working SIM at reduced volume
3. ✅ Contact carrier to unblock affected SIM
4. ✅ Redistribute contacts to working SIM temporarily
5. ✅ Review why SIM was blocked (too fast, spam content?)
6. ✅ Restart warm-up process on unblocked SIM

***

## Alternative: Using Multiple Devices

For more complex setups, consider multiple devices instead of dual-SIM:

**Benefits:**

* **Better performance**: Each SIM has dedicated device resources
* **Easier troubleshooting**: Isolate issues to specific device
* **Higher scalability**: Add 3, 5, 10+ devices easily
* **Redundancy**: If one device fails, others continue working

**Setup:**

1. Connect multiple Android devices to WhatSnap
2. Each device gets unique tag
3. Use workflows to distribute contacts across devices

Full guide: [Multiple SMS Accounts](https://whatsnap.gitbook.io/whatsnap-docs/account-management/sms/multiple-sms-accounts)

***

## Related Resources

* [Multiple SMS Accounts Guide](https://whatsnap.gitbook.io/whatsnap-docs/account-management/sms/multiple-sms-accounts) - Complete multi-device strategies
* [SMS Device Specifications](https://whatsnap.gitbook.io/whatsnap-docs/account-management/sms/sms-specifications) - Recommended devices
* [SMS Installation & Setup](https://whatsnap.gitbook.io/whatsnap-docs/account-management/sms/sms-installation-setup) - Initial setup guide
* [Database Reactivations](https://whatsnap.gitbook.io/whatsnap-docs/faq/sms/broken-reference) - Volume and warm-up strategies

***

## Summary

### SIM Sharing: NOT Possible

❌ **Cannot share one SIM across multiple sub-accounts**

* Technical limitations prevent this
* Will cause routing conflicts
* Messages will fail or go to wrong contacts

### Dual-SIM: YES, Possible

✅ **Can use dual-SIM phone with WhatSnap**

* Two SIMs in one device
* Can route to same or different sub-accounts
* Doubles messaging capacity
* Cost-effective scaling solution

### Best Practices

**For Dual-SIM Success:**

1. ✅ Use device with 4+ GB RAM
2. ✅ Warm up SIMs separately (staggered schedule)
3. ✅ Name and tag clearly for each SIM
4. ✅ Monitor performance and deliverability
5. ✅ Consider separate devices as you scale

{% hint style="success" %}
**Dual-SIM is a Smart Strategy**: Using a dual-SIM phone can be cost-effective for small-to-medium operations. As you scale, transition to multiple dedicated devices for optimal performance.
{% endhint %}

***

**Need Help?** Contact WhatSnap support at <support@whatsnap.ai> for assistance with dual-SIM configuration or scaling strategies.
