How to Set Up WhatsApp for a Sub-Account

Modified on: Thu, 12 Nov, 2026 at 7:15 AM

WhatsApp Business Integration Guide

Connect your WhatsApp Business account to LeadConnector. Choose the method that fits your situation.

Method 1 Connect Your Existing WhatsApp Business App
Unsupported CountriesThe Coexistence feature is not available for phone numbers from Nigeria or South Africa.
1

Start the Signup Process

Navigate to Settings > WhatsApp and select Connect your WhatsApp 

2

Continue with Signup

Follow the on-screen instructions to begin the registration process.

3

Connect to LeadConnector

Click Continue to proceed with the integration.

4

Select WhatsApp Business App

Click Connect a WhatsApp Business App, then tap Next.

5

Enter Your Phone Number

Add your WhatsApp Business phone number and tap Next.

6

Verify Your Account Details

Review your WhatsApp Business Account details and make any corrections before proceeding.

7

Import Contacts & Chat History

Import contacts and up to six months of chat history from the WhatsApp Business App into LeadConnector.

  • Update your WhatsApp Business App to the latest version before this step.
  • Look for a message from the official Facebook Business account and scan the QR code when prompted.
 
8

Connect to the Business Platform

Scan the QR code to complete the connection. You can continue using your WhatsApp Business App alongside the Business Platform.

9

Share Chat History & Contacts

Your contacts and conversations will be securely synced with LeadConnector.

10

Setup Complete

Your WhatsApp Business App is now successfully integrated with LeadConnector.

11

Review and Confirm

Check all entered details carefully, then click Confirm.

✓

Integration Complete

Click Finish. Your WhatsApp Business App is fully integrated with LeadConnector.

NOTE
1. Sending template messages is not supported via the WhatsApp Business App — they can only be sent through the CRM.
2. You will manage your WhatsApp profile from the WhatsApp Business App, not the CRM.
3. You can only have a maximum of one phone number under Coexistence.
Method 2 Connect a New WhatsApp Business Number
1

Start the Signup Process

Navigate to Settings > Communication > WhatsApp  and click Create a new WhatsApp business account.

2

Continue with Facebook

Click Continue with Facebook and log in using the Facebook account associated with your business.

3

Begin Setup

Tap Continue to initiate the integration process.

4

Enter Phone number

Enter a new business phone number, or select an existing phone number from the dropdown, to associate with their WhatsApp Business Account.

5

Phone Number 

The phone number  offers two ways to supply a number: Enter a new phone number, and choose the method of verification. 


6

Verify via OTP

Enter the one-time password received by SMS or voice call, then click Next.

7

Complete your business Profile 

Add the name and country of the business profile. Add the website if you have a business website 


8  Review Business asset Selection Screen 
          Select existing business assets, such as a Meta business portfolio and WhatsApp Business            Account, to use with the new phone number.You  can also create new assets if you have not reached  portfolio limit.




9  Integration Complete

Your WhatsApp Business Account is now successfully integrated and ready to use.


Migrating a WhatsApp Number From Another Partner

How to find out which partner your WhatsApp number is connected to, and how to move it to the CRM while keeping your number, display name, and approved templates.



Step 1: Check Which Partner Is Connected

A WhatsApp number can be active with only one partner at a time, so start by confirming who currently has access to yours. There are two ways to check.

Method 1: WhatsApp Business app

Recommended

Use this method if the number is also used in the WhatsApp Business app on your phone.

1

On the phone that uses the number, open WhatsApp Business.

2

Go to Settings → Account → Business Platform. Depending on your app version, this may be labeled Connected platform.

3

If a partner is connected, its name and account details appear on this screen. If you only see an option to connect, no partner is currently connected through the app.

Method 2: Meta Business Settings

Use this method if the number is not used in the WhatsApp Business app, or to double-check Method 1. You need access to the business portfolio that owns the WhatsApp account.

1

Open Meta Business Settings.

2

Select the correct business portfolio.

3

Go to Accounts → WhatsApp accounts.

4

Select the WhatsApp Business Account (WABA) that holds your number.

5

Open the Partners tab, if it is available.

6

Review which businesses have access to the account.

Tip: A partner that no longer appears in the Partners tab may still have a payment method or credit line attached to the account. If setup later fails, ask your previous partner to confirm it has been removed.

Before You Begin

