> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/tong-xun-qu-dao/integrations/whatsapp-coex-istence-integration-with-omnichat-add-on-module.md).

# WhatsApp Coex-istence integration with Omnichat(Add-On Module)

How to WhatsApp integrate Coex-istence with Omnichat?

With this add-on module enabled, when integrating a WhatsApp channel, it supports connecting a **WhatsApp Business App account**.

After integration, users can send messages via the **WhatsApp Cloud API within the Omnichat system**, while still continuing to use the **WhatsApp Business App** as usual. Messages sent from the WhatsApp Business App will also be synced and reflected in the Omnichat backend.

{% hint style="warning" %}
After integration, the following features are <mark style="color:red;">**not supported**</mark>:

1. Sending broadcasts via the WhatsApp Business App (Meta‘s limitations).
2. Sending MM Lite messages: If the WhatsApp Business App is selected during integration, the subsequent MM Lite consent flow will not be available (Meta's limitations).
3. Syncing historical messages from the WhatsApp Business App prior to integration into the Omnichat backend.
4. Group chat functionality within the Omnichat backend.
   {% endhint %}

### Integration Steps

#### Omnichat Platform Side

1. Log in to the [Omnichat backend](https://app.omnichat.ai).
2. In the left sidebar, go to **Channels >** [**Social Channels**](https://console.omnichat.ai/social-channels).
3. Select the **WhatsApp** tab, then click **“Connect WhatsApp Business API Account”**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FG4wEb2565O28n6vmVYKI%2Fimage.png?alt=media&amp;token=90e81495-479f-4070-bc61-b6d8751bf8bf" alt=""><figcaption></figcaption></figure>

4. Proceed to the Facebook authorization page: **Connect your account to Omnichat Limited**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FnAVuOluajpkq8xRPGYfZ%2Fimage.png?alt=media&amp;token=127c0edb-3ccf-4983-aaca-5d58ce57004e" alt="" width="433"><figcaption></figcaption></figure>

5. Select the business assets to share with Omnichat:
   1. Business portfolio
   2. WhatsApp Business account: **Connect a WhatsApp Business App**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FZIwrZJhKRq1Qd89UoUUd%2Fimage.png?alt=media&amp;token=76cb72d6-0c31-4b74-9081-da2a45374ac7" alt="" width="375"><figcaption></figcaption></figure>

6. Enter your WhatsApp Business phone number

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fo4giFntjX8WZxMYmMtl4%2Fimage.png?alt=media&amp;token=fcedd02b-7c1b-4fdc-ad43-3116bd90e76c" alt="" width="432"><figcaption></figcaption></figure>

7. Use your **WhatsApp Business App to scan the QRcode**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F1K0OxLzgrmM2davDzdsp%2Fimage.png?alt=media&amp;token=c864a918-d073-4125-bbd3-93e5b195007d" alt="" width="433"><figcaption></figcaption></figure>

#### WhatsApp Business App Side&#x20;

1. Click the **"Connect"** button located below the **"Connect to the Business Platform"** message.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FoopXE2piaK9uZfSkMQzM%2Fimage.png?alt=media&amp;token=f4fd0a47-5782-4191-b1ea-fa9cd324ea71" alt="" width="375"><figcaption></figcaption></figure>

2. Click "**Connect to the Business Platform**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FjPzIof2bVWCUhuLqByrC%2Fimage.png?alt=media&amp;token=eabf0cc5-61f8-42cb-87d6-958142202917" alt="" width="375"><figcaption></figcaption></figure>

3. Select "**Share all chats**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FDkTUsmYqPFKiv7Ldtv2c%2Fimage.png?alt=media&amp;token=cf14a583-de4e-4b0d-a423-e9b8c6e87c14" alt="" width="375"><figcaption></figcaption></figure>

4. **Scan QR code** displayed in the Omnichat backend earlier

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FvfyNh008UG7eZd3F0ZcH%2Fimage.png?alt=media&amp;token=21f7e15e-d9fc-4d71-a48d-1e19f1874c81" alt="" width="375"><figcaption></figcaption></figure>

5. **Connecting your account**. This could take up to 45 seconds

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FvxHAtG6NdXwzxYOj5D11%2Fimage.png?alt=media&amp;token=9010bc07-d886-4eed-b4a7-8805e8a6215d" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
If you are continuously unable to scan the QR code, you can try switching to the **access code method** instead.

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FUSWbTpg8EzatMkXwnsbj%2Fimage.png?alt=media\&token=a09f7d88-2d80-4f56-9c5f-e6b89416278f)<img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FJ77fzc7Y9pfBl38BNzmj%2Fimage.png?alt=media&amp;token=d670a7ba-e2bc-4a80-afc8-99656900fa8c" alt="" data-size="original">
{% endhint %}

6. **"Omnichat Limited"** displayed under **Connected Platform**\
   \
   It indicates that the mobile-side setup has been completed. Please then return to the desktop screen and continue with the remaining integration steps.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FtKYxQFEqvF3rCBJAC4sX%2Fimage.png?alt=media&amp;token=255a4b20-7f79-4484-a4d9-33d2d374e20f" alt="" width="375"><figcaption></figcaption></figure>

#### Return to the **Omnichat Platform side to finish connection**

1. **Confirm or edit your WhatsApp Business account**
   1. WhatsApp Business account name
   2. Timezone

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FDCxlmI5pYDwOlgdOkYl4%2Fimage.png?alt=media&amp;token=5b719a3e-1cd8-44c7-808c-3091457c8df5" alt="" width="429"><figcaption></figcaption></figure>

2. **Review Omnichat's access request**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FUffs1V6lUSNYBuunfhns%2Fimage.png?alt=media&amp;token=1911b927-4f2d-4623-831d-484f190d6473" alt="" width="375"><figcaption></figcaption></figure>

3. **Connecting your account**

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FUvRFwIvh74ItnilFSbYd%2Fimage.png?alt=media&amp;token=dce461b4-614b-46a3-ada0-567ea534d953" alt="" width="441"><figcaption></figcaption></figure>

4. Click "**Finish**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F56lsKKoKaYZe6aoLO7S2%2Fimage.png?alt=media&amp;token=cd3fb6d1-2b61-41c1-8322-91783c44af0d" alt="" width="375"><figcaption></figcaption></figure>

#### Return to WhatsApp Business App for confirmtion

1. &#x20;click "**ok**" to confirm the integration&#x20;

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FlvUqD09oty3EhmyRQCce%2Fimage.png?alt=media&amp;token=9402e169-faab-4894-be3d-01cdb0406b99" alt="" width="375"><figcaption></figcaption></figure>

2. Once seeing **"Omnichat Limited"** displayed under **Connected Platform**, you're finally done!

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F4xHajOyeEDrqYPIetQqI%2Fimage.png?alt=media&amp;token=9ef21a26-1311-4a76-bd3f-12bae4a15331" alt="" width="375"><figcaption></figcaption></figure>

#### Return to Omnichat Platform Side to select the WhatsApp number

1. click "**Connect Phone Number**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F5ZiDHgeF0w2BczCJUNAr%2Fimage.png?alt=media&amp;token=4c505a16-a01e-4976-b596-eaf6d3f412bb" alt=""><figcaption></figcaption></figure>

2. select the Phone number from the pop-up to connect into Omnichat

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FTHW5zs3xZl4yzkTrKgKV%2Fimage.png?alt=media&amp;token=f6e1e892-d57f-4441-96dc-266e261b3812" alt="" width="375"><figcaption></figcaption></figure>

3. Showing on the Social Channel interface — you have now officially **completed** the **Coex integration**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F3lNymJz7piStonkjegIC%2Fimage.png?alt=media&amp;token=ab997bdc-e9af-4040-9fb4-7424e5750ff0" alt=""><figcaption></figcaption></figure>

### Disconnect WhatsApp Business App from Omnichat&#x20;

#### WhatsApp Business App Side

1. click "**Connect**" button where you previously connect your account

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fbz0dNRYm8yju7m7gBA5u%2Fimage.png?alt=media&amp;token=57b43a13-e918-4b19-b1e9-d533bb7e38d6" alt="" width="375"><figcaption></figcaption></figure>

2. click "**Omnichat Limited**" to enter

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fc4d40KnlwMkk7yc9safq%2Fimage.png?alt=media&amp;token=20ec9d9a-c858-4830-8355-ef7144298893" alt="" width="375"><figcaption></figcaption></figure>

3. click "**Disconnect**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fn7glWHKQNdNZJ0Uk9HT5%2Fimage.png?alt=media&amp;token=94083160-6d8d-49c2-a482-00a4c82a0b62" alt="" width="375"><figcaption></figcaption></figure>

4. click "**Next**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FTXQhHmVXlxhZc1Ka8UPF%2Fimage.png?alt=media&amp;token=72f04095-0ab8-4030-a6b0-1b3c81af22dd" alt="" width="375"><figcaption></figcaption></figure>

5. click "**Disconnected**"

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FAHZvhkat6qi2XFIyzNri%2Fimage.png?alt=media&amp;token=8623e525-4fc2-47d4-bde0-6276747ca4aa" alt="" width="375"><figcaption></figcaption></figure>

6. Waiting for Disconnecting

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FKbKn8mTQ75mGlui7bAuX%2Fimage.png?alt=media&amp;token=3db446b0-dc84-404c-91d5-da963a97c83b" alt="" width="375"><figcaption></figcaption></figure>

7. After seeing this screen, meaning the **mobile app setup has been completed successfully**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fwd6cQ2eLhGr8LRCf8JXN%2Fimage.png?alt=media&amp;token=16ed675d-009a-4987-b75b-1765e8e21467" alt="" width="375"><figcaption></figcaption></figure>

### Delete Omnichat data after disconnect

1. Click the delete button to delete all data existing in Omnichat.&#x20;

Proceeding with this action will completely erase all customer data existing in Omnichat (channel contacts and chat history). This action cannot be undone. Please confirm that you have already exported and backed up your data.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FSkPakeqgTUXKelpPu7nd%2Fimage.png?alt=media&amp;token=92b1a0d1-ca00-4eec-9aed-4e7b701348cd" alt=""><figcaption></figcaption></figure>

2. Enter "DELETE" to confirm this action.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FxBUhWrgQ5fBJVj9EyHsX%2Fimage.png?alt=media&amp;token=fc2e82b1-3995-41fc-8a83-7f9c40ec995d" alt="" width="563"><figcaption></figcaption></figure>

3. Syncing and deleting data... The final deletion will complete shortly.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FSvGgcxv7A4ANor1NKTAF%2Fimage.png?alt=media&amp;token=d34becf7-d8fd-4042-b0d9-697b738b0b72" alt=""><figcaption></figcaption></figure>

### Message Fees

* Pricing: Fees align with the existing WhatsApp message pricing model.
* Report: You can view your current expenses in the WhatsApp Message Report.
* Billing: Invoices for the previous month's message fees will be sent at the beginning of each month.
* Top-up Requirement: Teams must top up their account balance before sending messages. If the account balance is insufficient, messages cannot be sent.