Skip to main content
WhatsApp Coexistence enables businesses to connect their active WhatsApp Business App phone number to the WhatsApp Cloud API — without losing chats, contacts, or requiring re-registration of the number.

​
What is Coexistence?

Connect to Cloud API

Connect the WhatsApp Business App to the Cloud API seamlessly

Keep Using Business App

Continue using the Business App normally after connection

Sync Everything

Real-time message and contact synchronization

No Data Loss

Preserve chat history and contacts without any data loss
This is the safest method to migrate to Cloud API without losing data. You can use the same phone number across both the WhatsApp Business App and API.

​
Prerequisites

Before starting the onboarding process, ensure you meet all these requirements:
You must have an existing WhatsApp Business account/number. Personal WhatsApp numbers are not supported.
WhatsApp Business App Version 2.24.17 or newer is required. Older versions will fail during QR-linking.
Your number must have:
  • Regular WhatsApp activity
  • No Meta restrictions
  • No policy violations
  • Active genuine usage for 3-7 days minimum
A Facebook Business Page with Admin Access is required.
Numbers from Nigeria or South Africa are not currently supported due to Meta regulations.
Your number must not be:
  • Linked to another WhatsApp API provider
  • Blocked by Meta

​
Setup Guide

1

Enter Email and Login

Enter your email address and log in with your account.Login Screen
2

Enter OTP

Enter the OTP sent to your Gmail inbox.OTP Verification
3

Add Number

Click Add Number to proceed with the embedded sign-up flow.Add Number
4

Facebook Login

Enter your Facebook login credentials, or click Continue as if your session is saved.Facebook Login
5

Grant Permissions

Click Continue on the permissions page to authorize the connection.Permissions
6

Fill Business Details

Complete the business details form with accurate information.Business Details
7

Create Business Portfolio

Create or choose your business portfolio.Business Portfolio
Always create a NEW WABA account for coexistence to ensure fresh usage and healthy flow.
8

Choose Onboarding Method

Select your onboarding method:
  1. Connect existing WhatsApp business number
  2. Start with new WhatsApp contact number Onboarding Method
Constraints: Number must not be linked to any other partner, must be a new or existing WhatsApp Business number, and not blocked by Meta.
9

Enter Phone Number

Select your country code and enter your phone number.Phone Number Entry
10

Scan QR Code

Scan the QR Code using your WhatsApp Business App.QR Code Scan
11

Import Chat History

Choose whether to import chat history:
  • All contacts are imported automatically
  • Optional: Up to 6 months of 1:1 chats
  • Optional: Up to 2 weeks of media
  • Group chats are not imported Chat History Import
12

Verify Account

Wait for account verification. The connection process takes some time.Verification
13

Complete Setup

Click Finish to complete the setup process.Setup Complete

​
Troubleshooting

​
Integration Failed

Common reasons for integration failure:
  • Old WhatsApp version
  • Number inactivity
  • Meta restrictions
  • No Facebook Page admin access
Solution: Use another number that has active WhatsApp Business usage and no past violations.

​
Chat History Did Not Import

1

Open WhatsApp Business App

Navigate to Settings > Business Tools > WhatsApp Business Platform
2

Disconnect

Tap Disconnect to remove the current connection
3

Restart Onboarding

Restart the Coex onboarding process from the beginning
If you manually skipped history import initially, you must fully offboard and onboard again to import chat history.

​
Number Has Meta Restrictions

Symptoms:
  • Instant failure
  • QR code doesn’t complete scanning
  • No “Connect to Business Platform” message appears
Solution: Use a number with zero policy issues and frequent legitimate WhatsApp Business activity.

​
FAQs

No. Only WhatsApp Business App numbers are allowed for Coexistence.
Yes. Nothing is deleted from the WhatsApp Business App. All your chats remain intact.
Yes. You can continue using the WhatsApp Business App normally after setting up Coexistence.

​
Need Help?

If you have any questions or need further assistance, feel free to reach out to us at [email protected]. We’re happy to help!