✓You have administrator access to the Meta business portfolio that owns the WhatsApp Business Account.
✓You can receive an SMS or voice call on the number. Meta sends a 6-digit verification code to confirm you own it.
✓Two-step verification is turned off on the number. Meta will not complete the move while it is on.
✓The display name is approved with no pending change request.
✓Your Meta business portfolio is verified, and the WhatsApp Business Account is in good standing.
✓You have noted which templates you rely on. Only approved, high-quality templates are copied across.
Plan for a short interruption. A number is active with one partner at a time. Once the migration completes, your previous partner loses access to the number. Pick a quiet time and tell your team before you start.

Step 2: Choose Your Migration Path

The right steps depend on how your number is connected today.

Path A: Connected through a partner only

The number runs on the WhatsApp Business API with your current partner, and Method 1 showed no connected platform (or the number is not in the WhatsApp Business app). Follow Path A.

Path B: Also used in the WhatsApp Business app (Coexistence)

Method 1 showed a connected platform. You keep using the app while a partner handles messages through the API. Follow Path B.


Path A: Number Connected Through a Partner Only

1

Turn Off Two-Step Verification

If you own the WhatsApp Business Account, open WhatsApp Manager, select the account, and go to Account tools → Phone numbers. Select your number and choose Turn off two-step verification.

If your current partner owns the account or set the PIN, ask them to turn it off for you.

2

Start the Connection in the CRM

In the sub-account, go to Settings → WhatsApp and begin connecting your number. Sign in to Meta when prompted and choose the business portfolio and WhatsApp account that hold your number.

↗ WhatsApp Setup Guide — full connection steps
3

Verify the Number

Meta sends a 6-digit code by SMS or voice call to the number. Enter it to confirm that you own the number.

4

Set a New PIN if Prompted

The previous PIN does not carry over. If you are asked to create a new 6-digit PIN, store it somewhere safe.

5

Confirm the Connection and Check Your Templates

When the number shows as connected, go to Settings → WhatsApp → Templates and confirm your approved templates arrived. Send a test message to an internal contact.


Path B: Number Also Used in the WhatsApp Business App

When a number is connected through Coexistence, you cannot switch partners in a single step. Disconnect the current partner first, then connect the new one.

1

Disconnect the Current Partner

In the WhatsApp Business app, go to Settings → Account → Business Platform, select the connected partner, and follow the prompts to disconnect.

Disconnecting a business platform is not the same as deleting your WhatsApp account. Do not delete your WhatsApp Business app account.
2

Confirm the Disconnection

Wait a few minutes, then repeat Method 1 and Method 2 from Step 1 to confirm that the previous partner no longer appears.

3

Connect Through the CRM

In the sub-account, go to Settings → WhatsApp and connect the number using the Coexistence option for an existing WhatsApp Business app number.

↗ WhatsApp Coexistence Method — full setup guide

What Moves With Your Number

Carries over

✓ The phone number itself
✓ Display name
✓ Quality rating and messaging limit
✓ Official Business Account status, if you have it
✓ Templates that are approved and high quality

Does not carry over

✘ Message history and media
✘ Your contact list
✘ Your two-step verification PIN
✘ Settings, automations, and integrations in the previous partner's system
✘ Templates that are pending, rejected, or low quality
Before you migrate: Export any contacts and conversation history you need from your previous partner. Recreate templates that did not carry over and submit them for Meta approval. A template's quality rating may show as unknown at first after the move.

Troubleshooting

Issue
What to do
"Business is already sharing this WhatsApp Business Account with a partner"
The previous partner is still connected. Disconnect it in the WhatsApp Business app (Path B, step 1) or remove it in Meta Business Settings, then try again.
Migration will not start or complete
Two-step verification is probably still on. Turn it off in WhatsApp Manager, or ask the previous partner to turn it off, and retry.
The verification code does not arrive
Confirm the SIM or line can receive SMS and calls, then request the code by voice call instead of SMS.
Setup is blocked by a display name issue
The display name must be approved with no pending change. Resolve any pending request in WhatsApp Manager first.
Some templates are missing
Only approved, high-quality templates are copied. Recreate the others and submit them for approval.
Connected, but messages do not arrive in the CRM
If another integration is still connected, check Conversation Routing in Meta Business Suite and confirm the CRM is the primary responder.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article