Skip to main content
Coexistence lets you use the WhatsApp Business App and Kapso at the same time. It is convenient, but less stable than a dedicated Cloud API connection. Use this page if:
  • your existing WhatsApp Business App number does not connect correctly
  • your WABA does not appear in Meta embedded signup
  • the number was previously connected to another provider
  • you chose or are considering Display name only option in Meta’s flow
  • you see Meta errors like 3441041 or 2655093
  • Meta says the phone number is not eligible and needs more WhatsApp Business App activity

​
Before you start

Coexistence does not remove or bypass:
  • display-name approval requirements
  • business verification requirements
  • payment-method restrictions
  • template restrictions
If you need maximum stability for production, use Connect WhatsApp and choose the dedicated / Cloud API path instead.

​
Standard coexistence setup

  1. Go to Connected numbers → Connect new number in Kapso.
  2. Choose WhatsApp Business App and open Meta embedded signup.
  3. Log in with the Facebook account that administers your Business Portfolio.
  4. Follow the Business App connection flow and complete app pairing when prompted.
  5. Finish the Meta flow and return to Kapso.
Meta is rolling out two versions of this flow. One offers Connect a WhatsApp Business App before asking for the number. Another asks for the number first, then detects that it is active in WhatsApp Business App and routes to coexistence. Entering your number is normal in either version; the screens do not always appear in the same order.

​
Connection issues

​
Number is already linked to another account or provider

Use these steps when you want to keep using WhatsApp Business App and Meta says the number or WhatsApp Business Account (WABA) is already connected, occupied, or shared with another partner. If the number is currently a dedicated Cloud API connection, contact support to plan the change to coexistence first. Do not remove a working connection as routine troubleshooting.
  1. If you used another provider, request disconnection from its website or app first. Check WhatsApp Business App → Settings → Account → Business platform for any remaining connection. Disconnection does not guarantee that the provider’s credit line was revoked.
  2. Open Meta WhatsApp account settings, select the correct Business Portfolio, and select the affected WABA.
  3. If the WABA is visible, open Summary → Payment method. If it shows Credit line, note the provider name. An empty Partners tab alone does not confirm that billing was disconnected.
  4. If the previous provider’s credit line remains, or its removal is uncertain, ask that provider to revoke the credit-line allocation for this WABA and confirm completion. If it shows Kapso, contact Kapso Support so we can review and revoke our allocation. Tell us if the number is still active in another Kapso project before disconnecting it.
  5. Once funding is cleared, remove the affected WhatsApp account from the Business Portfolio in the same Meta settings page. A coexistence WABA belongs to the Business App and contains its single number; you cannot add other numbers to it. Preserve any templates you need before removing it.
  6. Wait 5 minutes, then reconnect through Kapso’s WhatsApp Business App flow. Let the flow connect the Business App from scratch and create a new WABA. You do not need to find a separate Create WABA button or create a new portfolio.
Removing the WABA from the Business Portfolio is different from deleting your WhatsApp Business App account. Do not use Settings → Account → Delete account in the phone app to recover coexistence.
If you have never used another provider, start with the WABA check in step 2. A residual WABA association can still need removal. If the WABA is not visible, check your other accessible portfolios and admin access. For a persistent partner-sharing error such as 2655093, ask your previous provider to confirm credit-line revocation even if you cannot inspect the WABA yourself. If there was no previous provider, or revocation is already confirmed, contact Kapso Support with the evidence below. If funding is cleared but Meta blocks WABA removal, or the same error remains after removal, the five-minute wait, and one reconnect, contact Kapso Support. We can escalate the case to Meta. Do not repeat cleanup or wait 72 hours just for a residual partner/WABA association.

​
Existing WABA does not appear in embedded signup

This usually means one of these:
  • you selected the wrong Business Portfolio in Meta
  • the WABA is still controlled by another partner
  • the number is still tied to an older WABA or app assignment
