WhatsApp QR Code Not Connecting or Device Keeps Disconnecting: Fixes
Any statistics or percentages in this article are general industry figures or illustrations, not QuackAPI measurements or promises. Results depend on your audience, consent and sending patterns. QuackAPI connects to WhatsApp as a linked device (an unofficial method), so read our risk and acceptable use policy before sending.
How the connection works
A QuackAPI device is a WhatsApp number linked the same way as WhatsApp Web. The device is pending until you scan its QR code from WhatsApp, Linked devices, then connected. If the link is lost it becomes disconnected.
The QR code will not scan or the device stays pending
QR codes refresh, so scan the one currently on screen and do it promptly. If it will not scan, increase the screen brightness, zoom the page so the code is large, and keep the phone steady.
Check that the phone has a working internet connection, that WhatsApp is up to date, and that you opened Linked devices inside WhatsApp (not the phone's camera app). If it still stays pending, create the QR code again and retry.
The device keeps showing disconnected
Common causes: the linked device was removed from the phone's Linked devices list, the phone was offline for a long time (WhatsApp's own help pages say linked devices are logged out if the phone is not used for about 14 days), the number was logged out or restricted by WhatsApp, or the account was re-registered on another phone.
Open Linked devices on the phone. If the session is missing, generate a new QR code in the dashboard and scan it again. If WhatsApp itself is restricting the number, reconnecting will not help until the restriction ends.
What your API calls get meanwhile
While a device is disconnected or disabled, sending from it is refused. A device that is not ready yet returns HTTP 409 with the code DEVICE_NOT_READY. Retry the 409 after a pause, but do not keep retrying a disconnected device: reconnect it first.
{ "message": "...", "code": "DEVICE_NOT_READY" }Get told when it happens
You can receive an email when a device disconnects or connects, and device status is visible on the device page. Use those instead of discovering the problem from failed sends.
Reduce disconnects
Use a phone that stays online, do not remove the linked session by hand, and keep your sending patterns healthy so the number is not restricted. See the guide on avoiding bans and the acceptable use page.