Troubleshooting & Errors
Understand common API error codes and resolve device connection issues.
Common API Errors
• `WhatsApp instance is not connected`: The instance has not scanned a QR code or the session expired. Go to dashboard and scan the QR code again.
• `Invalid user ID or API key`: The credentials passed in user requests are invalid. Verify your keys.
• `Subscription expired, please renew`: Your connected number's active package has expired. Renew your plan via the dashboard.
• `Missing required fields`: Your FormData request lacks parameters (verify recipient and message properties).
WhatsApp Disconnects / Logouts
WhatsApp logs out active sessions if they are idle for too long, if you link too many devices, or if you explicitly select "Log out" on your phone. If this occurs, WAMA's status listener will immediately flag the instance as disconnected.
To restore connectivity, trigger a session start on the dashboard and scan the generated QR code.