# WhatsApp Coexistence

WhatsApp Coexistence

Onboarding a number already registered with the WhatsApp Business App allows you to enable API functionalities without losing chat history and while maintaining access through the mobile app.&#x20;

This feature enables both interfaces to coexist using the same phone number, allowing businesses to use the benefits of both platforms simultaneously: message at scale and still have the ability to send messages via WhatsApp Business App. You can find a reference to this functionality as "WhatsApp Coexistence", or "Coex" in this documentation.&#x20;

### Why Use WhatsApp Coexistence?

By enabling Coexistence, your clients can enjoy the full capabilities of the WhatsApp API - 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. Messages will be mirrored between the mobile App and the API,  using echoes.&#x20;

💬 **Message echoes:**

* Messages sent via the API will appear in the WhatsApp Business App.
* Messages sent via the App will appear in the Cloud API conversation history.

### Key Benefits

* Maintain access to the WhatsApp Business App while using the WhatsApp Business API.
* 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

### 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 Cloud API's per-message pricing structure is explained here.](https://docs.360dialog.com/docs/prices-plans-and-payments/free-vs-billed-messages) Template messages are still required to initiate conversations from the WhatsApp Cloud API. 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).

{% hint style="info" %}
Clients will also need a 360Dialog account and subscription plan, as Cloud API usage and fees are charged normally.
{% endhint %}

### Linked devices

Businesses can link up to four "companion" devices to their WhatsApp Business App (described as "[linked devices](https://faq.whatsapp.com/378279804439436/?fbclid=IwZXh0bgNhZW0CMTEAAR2wCtUhMIoG1VO6mhMVxnM5qZxdKKDjFtvk4YpCNwhSJkGt11imnDaOig0_aem_JIFUbZ1WN9y9vercActG7Q)" in Meta Help Center).

However, after onboarding to Cloud API, all companion apps will be unlinked. The business can re-link only supported devices after onboarding.

* [WhatsApp for Windows](https://faq.whatsapp.com/1317564962315842/?cms_platform=windows-desktop\&fbclid=IwZXh0bgNhZW0CMTEAAR1gLC6waIwQKEQoEGKbjg1Oq5txm6UhdPaW9MJk7tl5zfmxi91acb2AbGw_aem_vEQZZFO6LlCvkD5nb6NX8g) and [WhatsApp for WearOS](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F564431798835071%2F%3Ffbclid%3DIwZXh0bgNhZW0CMTEAAR3TYfj7mUed27k4ZOjGcgQO-Mapj7z_BYOqlWO6aUWVB1xeMm0xCHR_uqk_aem_xcqnRjqlXr4M_20TUJtC7g\&h=AT2NG1pwbUs22EOCRkHrvG6K_aFSINqj05GrvmYFcsCaqWHlqtC4XoaJFWb84a-ep6ZYIoh94EydtJalaOb1plLo-HV9IWVFNm9vXmQVzaildL8W5uS-s_qTki2HAW6S8EhH56zySyT7X9xSPhufKGA-qFY) are not supported.
* Messages from unsupported companion devices will not trigger webhooks, so the business won't be able to mirror the message through the API. The business 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.&#x20;

While WhatsApp users can still message an onboarded business from an unsupported companion client, these messages will not trigger `smb_message_echoes` webhooks, meaning the business will be unable to mirror them in their app.

### Limitations

WhatsApp Coexistence comes with some functional limitations:

* **Standard Business Verification not supported:** [Standard Business Verification](https://docs.360dialog.com/partner/partner-hub/meta-business-verification/standard-business-verification) is not available for coexistence accounts. [Partner-Led Business Verification (PLBV)](https://docs.360dialog.com/partner/partner-hub/meta-business-verification/partner-led-business-verification) or [Meta Verified for Business](https://docs.360dialog.com/partner/partner-hub/meta-business-verification/meta-verified-for-business) are available instead.
* **OBA not supported: Official Business Account (OBA / Blue badge)** is not supported for coexistence accounts. [Meta Verified for Business](https://docs.360dialog.com/partner/partner-hub/meta-business-verification/meta-verified-for-business) is available instead.&#x20;
* **COEX numbers can´t be migrated between WABAs**

{% hint style="info" %}
Please refer to [Meta's feature comparison](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#feature-comparison) to understand what features are supported on Cloud API and if there are changes in the WhatsApp Business App.
{% endhint %}

### Important Notes

* You can sync message history from the WhatsApp Business App into the Cloud API.
* Do not uninstall the WhatsApp Business App - doing so will disconnect the account.
* You must open the WhatsApp Business App at least once every 13 days to keep the account active.<br>

### FAQ

<details>

<summary>Eligibility for WhatsApp Business API Access</summary>

While the WhatsApp Business API is now accessible for App numbers, it is intended for businesses that are **already actively using the WhatsApp Business App and looking to scale their messaging capabilities**. Businesses with newly created Business App accounts are not immediately eligible for API access.

Eligibility is determined based on factors such as account tenure and messaging quality to ensure a reliable and effective messaging experience. **Meta recommends businesses to use Coexistence only if they are already using the WhatsApp Business App consistently and can benefit from advanced API tools to scale operations.**&#x20;

</details>

<details>

<summary>Are marketing messages sent from a Partner platform via Cloud API supported on the WhatsApp Business App?</summary>

Yes, both the WhatsApp Business App and Cloud API support the same types of messages, including Marketing, Utility, Service, and Authentication messages.

</details>

<details>

<summary>Can a business using the Coexistence via Cloud API switch back to WhatsApp Business App with the same number?</summary>

Yes. To disconnect your number from the Cloud API, go to **Settings > Account > Business Platform** and click the **Disconnect** button.

⚠️ **Important:** Please do not disconnect the app without first consulting our team to ensure you don’t lose any data and to understand the implications.

* **Stop sending messages from your phone number?** You do not need to disconnect the number; simply stop sending messages.
* **Remove access to the app?** This is not possible through the API.

</details>

<details>

<summary>Can a business use their WhatsApp API number to register on the WhatsApp Business App?</summary>

No, this process only works for numbers registered in the App. If the number is connected to the WhatsApp API, this Coexistence Onboarding won't work.

</details>

<details>

<summary>Is this solution applicable to larger enterprises?</summary>

The primary use case is to assist SMBs that have not previously onboarded to the WhatsApp Business API. The solution is not specifically designed for larger enterprises.

</details>

<details>

<summary>Will businesses with Meta Verified blue badges on WhatsApp Business App maintain their verification when connecting to the WhatsApp Business API?</summary>

Currently, the blue badge verification does not transfer between the WhatsApp Business App and Cloud API. You will need to go through the [OBA process](https://docs.360dialog.com/partner/partner-hub/official-business-account-oba) again.

</details>

<details>

<summary><strong>Is it possible to migrate a number from another BSP to us with COEX enabled?</strong></summary>

Yes, it’s possible. To do so:

1. Go to the **WhatsApp Business App > Settings > Account > Business Platform** and click **Disconnect Account** to unlink from the current BSP (and Cloud API).
2. Re-onboard the number using **360Dialog** [**COEX Onboarding**](https://docs.360dialog.com/partner/onboarding/whatsapp-coexistence/coexistence-onboarding).

Your message history will be preserved after migration.

</details>

<details>

<summary>Can Government accounts have COEX?</summary>

Yes. Government accounts can have COEX.

</details>

<details>

<summary>Can we activate multiple COEX numbers under one Business Manager (BM)?</summary>

Yes. There is currently no stated limit on the number of COEX numbers that can be activated under a single BM.

</details>
