Quick answer: what is WhatsApp Coexistence?
WhatsApp Coexistence (often called Coex) is a Meta feature that lets a single WhatsApp Business phone number be active on the WhatsApp Business app and the WhatsApp Cloud API simultaneously. New messages sent and received on either side from the moment Coexistence is enabled are mirrored to the other through real-time webhooks.
Rolled out by Meta in May 2025. Onboard with Whautomate, an official Meta Tech Partner, and you keep your number, keep your existing app chats safely in the WhatsApp Business app, and add broadcasts, automations, and a multi-agent inbox on top. Full step-by-step product walkthrough is in our WhatsApp Cloud API help doc.
Why Meta launched Coexistence
Meta's WhatsApp Business app has more than 200 million monthly users globally - mostly very small businesses, solopreneurs, freelancers, and local shops. Pushing all of them through a hard cutover to the Cloud API was never going to work. The legacy migration path was lossy, intimidating, and risky.
Coexistence was designed to:
- Lower the barrier for SMBs to start using automation, broadcasts, and chatbots.
- Let the personal touch of mobile-app conversations continue alongside scaled API messaging.
- Reduce abandonment in the Embedded Signup funnel.
It has quickly become the default onboarding path for any business already running on the WhatsApp Business app.
How WhatsApp Coexistence works
Behind the scenes, Coexistence runs on Meta's standard Cloud API infrastructure with extra webhook subscriptions and a permanent two-way sync layer.
The architecture
When you enable Coexistence inside Whautomate, additional WhatsApp webhook fields are subscribed beyond the standard message webhooks:
- smb_app_state_sync - contacts on the WhatsApp Business app and any new contacts added.
- smb_message_echoes - new messages sent through the WhatsApp Business app after onboarding, mirrored into the Whautomate inbox.
These streams keep Whautomate and the WhatsApp Business app in sync automatically. Note that Whautomate does not subscribe to the historical chat import - your existing app chats stay in the app and the Whautomate inbox starts fresh from the moment Coexistence is enabled.
The user experience
For your customers, nothing changes. They send a WhatsApp message to your number the same way they always have. They have no idea whether a human on the mobile app or an automated system on the API is responding.
For your team, the experience is dual:
- On the WhatsApp Business app - keep replying to customers, using labels, catalogs, voice and video calls, and groups exactly as before. Every message you send appears as an "echo" inside Whautomate within seconds.
- On Whautomate - send broadcasts, run chatbots, trigger automations, handle multi-agent routing, integrate with your CRM, and pull analytics. Every message your team sends from Whautomate also appears in the WhatsApp Business app chat.
The chat thread on both sides shows the full conversation. Whoever picks up next has full context.
What gets synced and what does not
Read this carefully before enabling Coexistence.
| Feature or data type | Synced between app and API? |
|---|---|
| One-to-one customer chats (new, after Coexistence is enabled) | Yes, in real time |
| Historical 1:1 chats from before Coexistence was enabled | No - stay in the WhatsApp Business app only. Whautomate does not import history. |
| Contacts saved in the WhatsApp Business app | Yes |
| Media (images, videos, documents) in 1:1 chats | Yes |
| Group chats | No, app only |
| Status updates | No, app only |
| Voice and video calls | No, app only |
| Catalogs and shop | No, app only |
| Disappearing messages | Disabled while Coexistence is active |
| View-once photos and videos | Disabled while Coexistence is active |
| Live location sharing | Disabled while Coexistence is active |
| Message edit and revoke | Restricted while Coexistence is active |
| Broadcast lists on the app | Become read-only |
| WhatsApp Pay | Not supported under Coexistence |
| Display name in chat header | May show only the phone number unless Meta Verified |
| Companion devices (WhatsApp Web, Mac) | Supported, but unlinked at onboarding and need re-linking |
| WhatsApp for Windows and WearOS | Not supported |
App messages remain completely free. API messages follow Cloud API conversation-based pricing.
Benefits of WhatsApp Coexistence
1. Keep your existing number
The biggest benefit. Your customers' saved number stays the same. Existing one-to-one chats remain safely in the WhatsApp Business app, and from the moment Coexistence is enabled every new message syncs to Whautomate so your team picks up full context going forward.
2. Zero downtime during the transition
The mobile app keeps working through onboarding. There is no cutover window where messages get lost. Roll out automations and team workflows on the API side without disrupting the app side.
3. The best of both worlds
Use the app for personal conversations, voice and video calls, groups, status. Use Whautomate for what the app cannot do: broadcasts to thousands, AI chatbots, drip campaigns, multi-agent inbox, CRM sync, and integrations.
4. Test the API risk-free
If you are not sure whether the API is right for your business, Coexistence lets you trial it on your real number with real customers without burning bridges.
5. Higher messaging limits without verification
Businesses on Coexistence are not required to complete Meta business verification to break past the 250 business-initiated conversations per 24-hour limit. Open 1,000 high-quality template conversations in a 30-day rolling window and Meta evaluates you for an automatic upgrade.
6. No new number, no customer confusion
Many businesses tried to work around the old limitation by buying a second number for the API. That always created confusion. Coexistence kills that workaround.
7. Smooth path to multi-agent support
Sales and support teams that have outgrown the four-device limit on the WhatsApp Business app can move conversation handling to the API inbox while the original phone owner still uses the app for personal touchpoints.
Who should use WhatsApp Coexistence
Coexistence is a strong fit for:
- SMBs already on the WhatsApp Business app who want broadcasts, automations, or a team inbox without losing history.
- Sales teams that handle high-value consultative sales on WhatsApp and need a CRM-linked inbox without giving up the personal mobile workflow.
- Service businesses - clinics, salons, fitness studios, tutors - that handle most communication on the app today and want to add appointment reminders, drip campaigns, and chatbot intake.
- Growing e-commerce sellers who want to add abandoned cart recovery and order updates through the API while still chatting one-on-one with VIP customers from the phone.
Coexistence is less of a fit for:
- Large enterprises that need throughput above 20 messages per second.
- Businesses that rely heavily on disappearing messages, view-once media, or live location.
- Brands that need WhatsApp Pay.
- Businesses with no existing WhatsApp Business app history to preserve - go straight to Embedded Signup.
Requirements before you enable Coexistence
Skipping any of these is the most common cause of failed onboarding.
- WhatsApp Business app version 2.24.17 or newer on the phone holding the number.
- The number has been actively used on the WhatsApp Business app for at least 7 days. 1 to 2 months of consistent use is recommended to reduce flagging risk.
- Supported country code. Coexistence is now broadly supported, including Singapore, India, the UAE, Saudi Arabia, Indonesia, Malaysia, the Philippines, Brazil, Mexico, the United States, Hong Kong, Nigeria, South Africa, and most of Europe. Coverage continues to expand - if your number is on the WhatsApp Business app and onboarding fails on country grounds, retry after a few weeks.
- The number is not currently active inside any other WhatsApp Cloud API setup. If it was previously on the API with another BSP, that WABA must be deleted first and the number must rebuild credibility on the app for 1 to 2 months.
- A Meta Business Portfolio that the number can be associated with, or the ability to create one during onboarding.
- Admin access to the Facebook account that owns the Business Portfolio.
- A Meta Tech Partner like Whautomate that supports Coexistence onboarding.
How to enable WhatsApp Coexistence with Whautomate
Full product walkthrough lives in the WhatsApp Cloud API help doc. Short version below.
Step 1: Sign up for Whautomate
Create a free account at whautomate.com.
Step 2: Open the WhatsApp integration
In the Whautomate dashboard, go to Integrations → WhatsApp and click Configure WhatsApp via Embedded Signup.
Step 3: Login with Facebook
Click Login with Facebook and sign in with the Facebook account that admins your Meta Business Portfolio. Meta hosts this window - your Facebook credentials never touch Whautomate.
Step 4: Select or create your Business Portfolio and WABA
Pick or create the portfolio. Confirm the WhatsApp Business Account, business display name, and timezone.
Step 5: Choose Connect a WhatsApp Business App
On the first WhatsApp Business Account page of the Embedded Signup popup, select Connect a WhatsApp Business App. This is the Coexistence path - it tells Meta you want to onboard the existing number from your WhatsApp Business app rather than creating a brand-new Cloud API number.
Step 6: Confirm your existing phone number
The flow detects that your number is currently active on the WhatsApp Business app. Confirm it.
Step 7: Verify on your phone
Open the conversation with the official Facebook Business Account in your WhatsApp Business app. Tap Connect to the Business Platform and enter the verification code shown on your computer. Tap Confirm.
Step 8: Start using both platforms
Once Coexistence is connected, the Whautomate inbox starts mirroring all new one-to-one conversations from your number in real time. Older app chats from before this point remain in the WhatsApp Business app on your phone. You can:
- Reply from either side; messages mirror both ways.
- Submit and send template broadcasts.
- Build chatbot flows and automations.
- Integrate with Shopify, WooCommerce, Stripe, Razorpay, Calendly, Zapier, and more.
- Continue making and receiving WhatsApp voice and video calls from your phone.
How pricing works in Coexistence mode
The rule is simpler than it looks.
App messages are always free. Anything you send from the WhatsApp Business app on your phone costs nothing. No conversation window opens. No billing event triggers.
API messages follow Cloud API conversation-based pricing. Anything Whautomate sends through the Cloud API follows Meta's standard pricing across four conversation categories: marketing, utility, authentication, and service. Service conversations triggered by a customer message are currently free.
The two billing systems run in parallel on the same number. They never overlap.
Limitations and gotchas to know about
Coexistence is genuinely useful, but it is not a perfect clone of full Cloud API.
Throughput is fixed at 20 messages per second
Pure Cloud API numbers can scale to hundreds of messages per second. Coexistence numbers are capped at 20 mps. For most SMBs this is more than enough.
Display name may not show by default
Some customers may see only your phone number in the chat header. Fix it with a Meta Verified subscription, which restores the display name and adds the verified blue tick.
Group chats are app-only
Groups still work in the WhatsApp Business app, but messages sent in groups will not appear inside Whautomate.
Some app features are disabled
Disappearing messages, view-once media, and live location sharing all turn off while Coexistence is active.
Companion devices need re-linking
WhatsApp Web and WhatsApp for Mac are unlinked at onboarding. Re-link them afterward. WhatsApp for Windows and WearOS are not supported in Coexistence at all.
14-day inactivity rule
If the WhatsApp Business app is not opened on the registered phone for more than 14 days, Coexistence may disconnect.
Blue tick does not transfer
If you already had the Meta Verified blue badge in the WhatsApp Business app, it does not transfer. Apply again on the API side.
Marketing Message Lite is incompatible
Coexistence is currently not compatible with the WhatsApp Marketing Message Lite API.
Existing API numbers cannot move backwards
Coexistence flows in one direction only - from the WhatsApp Business app to the Cloud API.
Common issues and how to fix them
"This phone number is not eligible for Coexistence"
Most common cause: the number was on a different WhatsApp Business API account in the past. Delete that old WABA from the previous BSP, then reactivate the number on the WhatsApp Business app for 1 to 2 months before retrying.
Verification code not received in the WhatsApp Business app
Make sure you opened the conversation with the official Facebook Business Account (the one with the blue check). Check your Updates tab. If still missing, restart the connection flow from Whautomate.
Old WhatsApp Business app chats are not showing in Whautomate
This is expected. Whautomate does not import historical chats - existing one-to-one threads remain in the WhatsApp Business app on the phone. Only new messages from the moment Coexistence is enabled appear in the Whautomate inbox. Open the older chats on the phone if you need to review them.
Some team-member messages do not appear in Whautomate
Check whether they are using a supported companion client. Messages from WhatsApp for Windows or WearOS will not sync. Switch them to WhatsApp Web or WhatsApp for Mac.
Display name shows as a phone number
Apply for Meta Verified through Meta Business Suite.
"Country not supported" error
Some country codes are excluded from Coexistence at the Meta level. Either use a Cloud API number from a supported region, or wait for Meta to expand coverage.
For anything else, the WhatsApp Cloud API help doc covers the full troubleshooting tree.
Coexistence vs full Cloud API: which should you choose?
| Decision factor | Coexistence | Full Cloud API |
|---|---|---|
| Already on WhatsApp Business app, want to keep the number | Strongly preferred | Requires migration off the app |
| Brand new business, no number yet | Not applicable | Best choice - see Embedded Signup |
| Need throughput above 20 mps | Limited | Better |
| Need WhatsApp Pay | Not supported | Supported in eligible markets |
| Want to keep using the app for personal chats | Yes | No |
| Want maximum messaging volume and templates | Limited | Better |
| Want to test the API risk-free | Best path | Higher commitment |
| Multi-agent team inbox needed | Supported via API side | Supported |
For most SMBs already on the WhatsApp Business app, Coexistence wins. For high-volume marketing brands and large enterprises, full Cloud API on a dedicated number is still the right answer.
How to disconnect Coexistence
If you ever want to stop using the API on a Coexistence number, the disconnect must happen on the WhatsApp Business app itself.
- Open the WhatsApp Business app on the phone.
- Go to Settings → Account → Business Platform.
- Tap Disconnect.
The WhatsApp Business app remains fully functional. Do not uninstall the app - uninstalling can sever the connection in a way that creates problems if you ever want to re-onboard.
Trusted by businesses Globally
Get started with WhatsApp Coexistence today
Keep your number, keep your history, keep your mobile workflow. Live on Coexistence in under a day.
Start Free Trial Read the Embedded Signup guide