WhatsApp coexistence not working: fix pairing errors, sync gaps and disconnects

WhatsApp coexistence not working: check these first

Most coexistence failures come down to six requirements, and checking all of them takes a couple of minutes. The first five are Meta’s; the last one is about how Whapi’s setup opens Meta’s window.

“Error while pairing Cloud API” and other pairing errors

“Error while pairing Cloud API” means the WhatsApp Business app and the Cloud API didn’t finish linking. Meta doesn’t document that phrase on its own, but its signup error reference lists the specific messages this flow can show, and each one has a known fix:

Fix a pairing error step by step

1. 1

   Update the WhatsApp Business app

   Install the latest WhatsApp Business app from the App Store or Google Play. Meta requires version 2.24.17 or later for coexistence.
2. 2

   Disconnect any old business platform

   In the WhatsApp Business app, open Settings > Account > Business Platform. If a platform is listed, select it and tap Disconnect, then wait 15 minutes as Meta instructs.
3. 3

   Use the phone where the number is registered

   Keep the WhatsApp Business app open on the main phone for this number, with a stable internet connection, until the connection finishes.
4. 4

   Start again from Whapi on a computer

   Open Whapi in your Shopify admin on a computer, allow popups, click Connect WhatsApp and choose Connect a WhatsApp Business App.
5. 5

   Match the exact message Meta shows

   If the connection fails again, read the message in Meta’s window and find it in the pairing error table. Each one has its own fix.
6. 6

   Send the message to Whapi support

   If none of the fixes work, email Whapi support with a screenshot of the error. If the number can’t use coexistence, Whapi can also run on a separate number connected to the API only.

QR code or verification code not working

The link finishes inside the WhatsApp Business app, so a code that “does nothing” usually means the app side hasn’t been completed. In Meta’s flow, after you enter your number:

1. Meta shows a code in the signup window.
2. Your WhatsApp Business app receives a message from the official Facebook Business account. Tap Connect.
3. Tap Connect to the Business Platform.
4. Choose whether to share your chat history, then confirm.
5. Enter or scan the code to finish.

If the message from Facebook doesn’t arrive, check that the phone is online and the app is open, then start the connection again. You can also open the app’s Settings > Account > Business Platform screen and connect from there. If Meta says “You have guessed too many times”, wait about 12 hours before you retry, as Meta advises. “You have requested your code too many times” also means waiting before you request another code.

Coexistence keeps disconnecting

Meta disconnects the API side of coexistence for specific, documented reasons, and it tells the connected platform which one applied. Your WhatsApp Business app keeps working; only automations stop until you reconnect.

After a phone change or reinstall, Meta lists your previously connected products with a pre-checked opt-in while you register. If you leave it checked, Meta restores the connection in the background, usually within a few minutes. API messages can’t be sent during that time, and linked devices such as WhatsApp Web have to be linked again by hand. So avoid reinstalling the app or switching phones in the middle of a busy sales day.

Linked devices, WhatsApp Web and Windows

Coexistence works with up to four linked devices. Meta supports every companion app except WhatsApp for Windows and WhatsApp for WearOS.

• When you connect, Meta unlinks every linked device. Link the ones you need again afterwards.
• Messages from a customer who uses an unsupported companion app may not reach the connected platform, and your messages viewed on an unsupported device show placeholder text asking the customer to open their main phone.
• Meta can also report error 131060 the first time a new customer messages you, often from a Click to WhatsApp ad. Meta says it usually clears within seconds; check the WhatsApp Business app for that message.

Every linked device is another session that has to stay active, so link only the devices you use. If several people answer customers, Whapi’s Team Inbox gives each agent access without extra linked devices.

Chat history or contacts didn’t sync

Meta lets the connected platform sync your contacts and the last 6 months of one-to-one chats once, within 24 hours of connecting, and only if you agreed to share chat history in the app.

• Group chats are never synced.
• If you chose not to share history, no past chats are shared.
• Keep the WhatsApp Business app open and online while it syncs. Meta says it can take several minutes, depending on how much history there is.
• If the 24-hour window passes or the sync fails, Meta requires disconnecting and connecting again before history can be synced.

New messages are different: anything you send from the WhatsApp Business app after connecting is mirrored to the connected platform, and automated messages appear in the app’s chat history.

Features that change in the WhatsApp Business app

Connecting to the API turns off a few WhatsApp Business app features and leaves the rest alone. This is how Meta lists the changes:

For bulk messages after broadcast lists are disabled, send WhatsApp broadcasts from Whapi as approved marketing templates to customers who opted in.

Messages from the app and messages from Whapi

Messages you send from the WhatsApp Business app stay free. Messages sent through the Cloud API, such as Whapi’s order confirmations, are charged at Meta’s per-message rates on the WhatsApp API pricing page. The 24-hour customer service window applies only to API messages. A number used with both the app and the API has a fixed throughput of 20 messages per second.

Reconnect coexistence from Whapi

When the connection drops, reconnect from Whapi and leave the WhatsApp Business app installed, because a reinstall disconnects the API again. In the Whapi dashboard inside Shopify, a connected number shows a green status. If it doesn’t, click Connect WhatsApp, choose Connect a WhatsApp Business App and follow the steps in the app.

To end coexistence completely, disconnect in the WhatsApp Business app under Settings > Account > Business Platform. Meta doesn’t let a platform deregister a number that is used with both the app and the API, so the disconnect always happens in the app.