Confirm the Facebook account, admin access, and Business Portfolio. For a stale association, follow the recovery steps above, including the payment-method check. A coexistence reconnect creates a new WABA through the Business App flow; selecting the old WABA is not required.

​
Meta shows the wrong onboarding option

During onboarding, choose the path for connecting the WhatsApp Business App through Kapso. Choosing the wrong option can leave the number attached to the wrong app or with missing webhook subscriptions. Do not choose Display name only. That Meta option can create a WhatsApp profile with a generic, limited Meta-managed number instead of pairing the WhatsApp Business App number you already use. These numbers can stop working after about 5 messages and require display-name approval before you can keep using them. If Meta actually asks you to receive or enter an SMS or voice verification code instead of Business App pairing, stop and send Kapso Support screenshots or a recording of the full flow. Include the option selected in Kapso and what Meta showed next. Number entry alone is not SMS verification, and the newer flow may not show an explicit Business App selector first. If you already completed setup with Display name only, contact support to identify that unintended profile before disconnecting it and reconnecting your Business App number.

​
Phone number is not eligible or needs more app activity

Meta can block the phone-number step with a message that the number is not eligible to connect to the WhatsApp Business Platform, or that more activity in the WhatsApp Business App is needed to determine eligibility. Make sure the number is active in WhatsApp Business App, not personal WhatsApp, and that the app is updated. Follow any activity requirements Meta displays. There is no guaranteed wait period or account reset that makes a number eligible. Do not delete and recreate the Business App account to bypass eligibility. If the message persists, contact support with the exact text and screenshots. Use the partner/WABA cleanup above only when there is evidence of an existing association.

​
Error 3441041

This error indicates that the number is not associated with the business selected in the flow. Confirm the selected Business Portfolio and number first. If an old portfolio or WABA association remains, use the coexistence recovery steps.

​
Error 2655093

This error indicates that the WABA is already shared with another partner and this flow cannot switch partners. It does not prove a credit line remains attached. Use the coexistence recovery steps to distinguish the provider connection, credit-line allocation, and WABA association. A provider saying “disconnected” or disappearing from Partners is not sufficient proof of credit-line revocation.

​
Switching to dedicated Cloud API

If you deliberately want to stop using WhatsApp Business App on this number, contact support to plan a dedicated / Bring Your Own SIM cutover. This is a separate process that can require deleting the Business App account and backing up data before disconnecting the existing Kapso connection. Do not use it as a workaround for coexistence errors.

​
Known limitations

These are known behaviors customers should expect:
  • occasional disconnects
  • some WhatsApp Web sync issues
  • some contact-name sync issues
  • some first inbound messages may not reach Kapso immediately
  • calling through Kapso is unavailable — you can still make and receive calls in WhatsApp Business App
  • the display name is managed in WhatsApp Business App, not in Kapso
If your use case needs stable automation, templates, webhooks, and production reliability, use the dedicated / Cloud API path instead.

​
Restrictions still apply

If you connect a number in coexistence mode, Meta restrictions are still enforced. Examples:
  • display name still needs approval when Meta requires it
  • business verification may still be required
  • template sending can still be blocked by payment issues
Coexistence only changes the connection mode. It does not remove WABA-level restrictions.

​
When to contact support

Contact support if:
  • you already completed the cleanup steps above
  • the correct WABA still does not appear
  • 3441041 or 2655093 still persists after cleanup
  • you suspect an old partner still controls the account but cannot remove it
To speed up support, include:
  • the phone number and intended connection type
  • phone_number_id, waba_id, and Business Portfolio ID if available
  • the previous provider and its confirmation of credit-line revocation, if applicable
  • screenshots of Summary → Payment method, the WABA association, and any failed removal
  • the full error text/code and a recording or screenshots of the Meta flow
  • when you removed the WABA, waited, and retried
Missing IDs do not prevent you from contacting support.