> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# How to Connect Your WhatsApp Business App to ChatSyncs
> Use the same WhatsApp number on the WhatsApp Business App and ChatSyncs at the same time — how Meta's Coexistence feature works, and what changes on the Business App.
**Coexistence** is a Meta feature that lets one WhatsApp number work in two places at once — the WhatsApp Business App on your phone, and ChatSyncs.
* If you're already using the **WhatsApp Business App**, you don't need to delete your account to start using ChatSyncs.
* No migration, no downtime, no risk of losing your number or conversations.
* Only works with the **WhatsApp Business App** — regular (personal) WhatsApp doesn't support it. If you're on personal WhatsApp, see [How to Migrate from WhatsApp App to a ChatSyncs Business Account](/learn/chatsyncs-setup-and-configuration/migrate-from-whatsapp-app-to-a-chatsyncs-business-account) instead.
## What Coexistence changes
Once linked, both sides stay in sync:
* Messages are **mirrored** — a customer's message shows up in both the Business App on your phone and ChatSyncs' inbox, and a reply from either side shows up on the other.
* Your last **6 months of chat history** copies over automatically the first time you link, so ChatSyncs doesn't start empty.
**On your phone (Business App)** — send quick personal replies, make voice and video calls, check messages on the go, manage your business profile.
**On ChatSyncs (API)** — build automated chatbots, send bulk broadcasts, use a multi-agent team inbox, send message templates, integrate with CRMs, and track analytics.
A few Business App features are turned off to avoid conflicts once Coexistence is active:
* **Broadcast lists** are disabled in the Business App — send broadcasts from ChatSyncs instead.
* **Disappearing messages and view-once media** are turned off for all chats.
* **Message throughput** drops from 80 to 20 messages per second while both platforms are active — rarely noticeable unless you're sending very high volumes from both at once.
Everything else on the Business App — calls, status updates, profile management, direct messaging — keeps working as before.
## How to set it up
Go to **Connect Account**, under **Business Accounts** click **Connect WhatsApp**, then pick the green **Embedded Onboarding (One Click)** card and click **Connect with Embed Onboarding** — same starting point as [How to Connect Your Number to ChatSyncs](/learn/chatsyncs-setup-and-configuration/connect-your-number-to-chatsyncs).
If you've already set up a product catalog and want to share its permissions, click **Connect With Catalog** — otherwise click **Connect Without Catalog**. Either opens Meta's popup.
Meta's popup opens. Log in if you aren't already, then click **Continue**.
Pick an existing portfolio from the dropdown, or click **Create a Business Portfolio** if you don't have one — it only asks for a portfolio name, your first/last name, and a website.
In the **WhatsApp Business account** dropdown, pick **Connect a WhatsApp Business App** — not **Create a WhatsApp Business account**, which is the separate Cloud API path.
Enter the phone number **already connected to your WhatsApp Business App** — not a new one.
Read the **Connect your existing WhatsApp Business App** notice — your account information (phone number, contacts, chats, chat history) may be shared, and individual chats start being managed through a secure Meta service. Click **Next**.
**"Unlink your number first" error?** This means the number is already linked to a *different* platform/partner. Fix it in two places:
1. At [business.facebook.com](https://business.facebook.com), select your business portfolio → **WhatsApp account** → select the account → **Partners** tab → find the connected partner → **Manage** → remove access.
2. On your phone, open **WhatsApp Business app → Settings → Account → Business Platform** → find the same partner → tap to disconnect.
Once both are disconnected, re-enter your number and continue. See [How to Disconnect Another Partner From Your WhatsApp Number](/learn/chatsyncs-setup-and-configuration/disconnect-another-partner-from-your-whatsapp-number-in-chatsyncs) for the full walkthrough.
The account name is pulled from your phone and **can't be changed** once setup is complete — only the time zone is editable here. Click **Next**.
Review what ChatSyncs will be able to do — manage your business, manage your WhatsApp accounts, manage/access conversations, and log events for that account to Meta — then click **Confirm**.
Open **WhatsApp Business app** on your phone — you'll get a message from Meta titled **Connect to the Business Platform**. Tap **Connect**.
A QR code appears — scan it with the same WhatsApp Business app to complete the link, then click **Finish**.
Coexistence lets you keep using the WhatsApp Business app on your phone exactly as before — ChatSyncs runs alongside it rather than replacing it, unlike a plain Cloud API connection which locks the number out of the regular app.
## Frequently asked
A **Cloud API** connection dedicates a number entirely to ChatSyncs — it can no longer be used in the regular WhatsApp app. **Coexistence** links your *existing* WhatsApp Business App number instead, so you keep using the app on your phone while ChatSyncs automates on the same number.
Yes — that's the whole point of Coexistence. Calls, status updates, profile management, and direct messaging all keep working; only broadcast lists, disappearing messages, and message editing/revoking are turned off in the app.
No — the account name is set from your phone at connection time and can't be edited afterward. Only the time zone stays editable on that screen.
No — your last 6 months of chat history syncs over automatically the first time you link, so ChatSyncs doesn't start empty.
Your number is already linked to a different platform/partner. See [How to Disconnect Another Partner From Your WhatsApp Number](/learn/chatsyncs-setup-and-configuration/disconnect-another-partner-from-your-whatsapp-number-in-chatsyncs) for the full steps, then re-enter your number.
* **Coexistence only works with the WhatsApp Business App** — a personal WhatsApp number must be deleted and reconnected fresh instead; see [How to Migrate from WhatsApp App to a ChatSyncs Business Account](/learn/chatsyncs-setup-and-configuration/migrate-from-whatsapp-app-to-a-chatsyncs-business-account).
* **Broadcast lists stop working in the Business App** once Coexistence is active — send broadcasts from ChatSyncs instead.
* **The account name locks in at connection time** — get it right before scanning the QR code, since it can't be changed afterward.
