Troubleshooting
Fix: WhatsApp Bot 428 Rate Limit Error
How to fix "WhatsApp Bot 428 Rate Limit Error". Step-by-step troubleshooting guide with solutions.
428 = precondition required, Baileys couldn't complete a handshake step, usually a connection/network blip. Almost always self-recovers within a minute.
Confirm the symptoms
- Single 428 entry then back to normal.
- Repeated 428s under network instability.
30-second quick fix
- Wait 60s for auto-reconnect.
Root causes
1. Network instability
Server or client network blip.
- Self-resolves.
2. WhatsApp deploy
WhatsApp's own infrastructure rolling.
- Self-resolves.
Detailed resolution
- 1
Wait
Most 428s clear in <60s.
- 2
If persistent, reconnect
Dashboard.
Expected result
Session resumes operation.
Frequently asked questions
Should I worry?
Only if seen >5/hour for many hours.
Still stuck?
Open a support ticket from the dashboard and we will look at your session logs directly.
Other troubleshooting guides
WhatsApp Bot 515 Restart Error
How to fix "WhatsApp Bot 515 Restart Error". 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.