> ## 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.

# Number Selection Errors

<Info>
  This documentation covers all error codes (101-106) that can occur during WhatsApp number selection, with step-by-step troubleshooting guides and resolution strategies.
</Info>

## Error Codes and Handling

### Error 101: No Connected Instances

<Warning>
  This error means no WhatsApp instances are available for the location. Messages cannot be sent until at least one instance is connected.
</Warning>

**Cause**: No WhatsApp instances are connected for the location

Error Response

```text theme={null}
{  "errorCode": "101",  "message": "Error 101: No connected WhatsApp instances found!",  "resolution": "Connect at least one WhatsApp instance for this location"}
```

**Example Scenario**: A location has 3 WhatsApp instances configured, but all are disconnected due to QR code expiration or network issues.

**What you'll see in error**:

```text theme={null}
[ERROR] Error 101: No connected WhatsApp instances found!
```

**How to fix**:

<Info>
  <Steps>
    <Step>
      Go to your admin panel → Select the Location
    </Step>

    <Step>
      Check instance status for the location
    </Step>

    <Step>
      Reconnect any disconnected instances by scanning QR codes
    </Step>

    <Step>
      Verify at least one instance shows "Connected" status
    </Step>
  </Steps>
</Info>

### Error 102: Manual Override Instance Doesn't Exist

<Warning>
  You're trying to use a WhatsApp instance that doesn't exist in your location setup.
</Warning>

**Cause**: Manual override specifies a non-existent instance index

Error Response

```text theme={null}
{  "errorCode": "102",  "message": "Error 102: Manual override specified {WA#5}, but that instance does not exists.",  "resolution": "Use a valid instance index or remove the manual override pattern"}
```

**Example Scenario**: User sends message "Use this number `{ WA#7 }`" but the location only has instances #1, #2, and #3 configured.

**What you'll see in error**:

```text theme={null}
[ERROR] Error 102: Manual override specified {WA#7}, but that instance does not exists.
```

**How to fix**:

<Info>
  <Steps>
    <Step title="Check available instances">
      View admin panel to see which instance numbers exist (e.g., 1, 2, 3)
    </Step>

    <Step title="Update message">
      Change "`{ WA#7 }`" to valid instance like "`{ WA#2 }`"
    </Step>

    <Step title="Remove override">
      Delete the "`{ WA#7 }`" pattern to use automatic selection
    </Step>

    <Step title="Create instance">
      If needed, create instance #7 in the admin panel
    </Step>
  </Steps>
</Info>

### Error 103: Manual Override Instance Not Connected

<Warning>
  The specified WhatsApp instance exists but is currently disconnected. You need to reconnect it or use a different instance.
</Warning>

**Cause**: Manual override specifies an instance that isn't connected

Error Response

```text theme={null}
{  "errorCode": "103",  "message": "Error 103: Manual override specified {WA#2}, but the instance 2 is not connected!",  "resolution": "Connect instance 2 or remove the manual override pattern"}
```

**Example Scenario**: User sends message `"Please call me back &#123; WA#3 &#125;"` but WhatsApp instance #3 is disconnected.

**What you'll see in error**:

```text theme={null}
[ERROR] Error 103: Manual override specified {WA#3}, but the instance 3 is not connected!
```

**How to fix**:

<Info>
  <Steps>
    <Step title="Option A">
      Connect instance #3 in admin panel
    </Step>

    <Step title="Option B">
      Edit the message to remove "`{ WA#3 }`" pattern
    </Step>

    <Step title="Option C">
      Change to a connected instance like "`{ WA#1 }`"
    </Step>
  </Steps>
</Info>

### Error 104: Tagged Number Instance Not Connected

<Warning>
  The contact has a WhatsApp number tag, but the instance with that number is not connected.
</Warning>

**Cause**: Contact has WhatsApp tag but the corresponding instance isn't connected

Error Response

```text theme={null}
{  "errorCode": "104",  "message": "Error 104: Whatsapp number +15551234567 is not connected. Either connect the number or remove the tag 'wa: +15551234567' from the contact!",  "resolution": "Connect the WhatsApp number or remove the tag from contact"}
```

**Example Scenario**: Contact "John Doe" has tag "wa: +15559876543" but no instance with that phone number is connected.

**What you'll see in error**:

