Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
  • 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:

​
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. The UI can show a red step, disable Add phone number, or show capacity text such as 1 of 2 added. What to do:
  1. Open WhatsApp Manager.
  2. Review all phone numbers across every WABA under the selected Business Portfolio.
  3. Remove unused 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