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.
{ "errorCode": "101", "message": "Error 101: No connected WhatsApp instances found!", "resolution": "Connect at least one WhatsApp instance for this location"}
[ERROR] Error 101: No connected WhatsApp instances found!
Go to your admin panel → Select the Location
Check instance status for the location
Reconnect any disconnected instances by scanning QR codes
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.
{ "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"}
{ 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.
Check available instances
View admin panel to see which instance numbers exist (e.g., 1, 2, 3)
Update message
Change “{ WA#7 }” to valid instance like “{ WA#2 }”
Remove override
Delete the “{ WA#7 }” pattern to use automatic selection
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.
{ "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"}
"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!
Option A
Connect instance #3 in admin panel
Option B
Edit the message to remove “{ WA#3 }” pattern
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.
{ "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"}
[ERROR] Error 104: Whatsapp number +15559876543 is not connected. Either connect the number or remove the tag 'wa:+15559876543' from the contact!
Option A
Reconnect the WhatsApp instance with number +15559876543
Option B
Remove the wa: +15559876543 tag from contact John Doe
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.
{ "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"}
[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!
Option A
Have Sarah Williams reconnect her WhatsApp instance #2
Option B
Reassign the contact to a user with a connected instance
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.
{ "errorCode": "106", "message": "Error 106: No connected WhatsApp instances found!", "resolution": "Connect at least one WhatsApp instance and ensure it has a phone number"}
[ERROR] Error 106: No connected WhatsApp instances found!
Check instance connectivity
Verify all instances aren’t disconnected
Set default instance
Mark at least one connected instance as “default: true”
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
- Check: User’s assigned instance status
- Fix: Reassign contact or reconnect instance
- Prevention: Regular instance health checks
Error Prevention Strategies
Proactive Monitoring
Set up alerts for instance disconnections
Test workflows regularly to catch issues early
Configuration Best Practices
Always maintain a default instance for each location
Keep contact tags updated when instances change
Validate manual overrides before implementing in workflows
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:
