> For the complete documentation index, see [llms.txt](https://help.pickyassist.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pickyassist.com/setting-up-guide/connecting-channels/connecting-whatsapp-business-app-mobile-app-coexistence.md).

# Connecting WhatsApp Business APP (Mobile App) Coexistence

Connect your existing WhatsApp Business App number to Picky Assist while keeping the mobile app active.

Connect your existing WhatsApp Business App number to Picky Assist without deleting it from the app. Continue using the mobile app for calls, groups, communities, and manual conversations.

{% hint style="warning" %}
**For WhatsApp Web Automation users**

Disconnect your number from WhatsApp Web Automation before reconnecting it through coexistence. Use either the WhatsApp Official Managed Service or WhatsApp Cloud Channel. Coexistence is an official WhatsApp solution.\
\
WhatsApp messaging charges and policies still apply.
{% endhint %}

### What is WhatsApp coexistence?

WhatsApp coexistence lets you use the WhatsApp Business App and WhatsApp Business Platform with one phone number. Your team can keep chatting in the app. Picky Assist can run automation, templates, broadcasts, and CRM workflows.

Recent chats and contacts sync between both environments. This preserves customer context while combining human support and automation.

{% embed url="<https://www.youtube.com/watch?v=-hENLdeUuU4>" %}

{% hint style="info" %}
Availability depends on your country, account eligibility, and Meta's current rollout.
{% endhint %}

### Why use coexistence?

Moving from the mobile app to the API previously required a full migration. Coexistence avoids that disruption. It mirrors messages and syncs recent chat history, so you can scale with templates, broadcasts, and CRM workflows.

### How coexistence works

Meta Embedded Signup links your existing WhatsApp Business App number to the API. Scan a QR code and authorize the connection. The app and API then work in parallel:

* **Use one number:** Keep your current WhatsApp Business number in both environments.
* **Continue manual conversations:** Use the mobile app for real-time chats while the API handles automation, [chatbots](https://pickyassist.com/en/whatsapp-nocode-chatbot-builder), campaigns, and CRM workflows.
* **Sync recent conversations:** You can share up to 180 days of chat history. Media files do not sync.

{% hint style="warning" %}
Not every WhatsApp Business App account is eligible. Meta evaluates factors including country code, account age, and messaging quality.
{% endhint %}

### WhatsApp message pricing <a href="#pricing" id="pricing"></a>

Messages sent in the WhatsApp Business App remain free. Messages sent through the API are charged under WhatsApp's current pricing and policies.

### Connect through Picky Assist V4

Activate WhatsApp coexistence through either the **WhatsApp Official Managed Service (WhatsApp Business API)** or **WhatsApp Cloud Channel**.

The options differ only in billing and support:

* With the [**WhatsApp Official Managed Service**](/setting-up-guide/connecting-channels/whatsapp-official-managed-service.md), messaging charges are paid to Picky Assist, and we provide all related support.
* With the [**WhatsApp Cloud API**](/setting-up-guide/connecting-channels/connecting-whatsapp-cloud-api.md), you must add a credit card directly to your Meta account, and for any support, you need to contact Meta via the Meta Business Suite.

Both options provide the same coexistence functionality.

Complete these steps to connect either option:

1. Go to **Settings** and select [**Channels**](https://pickyassist.com/app/settings/channels).
2. Click **Connect** for **WhatsApp Official Managed Service** or **WhatsApp Cloud Channel**.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2F1aIedHrff9YiDKjHAj7W%2Fimage.png?alt=media&amp;token=30dbc3d8-5018-4e90-8fe8-84da25e7efd1" alt=""><figcaption></figcaption></figure>

3. A **Connect WhatsApp Channel** pop-up appears with two options:
   * **Managed Channel:** Message charges are billed by Picky Assist. Available payment methods include Net Banking, UPI, Debit/Credit Cards, and PayPal. An INR wallet is available for Indian customers.
   * **Cloud Channel:** Message charges are billed by Meta (WhatsApp), and a credit card is required.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FZHqmztKlrvdBoH4B1bPP%2Fimage.png?alt=media&amp;token=7be58695-1ae7-4b59-a0d3-3a0756ed5c2c" alt=""><figcaption></figcaption></figure>

#### Use an existing WhatsApp Business number

4. Choose this option to connect a number registered with the WhatsApp Business App.

* The number must already be registered with the WhatsApp Business App.
* **eCommerce features, including Catalog and Orders, are not available** with this connection option, as indicated in the interface.

5. Follow the on-screen instructions to open Meta Embedded Signup.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FjzUFPbSeKzpZn5Ads9Sa%2Fimage.png?alt=media&amp;token=c3b85a4a-abd0-4fc9-9a6c-81f83b7d720c" alt=""><figcaption></figcaption></figure>

6. In the WhatsApp dialog, select **Connect with WhatsApp**.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2F9eFHhdNhl10WbgkTCmBT%2Fimage.png?alt=media&amp;token=d4662707-4a1c-4513-8c2b-4e5cc78c6604" alt=""><figcaption></figcaption></figure>

7. On **Add your WhatsApp phone number**, choose the option for your existing WhatsApp Business number.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FAyhNjalG6ZwFu6i4cnd3%2Fimage.png?alt=media&amp;token=a45d1073-e3b2-45b7-b980-f7f476a304de" alt=""><figcaption></figcaption></figure>

8. Enter your WhatsApp Business App number, then select **Next**.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FDABonv5DyQT2Jwbhgoot%2Fimage.png?alt=media&amp;token=2c2f9d4c-801b-489a-81ad-1b05ee208fff" alt="" width="375"><figcaption></figcaption></figure>

9. A QR code appears. WhatsApp also sends a notification to your mobile app.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2Fcd1rziFPfACgSPoabbmZ%2Fimage.png?alt=media&amp;token=a5623e72-ef15-4ca5-a10d-2d0abec5985e" alt=""><figcaption></figcaption></figure>

10. In the WhatsApp notification, select **Connect**.\ <br>

    <figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FsSfg8LT4xFBGHO3zKCf7%2FIMG_6654.png?alt=media&amp;token=3ffbfafc-ab83-4272-add7-72af46bff255" alt="" width="188"><figcaption></figcaption></figure>
11. Select **Connect to Business Platform**.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FuXUWgu32KnZqNac8wdvN%2FIMG_6655.png?alt=media&amp;token=8cb4902e-6632-495a-8462-a4fb2d432592" alt="" width="188"><figcaption></figcaption></figure>

12. Select **Share all chats** to sync up to 180 days of message history to Picky Assist. Otherwise, select **Don't share chats**. Then select **Confirm**.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FAWoMyUrX96QNTvWUStCb%2FIMG_6656.png?alt=media&amp;token=91195b2b-f24a-4b2a-8f09-4132f6623036" alt="" width="188"><figcaption></figcaption></figure>

13. The app opens your camera. Scan the QR code on the Embedded Signup page to complete pairing.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FzvNm4ygNw8EV3E3vL0GG%2FIMG_6657.png?alt=media&amp;token=8940e619-0e7d-4efb-af91-25580a718b42" alt="" width="188"><figcaption></figcaption></figure>

The pairing progress screen appears. Completion can take two to three minutes.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FTxHrPXAMsQqbA4TrQAFI%2Fimage.png?alt=media&amp;token=baa1e865-e848-4001-a8fc-b4e1edb4bc10" alt="" width="177"><figcaption></figcaption></figure>

### Disconnect from WhatsApp Business API

Disconnect coexistence at any time from the primary WhatsApp Business App device. Go to **Settings → Account → Business Platform**, then select the disconnect option.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2Fdgj9F5ld7Y3HFOcnJ8iX%2Fimage.png?alt=media&amp;token=54d9c27e-2ca0-4d37-8bcf-f06230135433" alt="" width="178"><figcaption></figcaption></figure>

### Common errors and solutions

#### “Number Linked to Facebook Page”

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FU8WI1PrZgV1mV8I7vzW3%2Fimage.png?alt=media&amp;token=ba486b0c-24de-4f38-a97f-c674277588d6" alt="" width="375"><figcaption></figcaption></figure>

Open [Facebook linked WhatsApp settings](https://www.facebook.com/settings/?tab=linked_whatsapp). Find the number, then select **Remove** to unlink it from the Facebook Page.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FrjGGW38ntdiJZ7mzprVS%2Fimage.png?alt=media&amp;token=fcd4ec1f-59cc-4ddb-8322-de60f6a222a9" alt=""><figcaption></figcaption></figure>

#### `GraphQL operation responded with error %s: %s %s`

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FCGmeYaWChjCk4OLm9sgQ%2Fimage.png?alt=media&amp;token=0e8a58f4-bc6a-47f5-b16a-a3985c039020" alt="" width="375"><figcaption></figcaption></figure>

Close the dialog and restart Embedded Signup from Picky Assist.

#### “Phone number you entered is not associated with the business you selected”

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FwG2e3dwfqUxuMB5DBWtX%2Fimage.png?alt=media&amp;token=8641fefc-6f4f-474a-8f19-f05e8b122ffe" alt="" width="360"><figcaption></figcaption></figure>

This happens when the number belongs to another business portfolio. Select **Unlink this phone number**, then complete the unlinking flow.

#### “Credit allocation not allowed”

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2Fh48tZEaaXK1fHVPLtsUi%2Fimage.png?alt=media&amp;token=b242481d-d0f3-4682-a6e2-2bd20f2dc885" alt=""><figcaption></figcaption></figure>

This can occur with the Picky Assist Managed WhatsApp service when your existing WhatsApp Business Account uses a currency other than INR. It often indicates that you already have direct Meta billing.

Use the **WhatsApp Cloud** option instead. You can keep your Meta payment method, and Meta bills WhatsApp messaging charges directly.

#### “WhatsApp Business App not supported”

Update WhatsApp Business from the App Store or Google Play. You need version `2.24.17` or later.

#### “The business you selected is already sharing this WABA with a partner”

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FQVtTOxpTOo2x9QZ2BVUl%2Fimage.png?alt=media&amp;token=e233772e-2156-43d7-8b3a-66cab0ad3dc0" alt="" width="375"><figcaption></figcaption></figure>

This may happen after you disconnect a WhatsApp Business App and try to reconnect it. Meta does not currently support switching partners through the coexistence flow.

Some customers resolve this by removing the WhatsApp account from Meta Business Suite. This does not work in every case.\
\
To remove a WhatsApp Business Account, open [Meta Business Suite WhatsApp accounts](https://business.facebook.com/latest/settings/whatsapp_account).

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FWMbC8149AV5c4MYGQxZA%2Fimage.png?alt=media&amp;token=79a2da00-2651-49f9-9e4c-54a988a3ecf9" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.pickyassist.com/setting-up-guide/connecting-channels/connecting-whatsapp-business-app-mobile-app-coexistence.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.