> ## Documentation Index > Fetch the complete documentation index at: https://docs.zavu.dev/llms.txt > Use this file to discover all available pages before exploring further. # Troubleshooting WhatsApp Signup > What each failure in the Meta signup dialog means, and what fixes it Connecting WhatsApp runs through Meta's embedded signup dialog. When it fails, the dashboard reports the failure to the Zavu assistant, which opens with a diagnosis. This page is the same knowledge, organised by where the signup gave up, so you can read it without the assistant. Four places can fail, in order. Find the one that matches what you saw. ## 1. Before Meta's window opened You never saw Meta at all. | What you saw | Cause | Fix | | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | Nothing happened, then "your browser blocked the WhatsApp window" | The browser blocked the popup. In-app browsers and strict privacy settings do this. | Allow pop-ups for the dashboard, then **Retry connection**. | | "Facebook's script did not load" / "Facebook SDK not loaded" | An ad blocker, privacy extension or network filter stopped `facebook.com`. | Disable the blocker for the dashboard or use a plain Chrome profile, refresh, retry. | | "Meta sign-in only works on HTTPS" | The dashboard is open over plain `http` on a custom host. | Open the `https` address. | | "WhatsApp signup is not configured" | The deployment is missing its Meta configuration. This is on Zavu's side. | Contact support. Nothing on your side fixes it. | ## 2. Inside Meta's window The window closed or refused before the end. The message names the reason; Meta's own code is the strongest evidence. | Message | Cause | Fix | | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | "The Meta window was closed before finishing. Nothing was connected." | You closed the window. | Nothing is left half-done. Retry when ready. | | "You need to authorize the app to continue." | A permission was declined or the consent screen was not finished. | Retry and accept every permission Meta lists. All of them are required. | | Meta reference **#1752206** — "Meta could not add your Facebook profile to a business portfolio" | You signed in as a Page or a professional account, or the Facebook account is brand new. | Sign in with your personal Facebook profile, confirm its email and phone, retry. Accounts created today are often blocked for a few hours. | | **#1752224** or **#1752089** — "Meta is still processing an earlier attempt" | An earlier attempt to create the business portfolio is still in progress. | Wait a few minutes, retry. | | **#1690114** — "reached Meta's limit of business portfolios" | Your Facebook account is at Meta's portfolio limit. | Pick a portfolio you already own, or remove one in Meta Business Suite. | | **#2388098** or **#2494067** — "maximum number of WhatsApp Business Accounts" | The portfolio is at its WhatsApp Business Account limit. | Complete Meta business verification, or delete an unused WhatsApp Business Account in Meta Business Suite. | | **#1357053** — "Meta has restricted this action" | Meta restricted the Facebook account or portfolio. | Try another portfolio, or contact Meta Business Support. Zavu cannot lift a Meta restriction. | | "Meta could not finish the connection: …" | Any other Meta error, quoted verbatim. | Keep the reference, trace and session ids the dashboard shows; Meta Business Support asks for them. | ## 3. Meta finished but handed Zavu nothing | Message | Cause | Fix | | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | "Could not retrieve WhatsApp Business Account information" | Meta's window did not post an account id back. Usually a browser extension swallowed the message, or a screen in Meta's dialog was skipped. | Complete every screen in Meta's dialog, use Chrome with extensions off, retry. | | "Could not retrieve phone number information" | Same, for the phone number. The phone number screen is the one most often skipped. | Finish the phone number screen, retry. | | "No authorization code received from Meta" | Meta returned no authorization code. | Retry. | | "This connection attempt expired" | The same authorization was submitted twice. | Close the window and start the signup again from the button. | ## 4. Meta finished, Zavu refused | Message | Cause | Fix | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "This phone number is already registered to another WhatsApp account" | The number is on another WhatsApp account: the WhatsApp Business App or personal WhatsApp on a phone, or another provider's WhatsApp Business Account. | If it is on another provider, remove it in [WhatsApp Manager](https://business.facebook.com/wa/manage/phone-numbers/), wait up to three minutes, retry. If it is on a phone, either keep the WhatsApp Business App and connect in coexistence mode, or delete the WhatsApp account from that phone first. Personal WhatsApp has no coexistence: delete it from the phone or use a different number. | | "Failed to register phone number: …" | The connection exists but the number is in `pending_registration`. It cannot send or receive until registration succeeds. Zavu retries every hour. | See the table below. | ### Registration failures The sender shows as connected but the number does not send or receive. The reason is in the error message. | Meta error | Cause | Fix | | -------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------- | | `133005` | A two-step verification PIN was set from another app. | Turn two-step verification off in WhatsApp Manager, or reconnect once you have the PIN. | | `2593005` | The number never completed its SMS or call verification. | Verify the number in WhatsApp Manager. | | "not verified" | The business is not verified with Meta. | Complete Meta business verification. The hourly retry clears it on its own. | | "display name" | Meta rejected the display name. | Change the display name in WhatsApp Manager, then reconnect. | | `133016` | Ten register attempts in 72 hours. | Wait out the window. Do not keep retrying. | | `190` | The access token no longer works. | Reconnect from the button. | ## Route-specific causes **A number bought in Zavu.** Meta verifies it by a phone **call**; choosing SMS never delivers a code. A number still under regulatory review cannot be connected until it is approved. A Brazilian number cannot complete Meta's registration; use coexistence with a WhatsApp Business App number instead. **Coexistence (keeping the WhatsApp Business App).** It needs the number registered on WhatsApp Business (not personal WhatsApp), admin access to the Facebook business that owns it, and a supported country: Nigeria and South Africa are not. If the "Connect WhatsApp Business App" option never appears in Meta's dialog, one of those is missing. If the number's credit line is still shared with another WhatsApp partner, Meta refuses the switch until you follow Meta's switch-partner guide. ## Next Steps * [Connect WhatsApp](/guides/whatsapp/connect-whatsapp) * [WhatsApp Business App Connection](/guides/whatsapp/business-app) * [WhatsApp Error Codes](/guides/whatsapp/error-codes)