Coexistence Onboarding
Learn how to connect a WhatsApp Business app account and phone number to the WhatsApp Business Platform (also known as WhatsApp Coexistence)
This guide shows how to add a WhatsApp Business app account and phone number to the WhatsApp Business Platform with 360Dialog.
Using the same phone number for both the WhatsApp Business app, and the WhatsApp Business Platform, is known as Coexistence.
Requirements
Before onboarding a number to the WhatsApp Business Platform using Coexistence, make sure:
You can create a new Meta business portfolio, or connect to an existing one during the Embedded Signup process.
Please choose your business portfolio carefully, since it can't be changed after the number is registered. It is mandatory that the business portfolio is owned by the business who is sending messages. Adding users who do not belong to this company can cause your business portfolio to be blocked.
You must add your information in the Business Info section of Business Portfolio Settings. You need to include a legal name, an address, a website, and the business phone number you intend to use for messaging.
Step-by-Step Procedure
Connect the Number
Access the business’s Meta Business portfolio.
Go to Settings > WhatsApp Accounts.
Click Add > Link a WhatsApp Business account.
Enter the phone number that is already connected to the WhatsApp Business app.
Validate the OTP received.
Start Embedded Signup
If you don't have a 360Dialog Hub account, follow the link provided by your Integration Partner, or use our sign up page. If you already have a 360Dialog Hub account, you can get started by signing into your account on the 360Dialog Hub.
In the Numbers section of the 360Dialog Hub, click the Add number button:
The “Add Number” button is disabled for Partner-Paid accounts. If the button is grayed out, you may have a Partner-Paid account. This guide should be followed by owners of Direct-Paid accounts.
If your account is a Partner-Paid account, refer to your partner's documentation on adding a new phone number, or contact your partner for assistance.
In the form that opens, select:
No, this number is not connected to the WhatsApp Business API.
Yes, this number is connected to the WhatsApp Business App.
Click the "Confirm the number details" button.
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:
Onboarding and synchronization can take several minutes, depending on a number of factors such as the size of the business's messaging history, internet speed, etc. If you encounter any issues, please reach out to our Support Team.
Post-Onboarding Notes
You may now:
Set the phone number's webhook.
Start processing Coexistence-exclusive webhooks. See Coexistence Events for implementation details.
Last updated
Was this helpful?