> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Coexistence

> Learn how to connect WhatsApp Coexistence in ChatbotX to retain your existing WhatsApp Business number, sync contacts, and continue customer support.

**WhatsApp Coexistence** allows you to retain your existing WhatsApp Business number when connecting to ChatbotX. This setup supports using the WhatsApp Business mobile app and the WhatsApp Business API simultaneously on the same phone number. It also syncs your contacts and chat history, allowing you to manage customer conversations without interruption.

## Overview of WhatsApp Coexistence

With this integration, you can:

* Use the WhatsApp Business mobile app and ChatbotX's WhatsApp API simultaneously.
* Sync contacts and chat history from the mobile app to ChatbotX.
* Respond manually from your phone when needed.
* Unlock advanced WhatsApp API features in ChatbotX, such as template messages, automations, and centralized inbox management.

> **Note:** This feature may not be available in all countries and territories. Support depends on your phone number's country code and Meta's current policies at the time of setup.

### Automation

The WhatsApp Business mobile app includes basic automation features like greeting messages and away messages. If you are using these automations on your mobile app, ensure you turn them off before getting started with ChatbotX.

### Message Pricing

After setting up your business account on the Cloud API:

* Messages sent directly from your WhatsApp Business mobile app remain free.
* Messages sent through ChatbotX follow Meta's Cloud API pricing.

## Before you begin

Prepare the following details before starting:

* Your active WhatsApp Business phone number.
* A Meta Business Account (Business Portfolio) with management permissions for the number.
* Your business display name.
* Your website URL, business category, and timezone.

If you need instructions for a standard WhatsApp Business Account (WABA) registration, refer to the [Connect WhatsApp](/channels/whatsapp/whatsapp-connect) article.

## Step 1: Open the Channel Selection page

1. Go to **Settings** → **Channel**.
2. Click **Add WhatsApp**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_channel_selection.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=817846ce524ead546bb60c6de54c445a" alt="Whatsapp Coexistence Channel Selection" width="3126" height="1453" data-path="images/whatsapp_coexistence_channel_selection.png" />
</Frame>

## Step 2: Select WhatsApp in the Create Workspace menu

On the **Create Workspace** menu, click **Continue** next to the **Whatsapp** option.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_create_workspace.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=926a3271e1ed5408fd134d6f1b4b0d81" alt="Whatsapp Coexistence Create Workspace" width="3130" height="1656" data-path="images/whatsapp_coexistence_create_workspace.png" />
</Frame>

## Step 3: Choose the WhatsApp connection type

1. Turn on **Connect an existing WhatsApp Business Account**.
2. Click **Continue**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_connect_option.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=2442af7d9b82487faf2e9a190c308540" alt="Whatsapp Coexistence Connect Option" width="1849" height="1148" data-path="images/whatsapp_coexistence_connect_option.png" />
</Frame>

## Step 4: Log in and confirm your Facebook account

Log in to the personal Facebook account that manages your Meta Business assets, then click **Continue as \[Your Name]**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_fb_auth.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=216532268088a013c1ea3490b51b8f48" alt="Whatsapp Coexistence Fb Auth" width="3098" height="1737" data-path="images/whatsapp_coexistence_fb_auth.png" />
</Frame>

## Step 5: Confirm access permissions

Review the permissions page showing *"Seamlessly connect your account to..."*, then click **Continue**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_permissions.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=df5d30aa443c1ac1ac8571754f3ac19e" alt="Whatsapp Coexistence Permissions" width="3096" height="1750" data-path="images/whatsapp_coexistence_permissions.png" />
</Frame>

## Step 6: Select Business Assets

1. Under **Business portfolio**: Select the Meta Business Account that owns your assets.
2. Under **WhatsApp Business account**: Click the dropdown and select **Connect a WhatsApp Business App**.
3. Click **Next** to proceed.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_business_assets.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=6506356e6ea931cc071bc66683697b66" alt="Whatsapp Coexistence Business Assets" width="3097" height="1757" data-path="images/whatsapp_coexistence_business_assets.png" />
</Frame>

## Step 7: Enter your WhatsApp Business phone number

1. Select your country code (e.g., `VN +84` for Vietnam).
2. Enter the WhatsApp Business phone number currently active on your mobile app.
3. Click **Next**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_enter_number.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=c9e0ebedafa8e63f0bf1fd358beb8111" alt="Whatsapp Coexistence Enter Number" width="3095" height="1765" data-path="images/whatsapp_coexistence_enter_number.png" />
</Frame>

## Step 8: Read the existing app connection details

Review the information regarding Sharing Access and Protecting your data, then click **Next** to proceed to the QR code synchronization step.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_connect_details.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=93d6e3e34f54b40ba1177fd2551833ea" alt="Whatsapp Coexistence Connect Details" width="3096" height="1759" data-path="images/whatsapp_coexistence_connect_details.png" />
</Frame>

