How to Onboard a WhatsApp Business Phone Number on Coex
Coexistence allows you to use the same phone number simultaneously on the WhatsApp Business App and WhatsApp Business Platform (Cloud API). This is useful for businesses that want to continue manual conversations on the app while gradually adopting automation, templates, and integrations via DoubleTick.
This section explains how to onboard a phone number in coexistence mode on DoubleTick using Meta’s Cloud API.
Before You Begin — Prerequisites for Coexistence
Before starting coexistence onboarding, ensure the following conditions are met:
1. Verified Business Portfolio (Meta Business Suite)
Just like standard Cloud API onboarding, business verification is mandatory.
Your Meta Business Portfolio must be verified
Legal business documents must be approved by Meta
If not verified, complete verification first: https://learn.doubletick.io/get-started-with-doubletick/how-to-do-meta-facebook-business-verification
2. Phone Number Must Be Active on WhatsApp Business App
For coexistence onboarding:
✔ The number must already be active on the WhatsApp Business App
⚠️ Do not delete or deregister the number from the WhatsApp Business App before onboarding. Coexistence works only when the app remains active.
Step-by-Step Onboarding Process
These steps describe how to onboard a number onto DoubleTick via Coexistence from start to finish.

Step 1 — Access the DoubleTick Web Platform
Open Google Chrome (recommended for best compatibility) and visit:
A login screen will appear requesting your login number. If you don’t know your login number, your Account Manager can provide it.
After entering the login number, click the Login button (green).
Step 2 — OTP Validation
DoubleTick sends an OTP to your login number via SMS.
Enter the OTP and click Login again to authenticate.
Important: Enable pop-ups in your browser before initiating the onboarding process, as Meta’s integration flows open in pop-up windows. Blocking pop-ups can interrupt the onboarding midway.
Step 3 — Initiate Onboarding

Scroll down and click the green Get Started button.
This button triggers the onboarding initiation
Step 4 - Select your Facebook Business Manager Portfolio

Select “Connect your existing WhatsApp Business App”

Enter the phone number used on WhatsApp Business App.

A 5-digit OTP will be sent on your WhatsApp Business App.

Enter OTP for verification.

Choose your Time Zone.

Review and approve DoubleTick's Access Request.

Scan the QR Code from your WhatsApp Business App




Setup complete — you can now use the number on both App and API. You're now live on Co-Existence with DoubleTick!

🆕 For New Numbers
Install WhatsApp Business App
Use the number for at least 7 days with real conversations
Then follow the onboarding steps above
🔁 For Numbers Currently on WhatsApp Business API
Delete the Number from Facebook Business Manager
Log in to your Facebook Business Manager account.
Go to Business Settings → WhatsApp Accounts.
Select the relevant WhatsApp Account.
Click on Settings, then click the Trash icon to delete the API number.

Install WhatsApp Business App and Log In using the downgraded number.
Before downgrading number, it’s important to back up your chats to avoid losing any messages. Follow these steps:
Open WhatsApp Business App → Go to Settings → Chats → Chat Backup
Connect your Google Account (if not already connected)
Set Back up frequency to Daily
Tap Back Up Now and wait until the upload is confirmed
✅ Once the backup is complete, you can safely proceed.
Install WhatsApp Business App and Log In
Install the WhatsApp Business App on your phone.
Log in using the downgraded number (the one you just deleted from the API).
Restore your chat backup when prompted.
Reconnect the Number to DoubleTick
Once your WhatsApp Business App setup is complete and active:
Log in to DoubleTick.
Go to Settings → Manage WABAs → Add Number (green button).

Select “Add number using Embedded Sign Up.”

Choose your Facebook Portfolio.
Select “Connect your existing WhatsApp Business App.”
Enter your number → Verify OTP → Select Timezone → Approve Access.
A QR code will appear → Scan the QR using your WhatsApp Business App.
Last updated