Troubleshooting
Fix: Bot Session Needs Re-authentication
How to fix "Bot Session Needs Re-authentication". Step-by-step troubleshooting guide with solutions.
Dashboard says session needs re-authentication. Open the session and follow the pairing flow again.
Confirm the symptoms
- Yellow "Re-auth required" badge.
30-second quick fix
- Click "Re-authenticate" in the dashboard and complete pairing code/QR.
Root causes
1. Credentials expired or rotated
- Re-pair.
Detailed resolution
- 1
Dashboard → Sessions → Re-authenticate
Expected result
Session back online.
Frequently asked questions
Will I lose config?
No.
Still stuck?
Open a support ticket from the dashboard and we will look at your session logs directly.
Other troubleshooting guides
WhatsApp Bot 401 Authentication Error
How to fix "WhatsApp Bot 401 Authentication Error". Step-by-step troubleshooting guide with solutions.
WhatsApp Bot 403 Forbidden Error
How to fix "WhatsApp Bot 403 Forbidden Error". Step-by-step troubleshooting guide with solutions.
WhatsApp Bot Logged Out Automatically
How to fix "WhatsApp Bot Logged Out Automatically". Step-by-step troubleshooting guide with solutions.