# 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

* 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 %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuals.dialox.ai/studio/channels/whatsapp/whatsapp-coexistence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.