Skip to content

Why can not I connect the device to the API?#

Possible reasons for failed device pairing with API:#

Outdated QR code#

This problem may occur, for example, when scanning an image (you are sent an image of the code to scan).
The QR code is updated every 20 seconds, so when scanning the code after this time, you may receive an error.

Solution

Use the QR method to get the code, scan the code directly from the browser.

Options for obtaining a code in integrations are described in our article.

Unstable Internet connection#

An unstable or slow Internet connection (Wi-Fi or mobile network) can cause problems connecting to WhatsApp and lead to a logout.

This is especially true when using networks with low data transfer speeds or when the connection is frequently interrupted.

Solution

  1. Restart your router or switch to a more stable network.
  2. Disable and re-enable mobile data or Wi-Fi.
  3. Make sure that power saving or data saving mode is not limiting the application.

Connecting on multiple devices at the same time.#

Solution

  1. Request code from only one place - do not request code from the API and from the web or desktop version at the same time.
  2. Do not request code from different integration IP addresses.

Not enough space on the device#

If your device is running out of free space, WhatsApp may automatically end the session and log out the account.
This is due to the fact that the messenger needs space to store cache, messages and media files.
If there is not enough memory, reconnecting the device to the account may not be possible.

Solution

Clear the device memory by deleting unnecessary files and applications, and then re-link the account.

Device or app incompatibility#

If your device has an outdated version of WhatsApp installed, you may experience connection issues.
Some modded or unofficial versions of the app may also block the ability to link.

Solution

Install the official WhatsApp client or update it to the latest version.

Cached data error#

Corrupt or outdated app data may be preventing linking.

Solution

Clear the WhatsApp cache in your device settings or reinstall the app.

Instance status - Starting#

An instance may get this status for various reasons.
For example, after requesting a code, after 180 seconds, there was no time to scan the code, the instance may go into the starting status.
In this status, it is impossible to connect WhatsApp to the instance.

Solution

Reboot the instance and request the code again.

Scanning part of the code#

Solution

When scanning the code, you need to completely fit the code within the scope of the application, if the code is too small, WhatsApp may not recognize it correctly.