## Step 9: Get the sync QR code on your computer

Your computer screen will display a QR code along with connection instructions. Keep this screen open; you will scan this QR code from your mobile phone in the next step.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_scan_qr_desktop.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=cf1312def1cd3843f0103754805f172e" alt="Whatsapp Coexistence Scan Qr Desktop" width="3094" height="1764" data-path="images/whatsapp_coexistence_scan_qr_desktop.png" />
</Frame>

## Step 10: Link the account on your mobile app

Open your phone and complete the following steps:

<Steps>
  <Step title="Open the connection chat">
    Find the official chat from the **Facebook Business** account on WhatsApp, then tap **Connect**.
  </Step>

  <Step title="Accept the connection">
    On the *"Connect to the Business Platform"* screen, tap **Connect to the Business Platform**.
  </Step>

  <Step title="Select chat history synchronization">
    Under the *"Share chat history"* dialog, select **Share all chats** (to sync up to 6 months of 1:1 conversation history) or *Don't share chats*, then tap **Confirm**.
  </Step>

  <Step title="Scan the QR code">
    Point your phone's camera to scan the QR code displayed in Step 9 on your computer screen, then tap **OK**.
  </Step>

  <Step title="Complete the mobile setup">
    Wait a few seconds for the synchronization to finish. Once the success message *"You're connected to AhaChat"* appears on your phone, tap **OK**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_mobile_flow.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=b239b92b30f0f51805e377c75842c529" alt="Whatsapp Coexistence Mobile Flow" width="3813" height="1517" data-path="images/whatsapp_coexistence_mobile_flow.png" />
</Frame>

## Step 11: Confirm or edit your WhatsApp Business Account details

Go back to your computer screen:

1. Confirm your display name under **WhatsApp Business account name**.
2. Select your timezone under **Timezone** (e.g., `(GMT-07:00) Etc/GMT+7` or your local timezone).
3. Click **Next**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_confirm_account.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=8ea92a38a6c4bdc32e632f5eb99b03c0" alt="Whatsapp Coexistence Confirm Account" width="3098" height="1767" data-path="images/whatsapp_coexistence_confirm_account.png" />
</Frame>

## Step 12: Review details shared with ChatConnectX

Check the list of requested permissions for account management and message delivery, then click **Confirm**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_review_permissions.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=e9efbf7981732077d04b730984e4ad57" alt="Whatsapp Coexistence Review Permissions" width="3098" height="1764" data-path="images/whatsapp_coexistence_review_permissions.png" />
</Frame>

## Step 13: Complete the Meta connection flow

Meta will show a message confirming that your account is linked (*"Your account is connected to..."*). Click **Finish** to close the setup window and return to ChatbotX.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_connected_success.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=d3e305c5a99a638d40bc568d493a8816" alt="Whatsapp Coexistence Connected Success" width="3099" height="1763" data-path="images/whatsapp_coexistence_connected_success.png" />
</Frame>

## Step 14: Enable contact and history synchronization

1. Once you return to ChatbotX, a sync prompt will appear.
2. Click **Enable sync** to import your contacts and up to 6 months of chat history from the mobile app to ChatbotX.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_sync_history.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=3ddcff3c2a9d13b2031667784c4dd752" alt="Whatsapp Coexistence Sync History" width="1753" height="1016" data-path="images/whatsapp_coexistence_sync_history.png" />
</Frame>

## Step 15: Verify on the Dashboard

After synchronization completes, your new WhatsApp channel (e.g., `May Store`) will appear on the dashboard with a **Test Now** button to send a test message.

<Frame>
  <img src="https://mintcdn.com/chatbotx/TVQD4ONZaFXjuqvh/images/whatsapp_coexistence_dashboard_check.png?fit=max&auto=format&n=TVQD4ONZaFXjuqvh&q=85&s=952b39c72219903a2c441e9e28ee9b17" alt="Whatsapp Coexistence Dashboard Check" width="3088" height="1463" data-path="images/whatsapp_coexistence_dashboard_check.png" />
</Frame>

## FAQ

<AccordionGroup>
  <Accordion title="Can I keep my existing WhatsApp Business phone number?">
    Yes. WhatsApp Coexistence allows you to use your active WhatsApp Business mobile number when connecting to ChatbotX.
  </Accordion>

  <Accordion title="Will my contacts and chat history be synchronized?">
    Yes, ChatbotX supports synchronizing contacts and chat history during the setup process.
  </Accordion>

  <Accordion title="Why is my message sending rate limited immediately after setup?">
    This is usually a temporary limitation while Meta reviews your account display name.
  </Accordion>
</AccordionGroup>