# Coexistence Onboarding

## 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).

{% hint style="info" %}
**You can create a new Meta Business Account or connect to an existing one during the Embedded Signup process.**

Please choose your Business Manager carefully, since it can't be changed after the number is registered. **It is mandatory that the Business Manager is owned by the Business who is sending messages. Adding users who do not belong to this company can cause your Business Manager to be blocked.**

You must add your information in the[ Business Info](https://www.facebook.com/business/help/257957338156440?id=180505742745347) section of **Business Manager Settings**. You need to include a legal name, an address, a website, and the business phone number you intend to use for messaging.
{% endhint %}

## S**tep-by-Step Procedure**

{% stepper %}
{% step %}

### S**tart the Embedded Signup (ES) via 360dialog**

* 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="/files/xJE40dIYgPZ9uO1ytS58" alt="" width="329"><figcaption></figcaption></figure>
  * **Yes**, this number is connected to the WhatsApp Business App.<br>

    <figure><img src="/files/6AuTzQJjvbqZCEk5iwcW" alt="" width="306"><figcaption></figcaption></figure>
* Confirm the number details.
  {% endstep %}

{% step %}

### C**onnect 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="/files/P6l0KpAon6MU3lr15lI2" 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 %}

### C**onfirm 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 %}

### F**inish 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).
  * **Contacts and history sync** will begin, if chosen.
  * Webhooks will be logged and available.
    {% endstep %}
    {% endstepper %}

{% hint style="info" %}
Onboarding and synchronization can take several minutes, depending on a number of factors such as the size of the business's messaging history, internet speed, etc. If you encounter any issues, please [reach out to our Support Team.](broken://pages/-MR0aNObaBED89Cgo23u)
{% endhint %}

***

## P**ost-Onboarding Notes**

You may now:

* Set the number webhook.
* Start processing **echo payloads**.
* Refer to the [Echo Payload Documentation](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#smb-message-echoes) for implementation.


---

# 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://docs.360dialog.com/partner/onboarding/whatsapp-coexistence/coexistence-onboarding.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.