WhatsApp QR Code Not Working During Setup
You're trying to link your WhatsApp Business number by scanning a QR code, but the scan fails, shows an error, or the connection doesn't complete.
1. QR Code Expired
QR codes for WhatsApp linking have a short time limit. If you waited too long before scanning:
- Fix. Refresh the page to generate a new QR code
- Tip: Scan within 30 seconds of the code appearing on screen
2. Camera or Scanning Issue
The phone's camera may not be reading the code properly.
- Ensure good lighting and hold the phone steady
- Clean the camera lens
- Try increasing screen brightness on the device displaying the QR code
- If available, use the "Link with phone number" option instead of QR scanning
3. WhatsApp App Not Updated
Older versions of WhatsApp may not support the current linking flow.
- Fix. Update WhatsApp to the latest version from your app store
- Check your version: WhatsApp > Settings > Help > App Info
4. Maximum Linked Devices Reached
WhatsApp limits the number of devices linked to a single account (currently 4 linked devices).
- Fix. Go to WhatsApp > Settings > Linked Devices
- Remove a device you no longer use
- Then try scanning the QR code again
5. Network Issues
Both the phone and the device displaying the QR code need an active internet connection (they don't need to be on the same network).
- Check the phone's internet connection
- Check the computer's connection
- Try switching between WiFi and mobile data on the phone
6. Account Restrictions
If your WhatsApp account has been restricted or flagged by Meta, linking to new devices may be blocked.
- Open WhatsApp on the phone. Look for any warning messages
- If your account shows restrictions, resolve those first before attempting to link
Once the scan works:
If the scan succeeds but the connection drops shortly after, the issue may be related to session management or multiple active sessions.
If none of the above resolves your QR code issue:
Was this article helpful?
Related Articles
Adding a New WhatsApp Number Disconnects Existing Numbers in Envoy
You added a new WhatsApp Business number to Envoy, and your previously connected numbers stopped working. The new number works fine, but the old ones show as disconnected or have lost functionality.
Setup & ConnectionWhatsApp Disconnected - How to Reconnect in Envoy
Your WhatsApp channel shows as "Disconnected" in Envoy. Your phone can still receive messages, but they're not appearing in your Envoy inbox. Chatbot auto-replies and team inbox access have stopped working.
Setup & ConnectionWhatsApp QR Code Not Working During Envoy Setup
You're setting up your WhatsApp Business channel in Envoy by scanning a QR code, but the scan fails or the connection doesn't complete.