> For the complete documentation index, see [llms.txt](https://manuals.dialox.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuals.dialox.ai/studio/channels/whatsapp/whatsapp-coexistence.md).

# WhatsApp Coexistence

Starting May 2026 DialoX supports WhatsApp Coexistence. This means that you can onboard a number to the WhatsApp API through DialoX when the number is already connected in the WhatsApp Business App.\
By using the Coexistence you can use all extra functionalities of DialoX without losing any of your contacts or chat history that exist your WhatsApp Business App.

### Important notes

* Groups are not available for Coexistence users and phone numbers onboarded to Multi-solution Conversations.
* To use the WhatsApp Coexistence, the WhatsApp Business App has to be in use for a minimum of 1 week.
* If you only have WhatsApp Business through API, you cannot use the WhatsApp Coexistence.
* It is not yet possible to sync your conversations and contacts to DialoX.
* 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.

### R**equirements**

Before onboarding a number to WhatsApp Coexistence Mode, make sure:

* The latest version of the WhatsApp Business App is installed on a smartphone with a camera (QR code required).<br>

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>You can create a new Meta Business Account or connect to an existing one during the Embedded Signup process.</strong></p></div>

## Coexistence Onboarding

{% stepper %}
{% step %}
**Start the Embedded Signup via with the 'Connect to WhatsApp' button**

* Use the standard 360dialog Embedded Signup process.
* In the flow, select:
  * **No**, this number is not connected to the WhatsApp Business API.<br>

    <figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2F3dZFHxfl3SKIFFF90rp8%2Fimage.png?alt=media&#x26;token=b1e6f7ec-a8d0-4fef-ac4a-12e817b35c12" alt="" width="329"><figcaption></figcaption></figure>
  * **Yes**, this number is connected to the WhatsApp Business App.<br>

    <figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2Fp8rvVSJG9kDbCa757WL2%2Fimage.png?alt=media&#x26;token=3402afb9-74c9-4f90-a3db-039d8a2a8b5d" alt="" width="306"><figcaption></figcaption></figure>
* Confirm the number details.
  {% endstep %}

{% step %}
**Connect the WhatsApp Business App**

* Proceed with the **“Connect your existing WhatsApp Business app”** option.<br>

  <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXeUzWejAhwRvJQf_DnWztnRuOXpMxQnFsXL0yKl25MGn154sTOsx0hWAv--6MP5cwnadpD-NvZ5_0N_1HNmaUhnp_IL9OBK4SDU18Tpfw4s9zaKDl5xV-0Bcbfr4QvnfpKAQzvBMQ?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure>
* Enter the phone number again and verify.<br>

  <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfy02jscuxXxHL613kTtc3MyK7MA38qv1py0kqJISdpaH_QWfzXeuGf3qO2X250UW53J31GPv07t37Ouylyar2f6PY5ryr6Y6Pl87iVbNdn83ZNyuK4JTfRzBDZ9lhltPwOh4AcWg?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure>
* Open the **WhatsApp Business App** on your phone.
* Follow the in-app instructions:
  * A **new WhatsApp message** will prompt you to **scan a QR code**.<br>

    <figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FyzjkMn3c2VAK0EB9GY2o%2Fimage.png?alt=media&#x26;token=67dcb839-b8a8-439d-9ca7-3384d03c5f4b" alt="" width="296"><figcaption></figcaption></figure>
  * Tap the message and scan the QR displayed on screen.<br>

    <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcA_3ck2UgCP6G2sELDx4e7GIFPPJVZvGz4GswdR1N_UhkG9cB2Sh9ictQXk6HrKjBIbCI5elohctVlqPrkGOM6Sa5fjNb4XT5dhLOtnO_i3cKsB0wze-RnOWu8bcRbxKKs3IBtWg?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
{% hint style="info" %}

#### **Step 3**

#### **The step to migrate chat history and contacts is NOT available yet in DialoX! Skip and continue on step 4.**

{% endhint %}

**Confirm Migration and History Sync**

* Tapping the message button will:
  * Inform the business that chat history can be migrated to 360dialog.
  * Enable history and contact sync (optional).<br>

    <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXd9iORc_QwNyaIp6-F5jP0Su0vIC5tnGOtkqHFZ6yxXGO11J-sfkn8ARyGfTTbP9PFEUJhlwN5yWQ_Jte7jss6-hZKPYp5RpYH-g4FGraPfz8mdObv9VgptCHELe426PGmyNwOQ8A?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure>
* Tapping **“Scan QR code”** will trigger:
  * The **chat history sharing** with 360dialog.
  * The connection to the WhatsApp Business Platform.<br>

    <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXdglyeBsCI-jvCbIqh5axYYO0SyB-qa-AXI1aMkeBoYBJASpXIYQmjL4aPqjeDorBA8JVnM1vabEVDVfSLyvaMFN22UXtize9N1TQiezctWlN4Roarmkm2DxTV5etawZmkIPQgyaw?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**Finish the Embedded Signup**

* Confirm or edit your **WhatsApp Business Account** information.<br>

  <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcdPHPUY3shscMKwNmVk0lC0rXx7uqMvbypFPRkUz-X9EQ4uIEH5lBabgMfo57YJJeBNiM-IMazkDKsO5Rp6yzsVlPFXAFLcViHpc6QnkFvoMIzLOeH3AnB2M5Y7Zo90BxuZcLnzA?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure>
* Once completed:
  * 360dialog will create the integration.
  * The number will be **ready for use** on the WhatsApp Business Platform (Cloud API).
    {% endstep %}
    {% endstepper %}

{% hint style="info" %}
Onboarding and synchronization can take several minutes, depending on a number of factors.
{% endhint %}

{% hint style="info" %}
<https://docs.360dialog.com/partner/onboarding/whatsapp-coexistence/coexistence-onboarding>
{% endhint %}