Skip to main content
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

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
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:
How to fix:
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

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
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:
How to fix:
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

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
Example Scenario: User sends message "Please call me back { WA#3 }" but WhatsApp instance #3 is disconnected. What you’ll see in error:
How to fix:
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

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
Example Scenario: Contact “John Doe” has tag “wa: +15559876543” but no instance with that phone number is connected. What you’ll see in error:
How to fix:
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

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
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:
How to fix:
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

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
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:
How to fix:
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

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.

​
Support​

If you need help with the setup or onboarding: