What you will get
You will know what Meta’s message means and what to do. If nothing works, you will choose between three exits: try again, move the same number fully to the API, or connect an Eva number. Each exit has a different effect on the number you use today.Requirements
- The phone with your WhatsApp Business app, if you want to keep the same number.
- A computer signed in to facebook.com in the browser.
- A Facebook that is an admin of your business’s Meta portfolio. Check it at business.facebook.com → Settings → People: your name must appear with full control. If you are not there, the business admin adds you there.
- Access to SMS or calls for the number, only if you move it to the API.
Check this first
Meta now asks for the number first: the “Add your WhatsApp phone number” screen, with the list “You don’t have any phone numbers. Create one.” and the text message or phone call options. That screen is the right one: type your app’s number there and tap “Next”. The QR code comes after you choose your business. The only things you must not do are type a 6-digit code that arrives by text message or call, or delete your app account. When Meta shows an error, use its option to report the error in that window: Eva receives the code and shows you the matching step. If two retries fail, select Ask for help in Eva.If Eva says Meta’s window closed
Eva shows a card based on the Meta screen where the window closed. Look for the card’s title here.The Meta window closed without finishing
What it means: Facebook asked you to sign in or approve on another device inside Meta’s window, or the window closed before its last screen. What to do: sign in to facebook.com in that browser and approve there. Close Meta’s windows, select Retry and stay until the last screen.Meta closed on the number screen
What it means: the window closed on Meta’s first screen, the one that asks for the number. That screen is normal. What to do: when you retry, type your WhatsApp Business app number and tap “Next”. The QR code appears after you choose your business.Meta closed while choosing the business
What it means: the window closed while Meta was asking you to choose your business’s portfolio. What to do: when you retry, choose your business’s portfolio. If it is not listed, your Facebook does not manage it: check at business.facebook.com → Settings → People that you have full control, or ask the business admin to add you there or to connect the number with their Facebook.The QR code wasn’t scanned
What it means: you were on the right path; the window closed while Meta was showing the QR code. What to do: when you retry and see the QR, open WhatsApp Business → Settings → Account → Business Platform, tap “Connect to the Business Platform” and scan it.The permissions weren’t approved
What it means: Meta closed on its last screen, before you confirmed. What to do: when you retry, confirm it is your business and continue until the window closes on its own.Facebook: “An error occurred. Close and reopen your browser”
What it means: the Facebook session in that browser failed. What to do: close every browser window, open it again, sign in to facebook.com and start again from Eva.If Meta shows an error
Each Meta message carries a code, such as #2494064. Eva shows it on the card as “Meta reference”. Look for the code or the card’s title here.Meta says the number is already registered (#2494064, #2388002) or asks for a text message code
Meta says “This phone number is already registered to a WhatsApp account” (#2494064), that it cannot add the number (#2388002), or asks for a text message or call code. In Eva: Meta didn’t take your number as WhatsApp Business. What it means: Meta is not taking your number as WhatsApp Business; it treats it as a new number. What to do: do not delete your app account. Update WhatsApp Business and open it. In the app, turn off two-step verification (Settings → Account); turn it back on when you are done. Ask the portfolio admin to delete, in WhatsApp Manager → “Phone numbers”, any pending or disconnected entry for this number. Wait 5 minutes and retry. If the number is on the regular WhatsApp app and not on WhatsApp Business, move it to WhatsApp Business first.
What Eva shows when Meta answers #2494064.
Your business is not listed, or Meta says you lack permission to view that asset (#3441038)
In Eva: Your Facebook can’t use this business’s portfolio. What it means: your Facebook does not administer the business’s portfolio. What to do: ask to be added with full control at business.facebook.com → Settings → People, or have the admin connect the number with their Facebook.Meta asks you to update the WhatsApp Business app (#4563015)
In Eva: Update WhatsApp Business on the phone. What it means: the app is too old. What to do: update it, open it and retry.Meta asks you to disconnect the business platform (#2655094, #3441049)
In Eva: This number is active on another platform. What it means: the number is still connected to another provider. What to do: in the app go to Settings → Account → Business Platform, disconnect the one listed, wait 15 minutes and retry.Meta says your account reached its phone number limit (#2388386)
Meta says that to use this phone number you need to delete one from Meta Business Suite or request additional numbers on your account. In Eva: Your Meta account reached its phone number limit. What it means: your business’s Meta portfolio already has every number Meta allows. Meta lets you register 2 numbers while the business is not verified and 20 once it is. There is no manual request to ask for more. What to do: choose one of these two exits, then retry from Eva.- Delete a number you no longer use in WhatsApp Manager → “Phone numbers”. Only an admin of the portfolio can delete it. Meta does not let you delete a number that sent paid messages in the last 30 days.
- If your business is not verified yet, verify it in business.facebook.com → “Security Center” → “Business verification”. Once Meta verifies the business, it raises the limit to 20 numbers on its own.
Meta says the feature is not available in that region (#3441042)
In Eva: Meta doesn’t offer this connection in the number’s country. What to do: keep using the app or connect another number.Meta asks for more activity or says the number is not eligible (#3441045, #3441034)
In Eva: Meta hasn’t enabled this number yet. What it means: Meta wants more use of the app before connecting it; it gives no fixed term. What to do: keep serving customers from WhatsApp Business and retry in a few days.The number is linked to another Meta tool (#2655082, #3441060, #3441061)
In Eva: The number is linked to another Meta tool. What it means: a Facebook Page, an AI agent or automated events use the number. What to do: in the app, unlink Facebook, Instagram and the AI agent, and turn off automatic lists. Then retry.Choose an exit
Try coexistence again
Do the steps above that match what you saw and start again from Eva with a Facebook that administers the portfolio. Meta decides on every attempt; there is no promise it will accept the number in the next session.Move the same number fully
This exit stops using that number in the WhatsApp Business app and moves it to the API. Deleting the account is irreversible: WhatsApp erases the chats, groups, business profile, backups and any WhatsApp Channel where that number is the only admin, and Eva does not import history through this path.- Before anything else, save what you need: export the chats you want to keep (Android: chat → More → Export chat; iPhone: tap the contact or group name → Export chat) and write down the whole business profile (name, category, description, address, hours, email, website, photo).
- On the phone, delete the WhatsApp Business account and wait three minutes.
- Return to Eva: open your agent, go to WhatsApp and choose It is already on the WhatsApp API
(another provider or my own Meta account). Enter the same number and receive the verification
code by SMS or call. If you prefer a direct address while signed in to Eva, replace
<agentId>with your agent ID:https://app.goeva.ai/agents/<agentId>/deploy/whatsapp?path=apiopens with that answer already selected.
Connect an Eva number
Select I do not have a number to buy an Eva voice number for about 149 MXN per month. Meta connects that number through the BYON flow, with verification by call code. It is a new number: customers will not be writing to the number in your current app.Meta connected a different number
If Eva shows the mismatch card, review the number you confirmed, the number Meta returned, and the WhatsApp Business Account (WABA) ID. Choose Try coexistence again to retry, Use an Eva number to continue with a new number, or Migrate my number to move the same number to the API. Delete a WhatsApp Business account in Meta only when the card shows that the returned number is different from the one you confirmed and the WABA ID is not one you use elsewhere. If either fact does not match your situation, take one of the other exits; Eva never deletes an account for you.How to know it worked
Your chosen exit worked when Meta finishes its part and Eva shows the number as connected. For the existing number, check that messages arrive in the selected channel. For an Eva number, share the new number only after it appears connected.If something goes wrong
Do not type a 6-digit code that arrives by text message or call, and do not delete your app account to “free” the number: that registers a new number and your number leaves the app. Buttons on a site such as GetButton andwa.me links only open a WhatsApp chat; they do not connect the
WhatsApp API.
If Meta answers the same way after you check these messages, return to the first exit or decide whether
you want the full migration or a new number. Eva does not control which Meta screen appears and
cannot release a number Meta keeps registered.