> ## 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. # Connect WhatsApp > Connect your WhatsApp Business account to Kapso Connecting WhatsApp takes about 5 minutes using Meta's embedded signup flow. ## Before you connect Meta controls the login, business selection, and approval checks inside embedded signup. Before you start, make sure you have a Facebook account. During the flow you can create a Meta Business Portfolio and WhatsApp Business Account (WABA) if you need. If you already have these created, make sure you have: * access to the correct Meta Business Portfolio * access to the WhatsApp Business Account (WABA) * complete business information in Meta, including legal name, address, business phone number, and a public HTTPS website * no unresolved number-status or capacity issues in [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) * no unresolved WABA status, business verification, billing, or payment prompts in [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) * capacity in the selected Business Portfolio for another WhatsApp phone number Connecting a number does not bypass Meta requirements. Display-name review, business verification, WABA review, payment eligibility, template review, and country or account restrictions can still block production sending after the number is connected. ## Connection options | Option | Best for | Requirements | | --------------------------------------------------- | ---------------------------------- | ---------------------------------------------------- | | [**Instant setup**](#instant-setup-digital-number) | Get started immediately | Facebook account | | [**WhatsApp Business App**](#whatsapp-business-app) | Keep using the app alongside Kapso | Active WhatsApp Business App number and phone access | | [**Bring your own SIM**](#bring-your-own-sim) | Use your own phone number | Dedicated SIM card | ## Instant setup (digital number) Get a pre-verified US phone number without SMS verification. Before using this option: * use a Meta Business Portfolio that can add another WhatsApp phone number * choose a Kapso-provided or BSP-provided number inside Meta * watch the pre-signup guidance in Kapso if it appears, because it shows which Meta phone-number option to choose If Meta does not show a BSP-provided number, asks for SMS verification, or blocks setup, see [Instant setup troubleshooting](/docs/how-to/whatsapp/instant-setup-troubleshooting). In Kapso: 1. Go to **Connected numbers** → **Connect new number** 2. Select **Instant setup** 3. Confirm the instruction that you should choose a Kapso-provided or BSP-provided number in Meta 4. Watch the pre-signup guidance if Kapso shows it 5. Click through to open Meta embedded signup In Meta embedded signup: 1. Log in with the Facebook account that has access to your business. On **Seamlessly connect your account to Kapso**, review what Kapso will be able to do and click **Continue**. Meta embedded signup asks you to continue connecting the account to Kapso. 2. On **Select the business assets to share with Kapso**, choose the **Business portfolio** for the business you want to connect. Meta asks you to select the business portfolio to share with Kapso. 3. Choose an existing **WhatsApp Business account**, or create one if Meta asks you to. Meta asks you to select the WhatsApp Business account to share with Kapso. 4. On **Add your WhatsApp phone number**, do not choose **Use a display name only**. Choose **Use a new or existing WhatsApp number**. Meta shows Use a new or existing WhatsApp number on the Add your WhatsApp phone number screen. 5. Open the **Phone number** dropdown, select a number under **BSP provided number**, and click **Next**. Meta shows the BSP provided number option in the phone number dropdown. 6. When Meta shows **Your account is connected to Kapso**, click **Finish**. This final step sends you back to Kapso so the connection can be completed. Meta confirms that the account is connected to Kapso. After Meta returns you to Kapso, Kapso finalizes the connection and shows the phone number as connected. Kapso shows the phone number as connected after Meta returns to the app. If the WABA is still under Meta review, the number may stay pending until Meta finishes that review. Kapso shows the saved WABA status in the UI and automatically retries registration when Meta sends the review update. While waiting, make sure the Meta Business Portfolio has complete business information, including legal name, address, business phone number, and a public HTTPS website. The small deposit goes directly to your project credits. Available on all plans. If you need local numbers, your own Twilio account, or project-owned reusable pools, see [Provide local numbers](/docs/platform/phone-numbers/provide-local-numbers). If the flow asks for SMS verification instead of instant setup, cancel and retry. If it persists, see [Instant setup troubleshooting](/docs/how-to/whatsapp/instant-setup-troubleshooting). ## WhatsApp Business App Keep using the WhatsApp Business app on your phone alongside Kapso. Before using this option: * make sure the number is active in the WhatsApp Business App, not the personal WhatsApp app * update the WhatsApp Business App and keep the phone nearby with a working camera * disconnect old providers, partners, or stale WABA links before retrying a migrated number * use the QR-based WhatsApp Business App path; if Meta sends you to SMS or voice verification, restart from Kapso and choose **WhatsApp Business App** If the number does not connect, your WABA does not appear, or Meta sends you to the wrong onboarding path, see [Coexistence troubleshooting](/docs/how-to/whatsapp/coexistence-troubleshooting). In Kapso: 1. Go to **Connected numbers** → **Connect new number** 2. Select **WhatsApp Business App** 3. Click through to open Meta embedded signup In Meta embedded signup: 1. Log in with the Facebook account that has access to your business. On **Seamlessly connect your account to Kapso**, review what Kapso will be able to do and click **Continue**. Meta embedded signup asks you to continue connecting the account to Kapso. 2. On **Select the business assets to share with Kapso**, choose the **Business portfolio** for the business that owns this WhatsApp number. Meta asks you to select the business portfolio to share with Kapso. 3. In **WhatsApp Business account**, choose **Connect a WhatsApp Business App** and click **Next**. Meta shows the Connect a WhatsApp Business App option under WhatsApp Business account. 4. On **Enter your WhatsApp Business phone number**, select the country code, enter the phone number that is already active in your WhatsApp Business App, and click **Next**. Meta asks for the WhatsApp Business phone number already active in the app. 5. On **Connect your existing WhatsApp Business App**, review the sharing access and protection information, then click **Next**. Meta explains what will be shared when connecting the existing WhatsApp Business App. 6. When the QR code appears, keep the browser window open and open the WhatsApp Business App on your phone. The phone camera view shows the QR code on the Meta pairing screen. 7. On your phone, tap **Connect to the Business Platform** in the WhatsApp Business App. The WhatsApp Business App shows the Connect to the Business Platform screen. 8. Use the WhatsApp Business App camera to scan the QR code shown by Meta. The WhatsApp Business App asks you to scan the QR code from Meta embedded signup. 9. Choose whether to share chat history, then confirm your choice. The WhatsApp Business App asks whether to share chat history. 10. Back in Meta, on **Confirm or edit your WhatsApp Business account**, confirm the WhatsApp Business account name, select the account **Timezone**, and click **Next**. Meta asks you to confirm the WhatsApp Business account name and timezone. 11. On **Review what you'll share with Kapso**, review the requested access and click **Confirm**. Meta shows the permissions Kapso will receive for the selected business and WhatsApp account. 12. When Meta shows **Your account is connected to Kapso**, click **Finish**. This final step sends you back to Kapso so the connection can be completed. Meta confirms that the account is connected to Kapso. After Meta returns you to Kapso, Kapso finalizes the connection and starts syncing the coexistence number. Messages can then appear in both the WhatsApp Business App and Kapso. Kapso shows the WhatsApp Business App number as connected after Meta returns to the app. If Meta asks for SMS or voice verification instead of showing the QR pairing flow, stop and restart from Kapso with **WhatsApp Business App** selected. The SMS or voice path is for a different connection mode. ## Bring your own SIM Use a phone number you already control as a dedicated Cloud API number. This path is for a number that can move fully to Kapso's API connection. It is not for keeping the same number active in the WhatsApp Business App. Before using this option: * keep the SIM, phone line, or landline available during setup * use a number you can verify by SMS or voice call * make sure the number is not already connected to another Kapso project * remove the number from previous providers or WhatsApp Business App registrations before retrying In Kapso: 1. Go to **Connected numbers** → **Connect new number** 2. Select **Bring your own SIM** 3. Click through to open Meta embedded signup In Meta embedded signup: 1. Log in with the Facebook account that has access to your business. On **Seamlessly connect your account to Kapso**, review what Kapso will be able to do and click **Continue**. Meta embedded signup asks you to continue connecting the account to Kapso. 2. On **Select the business assets to share with Kapso**, choose the **Business portfolio** for the business that owns this phone number. Meta asks you to select the business portfolio to share with Kapso. 3. Choose an existing **WhatsApp Business account**, or create one if Meta asks you to. Meta asks you to select the WhatsApp Business account to share with Kapso. 4. On **Add your WhatsApp phone number**, do not choose **Use a display name only**. Choose **Add a new number**. Meta shows Add a new number on the Add your WhatsApp phone number screen. 5. Select the country code, enter the phone number you want Kapso to use, enter the **WhatsApp Business display name**, choose **Text message** or **Phone call**, and click **Next**. Meta asks for the SIM phone number, display name, and verification method. 6. On **Verify your phone number**, enter the 6-digit verification code from Meta and click **Next**. Meta asks for the 6-digit verification code sent by text message or phone call. 7. When Meta shows **Your account is connected to Kapso**, click **Finish**. This final step sends you back to Kapso so the connection can be completed. Meta confirms that the account is connected to Kapso. After Meta returns you to Kapso, Kapso registers the number, creates the production WhatsApp configuration, and shows the number as connected. Kapso shows the SIM phone number as connected after Meta returns to the app. If Meta accepts the flow but the WABA is still under review, the phone number can remain pending. Kapso saves the WABA status and shows it in the UI as the number's **Business Account Status**, such as **Review pending**, **Review deferred**, **Review rejected**, or **Restricted**. When Meta sends the review update, Kapso automatically retries phone registration. While waiting, make sure the Meta Business Portfolio has complete business information and check [WhatsApp phone numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers) for the number status. If Meta points to account-level setup, use [WhatsApp account settings](https://business.facebook.com/latest/settings/whatsapp_account) to check WABA status, business verification, billing, and payment prompts. If SMS or voice verification keeps failing, stop retrying before Meta rate-limits the number. Confirm the number is not still attached to another WABA, provider, WhatsApp Business App account, or Kapso project before trying again. If Meta does not show the expected number, SMS or voice verification fails, or Meta says the number is already linked somewhere else, see [Bring your own SIM troubleshooting](/docs/how-to/whatsapp/bring-your-own-sim-troubleshooting). ## Manual setup and Meta apps If you manually add a WhatsApp phone number instead of using embedded signup, Kapso may need your Facebook App ID and App Secret to validate incoming Meta webhooks. You can find these in Meta under **App settings** → **Basic**. In Kapso: 1. Go to **Phone numbers** 2. Open **Meta apps** 3. Create a Meta app with your App ID and App Secret 4. Edit the manually added phone number 5. Select the Meta app 6. Save If a manually added number can send messages but does not receive inbound messages, check this first. This is not your WhatsApp access token; App Secrets are stored write-only in Kapso. ## If the popup doesn't load Disable ad blockers and privacy extensions. They block Meta's SDK. Try Chrome or Firefox if Safari isn't working. ### Why to avoid Display name only In all of the signup flows in Meta you might find a **Display name only** option. If you choose it, you may complete Meta signup but end up with a limited Meta-managed number instead of the intended production number. Consequences: * The connected number may not be the Kapso-provided number, BSP-provided number, project-pool number, or SIM number you meant to connect. * These limited Meta-managed numbers can stop working after about 5 messages and ask for display-name approval before you can keep using them. * Display-name approval can take a long time, and Meta may defer the decision. While the decision is pending or deferred, you may be left unable to use the number. * You may need to delete or disconnect that WhatsApp profile and restart onboarding through the correct Kapso flow. Need help? In Kapso, go to the sidebar, click 'Help' and select 'Support'