Skip to main content
Instant setup uses Meta embedded signup to connect a Kapso-provided WhatsApp number. For an explanation of instant setup and a full setup walkthrough, see Connect WhatsApp. Use this page if:
  • Meta does not show BSP provided number
  • you chose or are considering Display name only option in Meta’s flow
  • Meta asks for SMS or voice verification
  • your Business Portfolio or WABA does not appear
  • Meta blocks setup with an account, business, or phone-number error
  • Meta says the WABA is unverified or under account review
  • the number stays pending after setup

Before you retry

Instant setup only works when you select a Kapso-provided number inside Meta. Before restarting setup, check:
  • you are logged into the correct Facebook account
  • you have admin or sufficient access to the right Meta Business Portfolio
  • the selected Business Portfolio has capacity for another WhatsApp phone number
  • WhatsApp phone numbers does not show unresolved number-status or capacity issues
  • WhatsApp account settings does not show unresolved WABA status, business verification, billing, or payment prompts
  • your business profile has complete information, including a public HTTPS website if Meta asks for one

Common issues

Meta popup does not open

Try this first:
  1. Use Chrome or Firefox.
  2. Disable ad blockers and privacy extensions for the setup session.
  3. Allow popups and cookies.
  4. Log into Facebook before restarting setup.
  5. Restart instant setup from Kapso.

Business Portfolio or WABA is missing

This usually means the wrong Facebook account is logged in, the WABA belongs to another Business Portfolio, or your Meta user does not have enough permissions. What to do:
  1. Confirm you are logged into the Facebook account that owns or manages the business.
  2. Open Meta Business Settings and verify the WABA exists under that business.
  3. Ask a Meta business admin to grant access if you cannot see the business or WABA.
  4. Retry instant setup after access is corrected.

Business profile step is stuck

If Meta stops on a business profile step and Next is disabled, the business profile data may not pass Meta validation. What to do:
  1. Use a real public HTTPS website.
  2. Confirm the website loads in an incognito browser.
  3. Make sure the legal name, address, website, and phone number match the business.
  4. Restart the Meta popup after updating the information.

Meta does not show BSP-provided numbers

If Meta only shows Add a new WhatsApp number or asks you to type a phone number, do not continue in that flow. What to do:
  1. Cancel the Meta popup.
  2. Restart instant setup from Kapso.
  3. Choose Use a new or existing WhatsApp number at the phone-number step.
  4. Select a number under BSP provided number.
  5. If the BSP section is still missing, check WhatsApp Manager for account limits or restrictions.
Useful Meta pages:

You chose Display name only

Do not use Display name only for instant setup. That Meta option can create a WhatsApp profile with a generic, limited Meta-managed number instead of connecting the Kapso-provided number selected by instant setup. These numbers can stop working after about 5 messages and require display-name approval before you can keep using them. Approval in these cases might also take significantly longer. What to do:
  1. If you are still in the Meta popup, cancel it.
  2. Restart instant setup from Kapso.
  3. At the phone-number step, choose Use a new or existing WhatsApp number.
  4. Select a number under BSP provided number.
  5. If you already completed setup with Display name only, disconnect or delete that profile if needed before restarting instant setup.
  6. If you cannot reach the BSP-provided number path, contact support with screenshots from the Meta popup.

BSP-provided numbers are visible but fail

Visible BSP-provided numbers do not always mean the Kapso number pool is the blocker. Meta can still reject setup because of WABA, Business Portfolio, compliance, or phone-number-capacity state. What to do:
  1. Open WhatsApp phone numbers for the same Business Portfolio used in setup.
  2. Check number status, phone-number capacity, and any visible warnings on the selected WABA.
  3. Resolve any Meta warnings, restrictions, or review requests.
  4. Retry instant setup after Meta clears the issue.

Meta asks for SMS or voice verification

SMS or voice verification means Meta moved you into manual number registration, not instant setup. What to do:
  1. Cancel the Meta popup.
  2. Restart instant setup from Kapso.
  3. At the phone-number step, select a number under BSP provided number.
  4. Do not type a new phone number.

Business Portfolio cannot add another phone number

Meta enforces phone-number capacity at the Business Portfolio level. New portfolios usually start with capacity for 2 registered WhatsApp business phone numbers. Meta can later raise this to 20 after business verification or after the portfolio reaches a 2,000 messaging limit. When the portfolio has no capacity left, Meta’s embedded signup can fail without a clear inline error. The UI can show only a red indicator on the phone-number step, disable Add phone number, or show capacity text such as 1 of 2 added. What to do:
  1. Open WhatsApp phone numbers.
  2. Review all phone numbers across every WABA under the selected Business Portfolio.
  3. Remove unused, pending, or stale numbers if you have Meta admin access.
  4. Complete Meta Business Verification if you need higher phone-number limits.
  5. Retry after Meta shows capacity is available.

Meta shows error #2655121

This usually points to a Meta-side restriction on the selected WABA or Business Portfolio. What to do:
  1. Open WhatsApp phone numbers.
  2. Review WABA, phone-number, or Business Portfolio alerts.
  3. If Meta points to account-level setup, open WhatsApp account settings and check WABA status, business verification, and billing or payment prompts.
  4. Use Meta’s Request Review option if available.
  5. Retry instant setup only after Meta clears the restriction.

Meta shows error 141000

This means Meta could not link the phone number to the selected WhatsApp account, or the number stayed pending or blocked after selection. What to do:
  1. Check the selected WABA in WhatsApp Manager.
  2. Resolve any WABA verification or account warnings.
  3. Retry instant setup.
  4. If the same Kapso-provided number remains pending, restart and choose a different BSP-provided number.

WABA review is pending

Every newly created WABA goes through a Meta review before it is fully onboarded. During this period, the number can stay pending even if the Meta Business Portfolio already shows as verified. In Kapso, an issue may appear on the connected number raising this issue. What to do:
  1. Open WhatsApp phone numbers and confirm the number status.
  2. Make sure the Meta Business Portfolio has complete business information, including legal name, address, business phone number, and a public HTTPS website.
  3. Complete any visible Meta-requested action if one appears.
  4. If no action appears, wait for Meta to finish the WABA review.
Kapso saves the WABA review status and shows it in the UI while the number is pending. When Meta sends the WABA review update, Kapso automatically retries phone registration. You do not need to keep restarting instant setup unless support asks you to.

WABA is banned or restricted

If Meta shows errors such as 141014, 131031, or language about a banned WABA, account lock, compliance review, or business review, the blocker is controlled by Meta. What to do:
  1. Open WhatsApp phone numbers and check for WABA or phone-number warnings.
  2. If Meta points to account-level setup, open WhatsApp account settings and check WABA status, business verification, and billing or payment prompts.
  3. Complete any requested business verification, review, or remediation steps.
  4. Retry with a WABA that is not blocked.

Still stuck?

Contact support with:
  • your Kapso project URL
  • the Business Portfolio and WABA you selected
  • the exact Meta error text
  • screenshots from the Meta popup
  • screenshots from WhatsApp account settings or WhatsApp phone numbers if they show warnings