Coexistence Onboarding
This section provides details on how to onboard businesses that are already using the WhatsApp Business App and want to expand to the WhatsApp Cloud API.
Requirements
Before onboarding a number to WhatsApp Coexistence Mode, make sure:
Before selecting the chat sync option during onboarding, direct clients (businesses without an integration partner) should contact Support.
Step-by-Step Procedure
Connect the Number via Facebook Business Manager
Access the business’s Facebook Business Manager.
Go to Settings > WhatsApp Accounts.
Click Add > Link a WhatsApp Business account.
Adding your WhatsApp Business Acount to your Business Manager Enter the phone number that is already connected to the WhatsApp Business App.
Enter your phone number Validate the OTP received.
Complete adding your WhatsApp Business Acount to your Business Manager
Start the Embedded Signup (ES) via 360dialog
Use the standard 360dialog Embedded Signup process.
If you’re using an integration partner, reach out to them for the appropriate onboarding link.
In the flow, select:
No, this number is not connected to the WhatsApp Business API.

Yes, this number is connected to the WhatsApp Business App.

Confirm the number details.
Connect the WhatsApp Business App
Proceed with the “Connect your existing WhatsApp Business app” option.
Enter the phone number again and verify.
Open the WhatsApp Business App on your phone.
Follow the in-app instructions:
A new WhatsApp message will prompt you to scan a QR code.

Tap the message and scan the QR displayed on screen.
Once completed:
Post-Onboarding Notes
You may now:
Set the number webhook.
Start processing echo payloads.
Refer to the Echo Payload Documentation for implementation.
Last updated
Was this helpful?