Coexistence
Learn how to use the WhatsApp Business app and the WhatsApp Business Platform on the same phone number
WhatsApp Coexistence allows businesses to onboard their existing WhatsApp Business app account and phone number to the WhatsApp Business Platform.
This means that businesses can message at scale with the WhatsApp Business Platform, and can message individual users with the WhatsApp Business app.
Why Use WhatsApp Coexistence?
By using WhatsApp Coexistence, businesses can enjoy the full capabilities of the WhatsApp Business Platform - such as API messaging, Meta Insights, Click-to-WhatsApp (CTWA) campaigns, and more - without losing their existing number, messaging history, or audience.
This is ideal for businesses looking to scale their messaging strategies while maintaining their current setup.
Key Benefits
Maintain access to the WhatsApp Business app while using the WhatsApp Business Platform.
Message at scale via the API while retaining one-to-one messaging in the app.
Simplifies migration for businesses already using WhatsApp Business App.
How it works
WhatsApp Coexistence requires an active WhatsApp Business App. The app must be opened at least once every 13 days to keep the account active. If this requirement cannot be met, it's recommended to use standard Cloud API instead.
Communication
Handling conversations between the WhatsApp Business app and the WhatsApp Business Platform is possible thanks to message echoes:
Messages sent via the API appear in the WhatsApp Business app automatically - no action required.
Messages sent via the WhatsApp Business app are sent to the phone number's webhook URL, via an
smb_message_echoesevent. This makes it possible to keep WhatsApp Business Platform solution in sync with the WhatsApp Business app.
Pricing
All messages sent through the WhatsApp Business app remain free.
Messages sent through the WhatsApp Cloud API are subject to WhatsApp Cloud API pricing. WhatsApp Business Platform's per-message pricing structure is explained here. Template messages are still required to initiate conversations from the WhatsApp Business Platform. Service messages can only be sent within 24 hours of the customer's last incoming message (e.g., within a 24-hour customer service window).
Linked devices
Businesses can link up to four "companion" devices to their WhatsApp Business app (described as "linked devices" in Meta Help Center).
However, after onboarding to the WhatsApp Business Platform, all companion apps will be unlinked; you can re-link only supported devices after onboarding.
WhatsApp for Windows and WhatsApp for WearOS are not supported.
Messages from unsupported companion devices will not trigger webhook events, so the business won't be able to mirror the message through the API. You can still use the App to respond to this message.
Messages viewed on an unsupported companion device will show a placeholder text instructing users to check their primary device.
While WhatsApp users can still message an onboarded business from an unsupported companion client, these messages will not trigger smb_message_echoes webhook events, meaning the business will be unable to mirror them in their app.
Limitations
WhatsApp Coexistence comes with some functional limitations:
OBA not supported: Official Business Account (OBA / Blue badge) is not supported for coexistence accounts. It's possible to apply for Meta Verified for Business instead.
Display name is not automatically reviewed. To initiate the display name review of COEX numbers, the business must first apply for Meta Verified.
The calling API is not supported
Chat History
It's possible to sync message history from the WhatsApp Business app to the WhatsApp Business Platform.
FAQ
Getting Started: Account Creation
Onboard WhatsApp Business account and phone number to the WhatsApp Business Platform following the guide below:
Coexistence OnboardingLast updated
Was this helpful?