Although connecting WhatsApp via QR on WaFloW.ai is a simple process, there are some common errors that can cause the integration to not work properly.
This document lists the most common problems, their causes, and how to solve them.
The QR code is scanned, but no messages are sent or received. #
Symptoms #
- The device appears as connected.
- WhatsApp shows the active session.
- However, messages are not sent or received.
Most common cause #
The phone provider in GoHighLevel is not configured correctly.
Solution #
From the GoHighLevel subaccount:
- Go to Settings → Phone System.
- Go to Additional Settings.
- Open the Phone Provider tab.
- Verify that it is selected:
- WhatsApp Connector
- Type: Custom Provider
- Save your changes.
⚠️ This step is essential for the integration to work.
The QR code expires before you scan it. #
Symptoms #
- The QR code is no longer valid.
- WhatsApp displays an error when scanning.
Cause #
The QR code has a limited validity for security reasons.
Solution #
- Generate a new QR code from WaFloW.ai.
- Scan it immediately.
- Do not leave the screen open for too long without scanning.
WhatsApp indicates that the device cannot be linked #
Symptoms #
- WhatsApp displays an error message when scanning.
- The link is not complete.
Possible causes #
- WhatsApp is not up to date.
- Connection problems on the phone.
- Use of unstable networks or VPNs.
Solution #
- Update WhatsApp to the latest version.
- Switch to a stable network.
- Avoid using VPNs during scanning.
- Regenerate the QR code and scan it again.
The device connects and disconnects shortly thereafter. #
Symptoms #
- The device appears connected and then disconnects.
- The state is constantly changing.
Common causes #
- Phone turned off or no connection.
- Frequent network changes.
- WhatsApp closed or forced.
Solution #
- Keep your phone turned on and connected to a stable network.
- Do not close WhatsApp.
- Use a dedicated device if possible.
The number is already linked in another system. #
Symptoms #
- WhatsApp does not allow you to link the device.
- Conflicts arise when scanning the QR code.
Cause #
A WhatsApp number cannot be linked to multiple incompatible systems simultaneously.
Solution #
- Disconnect the number from other systems.
- Use a number exclusively for WaFloW.ai.
- Please try connecting again.
The contact does not appear in GoHighLevel #
Symptoms #
- Messages come in, but the contact is not created.
- The conversation is not recorded in the CRM.
Possible causes #
- Subaccount not connected correctly.
- Unauthorized permissions.
- Incomplete device configuration.
Solution #
- Check that WaFloW.ai is installed in the correct subaccount.
- Check permissions in GoHighLevel.
- Check the device settings.
I scanned the QR code several times in a row. #
Symptoms #
- Erratic device behavior.
- Frequent disconnections.
Cause #
Scanning the QR code repeatedly may cause inconsistencies.
Solution #
- Generate a single QR code.
- Scan it just once.
- Wait for the connection to be confirmed before repeating.
When to contact support #
Contact support if:
- You have reviewed all of the above points.
- The problem persists after several attempts.
- The system does not show any clear errors.
📞 WaFloW.ai Support: +34 611 77 02 70
📞 Founder contact: +34 611 77 70 10
Summary #
Most problems when scanning the QR code are due to:
- Telephone provider incorrectly configured in GHL.
- Quick scan of the QR code.
- Unstable phones or networks.
- Prior linking of the number in other systems.
Following the correct configuration order prevents 90% of incidents.