```text theme={null}
[ERROR] Error 104: Whatsapp number +15559876543 is not connected. Either connect the number or remove the tag 'wa:+15559876543' from the contact!
```

**How to fix**:

<Info>
  <Steps>
    <Step title="Option A">
      Reconnect the WhatsApp instance with number +15559876543
    </Step>

    <Step title="Option B">
      Remove the `wa: +15559876543` tag from contact John Doe
    </Step>

    <Step title="Option C">
      Update the tag to use a connected number like `wa: +15551111111`
    </Step>
  </Steps>
</Info>

### Error 105: Assigned User Instance Not Connected

<Warning>
  The contact is assigned to a user, but that user's WhatsApp instance is not connected.
</Warning>

**Cause**: Contact is assigned to a user whose WhatsApp instance isn't connected

Error Response

```text theme={null}
{  "errorCode": "105",  "message": "Error 105: Contact was assigned to John Doe (user123) but the Whatsapp Instance - 3 for that User was not connected!",  "resolution": "Connect the assigned user's WhatsApp instance"}
```

**Example Scenario**: Contact "Jane Smith" is assigned to user "Sarah Williams" but Sarah's WhatsApp instance #2 is disconnected.

**What you'll see in error**:

```text theme={null}
[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!
```

**How to fix**:

<Info>
  <Steps>
    <Step title="Option A">
      Have Sarah Williams reconnect her WhatsApp instance #2
    </Step>

    <Step title="Option B">
      Reassign the contact to a user with a connected instance
    </Step>

    <Step title="Option C">
      Remove Sarah Williams from Instance Assignment so any other number can be used for contacts assigned to Sarah Williams in CRM
    </Step>
  </Steps>
</Info>

### Error 106: No Available Instances

<Warning>
  The system went through all priority levels but couldn't find any available WhatsApp instances to use.
</Warning>

**Cause**: All fallback options exhausted, no instances available

Error Response

```text theme={null}
{  "errorCode": "106",  "message": "Error 106: No connected WhatsApp instances found!",  "resolution": "Connect at least one WhatsApp instance and ensure it has a phone number"}
```

**Example Scenario**: System went through all priority levels (no manual override, no contact tags, no assignment, no default instance) and still found no available instances.

**What you'll see in error**:

```text theme={null}
[ERROR] Error 106: No connected WhatsApp instances found!
```

**How to fix**:

<Info>
  <Steps>
    <Step title="Check instance connectivity">
      Verify all instances aren't disconnected
    </Step>

    <Step title="Set default instance">
      Mark at least one connected instance as "default: true"
    </Step>

    <Step title="Verify phone numbers">
      Ensure connected instances have valid phone numbers
    </Step>
  </Steps>
</Info>

## Troubleshooting Guide

<Check>
  Most WhatsApp messaging issues stem from disconnected instances. Always check your instance connection status first!
</Check>

### Common Issues

#### No connected WhatsApp instances found

* **Check**: Instance connection status in admin panel
* **Fix**: Reconnect disconnected instances
* **Prevention**: Set up email alerts for instance disconnections (Check spam and mark Important if email ends up in spam)

#### Manual override instance not connected

* **Check**: Instance status for the specified index
* **Fix**: Connect the instance or remove manual override
* **Prevention**: Validate manual overrides before sending

#### Contact assigned to disconnected instance

* **Check**: User's assigned instance status
* **Fix**: Reassign contact or reconnect instance
* **Prevention**: Regular instance health checks

## Error Prevention Strategies

### Proactive Monitoring

<Steps>
  <Step>
    **Set up alerts** for instance disconnections
  </Step>

  <Step>
    **Test workflows** regularly to catch issues early
  </Step>
</Steps>

### Configuration Best Practices

<Steps>
  <Step>
    **Always maintain a default instance** for each location
  </Step>

  <Step>
    **Keep contact tags updated** when instances change
  </Step>

  <Step>
    **Validate manual overrides** before implementing in workflows
  </Step>

  <Step>
    **Document your instance strategy** for team reference
  </Step>
</Steps>

***

## Related Documentation

* [**Introduction to Multiple WhatsApp Instances**](/multiple-instances/overview): Overview and use cases
* [**Full Setup Guide**](/whatsapp/full-setup): How to connect WhatsApp instances

For additional support with error troubleshooting, contact our team through the WhatsApp button below.

***

## Support[​](#support "Direct link to Support")

If you need help with the setup or onboarding:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)