Skip to main content

Number Selection Errors

Error Code Reference

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

Error Codes and Handling​

Error 101: No Connected Instances​

Critical Error

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

Cause: No WhatsApp instances are connected for the location

Error Response
{
  "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:

[ERROR] Error 101: No connected WhatsApp instances found!

How to fix:

Fix Steps
  1. Go to your admin panel → Select the Location
  2. Check instance status for the location
  3. Reconnect any disconnected instances by scanning QR codes
  4. Verify at least one instance shows "Connected" status

Error 102: Manual Override Instance Doesn't Exist​

Invalid Instance Reference

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

Cause: Manual override specifies a non-existent instance index

Error Response
{
  "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:

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

How to fix:

Resolution Options
  1. Check available instances: View admin panel to see which instance numbers exist (e.g., 1, 2, 3)
  2. Update message: Change "{{ WA#7 }}" to valid instance like "{{ WA#2 }}"
  3. Remove override: Delete the "{{ WA#7 }}" pattern to use automatic selection
  4. Create instance: If needed, create instance #7 in the admin panel

Error 103: Manual Override Instance Not Connected​

Instance Disconnected

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

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

Error Response
{
  "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 {{ WA#3 }}" but WhatsApp instance #3 is disconnected.

What you'll see in error:

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

How to fix:

Resolution Options
  1. Option A: Connect instance #3 in admin panel
  2. Option B: Edit the message to remove "{{ WA#3 }}" pattern
  3. Option C: Change to a connected instance like "{{ WA#1 }}"

Error 104: Tagged Number Instance Not Connected​

Tag Points to Disconnected Instance

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

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

Error Response
{
  "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:

[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:

Resolution Options
  1. Option A: Reconnect the WhatsApp instance with number +15559876543
  2. Option B: Remove the wa: +15559876543 tag from contact John Doe
  3. Option C: Update the tag to use a connected number like wa: +15551111111

Error 105: Assigned User Instance Not Connected​

User's Instance Disconnected

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

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

Error Response
{
  "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:

[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!

How to fix:

Resolution Options
  1. Option A: Have Sarah Williams reconnect her WhatsApp instance #2
  2. Option B: Reassign the contact to a user with a connected instance
  3. Option C: Remove Sarah Williams from Instance Assignment so any other number can be used for contacts assigned to Sarah Williams in CRM

Error 106: No Available Instances​

System Exhausted All Options

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

Cause: All fallback options exhausted, no instances available

Error Response
{
  "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:

[ERROR] Error 106: No connected WhatsApp instances found!

How to fix:

Resolution Steps
  1. Check instance connectivity: Verify all instances aren't disconnected
  2. Set default instance: Mark at least one connected instance as "default: true"
  3. Verify phone numbers: Ensure connected instances have valid phone numbers

Troubleshooting Guide​

Quick Diagnosis

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

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​

  1. Set up alerts for instance disconnections
  2. Test workflows regularly to catch issues early

Configuration Best Practices​

  1. Always maintain a default instance for each location
  2. Keep contact tags updated when instances change
  3. Validate manual overrides before implementing in workflows
  4. Document your instance strategy for team reference

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

Let's connect