Log inStart Free Trial
Meta Tech Provider

Coexistence connection stuck or not finishing: what to check

A Coexistence connection that hangs usually stopped at one of three points: the phone never showed Meta's confirm screen after the QR code, the browser tab that opened Meta's window closed before the end, or Meta finished but the provider has not linked the number yet. Check the WhatsApp Business app and WhatsApp Manager before starting again.

easyCoexistence records each connection attempt and picks up numbers that Meta finished after the tab closed, so a stuck signup usually resolves without a second run.

Not a cancel

Meta says closing Embedded Signup on its final screen is not a cancel event; it counts as finished.

QR_CODE step

Meta reports WHATSAPP_BUSINESS_APP_ONBOARDING_QR_CODE when someone leaves a business app onboarding on the QR code screen.

CLOUD_API

Meta's test of a finished Coexistence connection: is_on_biz_app true and platform_type CLOUD_API on the number.

30 seconds

Time-to-live of the code Embedded Signup hands back, which is why a closed tab can lose it.

About 5 minutes

When Meta finished but the tab closed early, easyCoexistence links the number to the account on its own after about five minutes.

Where can a Coexistence connection get stuck?

The flow has five stages, and each one fails with its own symptom. Knowing which stage you reached saves a pointless retry. Login and portfolio problems end the window quickly. Number problems end with a message on the number screen. The phone stages are where a connection most often hangs without saying anything, and the last stage is where Meta can finish while the provider's page never hears about it.

1Login and portfolioMeta login, then the business portfolio and WhatsApp account
2NumberThe app's number is entered and Meta shows a QR code
3ScanScanned from inside the WhatsApp Business app
4Confirm on the phoneMeta's screen in the app: connect, then the history choice
5FinishMeta's window closes and the provider receives the result

The QR code was scanned but nothing happens: what now?

A working scan is quick. The camera inside the WhatsApp Business app reads the code, the app opens a Meta screen with a button to connect to the business platform and then the choice to share chat history, and the browser window finishes within seconds of the last tap.

If the phone never showed that screen, or the window has been waiting for many minutes, the pairing did not start, and waiting longer will not help. Close every Meta window and extra dashboard tab, open one, and scan within a couple of minutes: each window has its own code, so scanning an older one fails. On an older phone, choosing not to share history makes the pairing lighter.

Meta finished, but the number never appeared

This happens when the tab that opened Meta's window closed, reloaded or lost the window before the end. Meta still completes the connection on its side, and its "Connected" is real evidence: the phone may say the number is connected to a business platform, and WhatsApp Manager may list it.

On easyCoexistence, Meta's notice of the new connection reaches us even without the tab, and the number is linked to the account that was connecting about five minutes later. Wait for that, reload the dashboard, and do not connect again or remove anything meanwhile. If several accounts were connecting at the same moment, our team links it by hand instead of guessing.

"Selected business CoEx gate evaluation is missing"

This is one of Meta's internal strings, shown with no code. It means Meta's own eligibility check for the selected business had not run yet when the window asked for it. It is not a verdict on the number.

In our support history it has been temporary: the six customers who saw it up to 14 October 2026 all connected on a retry a few minutes later. Wait a minute or two and try once. Before retrying, check whether a connection finished anyway, for example from another window you had open, because then there is nothing left to do. If the same string comes back on the next attempt, ask your provider to raise it with Meta.

How do you confirm whether it finished?

Look in three places before starting over, because a second run is only useful when the first one really failed. Meta's own test is two fields on the phone number: is_on_biz_app true and platform_type CLOUD_API. Once the number is listed in your account, your AI can read those fields for you.

  • On the phone: the WhatsApp Business app says the number is connected to the API, and Settings > Account > Business Platform lists the provider.
  • In WhatsApp Manager > Phone numbers: the number appears with a status.
  • In your AI: ask it to run list_numbers, then get_number_health, which reads the live fields from Meta.

How do you start again without making it worse?

Once, and cleanly. Close every Meta window and every dashboard tab except one. Have the phone unlocked, online, with the WhatsApp Business app updated, and log in to the Meta account that manages the business in the same browser first. Then run the flow and stay on it until Meta's window closes by itself.

Connecting again is safe: it reuses the same connection at Meta and does not create a duplicate. What makes things worse is repetition. Several attempts in a row lead Meta to answer "You have tried too many times. Try again later." (codes 3441033 and 3441046), which adds a wait on top of the original problem.

Common mistakes

  • Opening several Meta windows at once. Each one has its own QR code, and scanning the code of an older window fails.
  • Closing the dashboard tab while the phone is still pairing. Meta may finish anyway, but the page that should show it is gone.
  • Removing the number or connecting again while it is being linked. Wait for the link, then reload.
  • Waiting a long time on a window when the phone never showed Meta's confirm screen. The pairing did not start; close it and redo it.
Doing this with EasyCoexistence

Once connected, your own AI and automations work on the number you keep in the app, and the connection is monitored around the clock. US$ 9 down to US$ 0.75 per number per month, falling as you add numbers, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Does a stuck connection affect the app on the phone?

No. Until the flow completes, nothing changes in the WhatsApp Business app, and chats keep arriving on the phone as before.

Am I charged for a connection that never finished?

No. The 3 free days start when the first number connects, so an attempt that never finished starts nothing.

How long should the whole flow take?

A few minutes from the Meta login to the closing screen, most of it on the phone. A window that waits much longer without the phone's confirm screen has stalled.

What should I send support if it keeps stalling?

The stage you reached, the exact sentence Meta's window showed with any number like #2494064, and the time of the attempt.

Keep reading

Ready to get started?

Set up WhatsApp Coexistence in minutes, not months. The app keeps working on the phone.

Start Free Trial

Verified on