Troubleshooting
Fix: Evolution API Connection Error
How to fix "Evolution API Connection Error". Step-by-step troubleshooting guide with solutions.
Errors from the Evolution API integration (a third-party WhatsApp API). BotWave's native Baileys integration is more reliable; consider migrating.
Confirm the symptoms
- Evolution API errors in logs.
- "Cannot reach evolution endpoint".
30-second quick fix
- Check the Evolution API server status; if down, fail over to BotWave native.
Root causes
1. Evolution API server down
- Restart or wait.
2. Auth/key issue
- Rotate API key.
3. Network between BotWave and Evolution
- Check connectivity.
Detailed resolution
- 1
Check Evolution server status
- 2
Rotate the API key in Dashboard → Integrations
- 3
If persistent, switch the session to BotWave native
No Evolution dependency.
Expected result
Evolution-backed session operational, or migrated off.
Frequently asked questions
Should I keep Evolution?
Most setups are simpler on BotWave native Baileys. Use Evolution only if you have a specific dependency.
Still stuck?
Open a support ticket from the dashboard and we will look at your session logs directly.