Troubleshooting
Fix: WhatsApp Session Conflict Error
How to fix "WhatsApp Session Conflict Error". Step-by-step troubleshooting guide with solutions.
Pairing a new device when 4 are already linked = WhatsApp silently disconnects the oldest. If that oldest was BotWave, your bot vanishes.
Confirm the symptoms
- Bot was working, suddenly disconnected after pairing a new device.
- WhatsApp Linked Devices no longer shows BotWave.
30-second quick fix
- Re-pair BotWave; remove one of the other linked devices in WhatsApp first.
Root causes
1. 4-device cap
WhatsApp enforces.
- Drop a device.
Detailed resolution
- 1
WhatsApp → Linked Devices
Remove unused entries.
- 2
Re-pair BotWave
Expected result
BotWave reclaims a slot and reconnects.
Frequently asked questions
Will WhatsApp tell me which device was kicked?
No, silent. Use the dashboard's connection log.
Still stuck?
Open a support ticket from the dashboard and we will look at your session logs directly.
Other troubleshooting guides
WhatsApp Multi-Device Bot Issue
How to fix "WhatsApp Multi-Device Bot Issue". Step-by-step troubleshooting guide with solutions.
WhatsApp Bot Keeps Disconnecting
Why your WhatsApp bot session disconnects and how to fix it. Covers QR expiry, 401 auth errors, 428 rate limits, and network issues.