Skip to main content
    Setup & ConnectionEnvoy

    WhatsApp 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.

    2 min readUpdated 9 Apr 2026

    QR Code Expired

    QR codes expire quickly. Refresh the Envoy setup page to generate a new one, then scan within 30 seconds.

    Camera Issues

    • Ensure good lighting
    • Clean the phone camera lens
    • Increase screen brightness on the device showing the QR code

    WhatsApp Not Updated

    Older WhatsApp versions may not support the current linking flow. Update WhatsApp to the latest version from your app store.

    Too Many Linked Devices

    WhatsApp limits linked devices to 4. Go to WhatsApp > Settings > Linked Devices and remove one you no longer use, then try again.

    Network Issues

    Both the phone and the device running Envoy need internet access. Try switching between WiFi and mobile data on the phone.

    1
  1. Wait 1-2 minutes for the linking process to complete
    2. 2
  2. In WhatsApp, check that the chat text shows the green security message (not yellow "end-to-end encrypted")
    3. 3
  3. In Envoy, verify the channel status shows Connected
    4. 4
  4. Send a test message from Envoy to confirm

    5. This is a different issue: likely a session conflict or token problem, not a QR code problem. See our disconnection guide.

    If you see a specific error message after the scan (e.g., "cannot link device," account restrictions), note the exact error and contact support. Some account-level restrictions block device linking entirely.

    Was this article helpful?

    Related Articles

    Setup & Connection

    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 & Connection

    WhatsApp 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 & Connection

    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.