# Coexistence Onboarding

This guide shows how to add a WhatsApp Business app account and phone number to the WhatsApp Business Platform with 360Dialog.

Using the same phone number for both the WhatsApp Business App, and the WhatsApp Business Platform, is known as [Coexistence](/docs/resources/phone-numbers/coexistence.md).

{% hint style="info" %}
**Not using the WhatsApp Business App?**\
If the business is not using the WhatsApp Business App, register the number through the standard [Embedded Signup](/docs/hub/embedded-signup.md) process, without enabling coexistence.
{% endhint %}

## R**equirements**

Before onboarding a number to the WhatsApp Business Platform using Coexistence, make sure:

* [x] The latest version of the WhatsApp Business app is installed on a smartphone with a camera (QR code needs to be scanned during signup).

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

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

You must add your information in the [Business Info](https://www.facebook.com/business/help/257957338156440?id=180505742745347) section of **Business Portfolio 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 Embedded Signup**

1. If you don't have a 360Dialog Hub account, follow the link provided by your Integration Partner, or use our [sign up page](https://app.360dialog.io/signup/).\
   \
   If you already have a 360Dialog Hub account, you can get started by signing into your account on the [360Dialog Hub](https://app.360dialog.io).
2. Open 360Dialog Hub and click the **Add number** button:

<div align="left"><figure><img src="/files/glViOJQX7Jmjy8z5zmee" alt="" width="225"><figcaption></figcaption></figure></div>

If another number has previously been added, click the top-right corner and select **Add number**.

<div align="left"><figure><img src="/files/Yg1L4MBLRHwQ3Kgtuxbp" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
The **“Add Number”** button is **disabled** for **Partner-Paid accounts**. If the button is grayed out, you may have a **Partner-Paid account**. This guide should be followed by owners of **Direct-Paid accounts.**

If your account is a **Partner-Paid account,** refer to your partner's documentation on adding a new phone number, or contact your partner for assistance.
{% endhint %}

3. In the form that opens, select:

* **No**, this number is not connected to the WhatsApp Business API.\ <br>

  <div align="left"><figure><img src="/files/xJE40dIYgPZ9uO1ytS58" alt="" width="329"><figcaption></figcaption></figure></div>
* **Yes**, this number is connected to the WhatsApp Business App.<br>

  <div align="left"><figure><img src="/files/6AuTzQJjvbqZCEk5iwcW" alt="" width="306"><figcaption></figcaption></figure></div>

4. Click the **"Confirm the number details"** button.
   {% endstep %}

{% step %}

### C**onnect the WhatsApp Business App**

1. Proceed with the **“Connect a WhatsApp Business App”** option.\
   ![](/files/lGQTtuK9ofQHhB5HW6KN)
2. Enter the phone number again and verify.<br>

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

     <div align="left"><figure><img src="/files/P6l0KpAon6MU3lr15lI2" alt="" width="296"><figcaption></figcaption></figure></div>
   * Tap the message and scan the QR displayed on screen.<br>

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

{% endstep %}

{% step %}

### C**onfirm Migration and History Sync**

Tapping the message button will:

* [x] Inform the business that chat history can be migrated to 360Dialog.
* [x] Enable history and contact sync (optional).<br>

  <div align="left"><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></div>

Tapping **“Scan QR code”** will trigger:

* [x] The **chat history sharing** with 360Dialog.
* [x] The connection to the WhatsApp Business Platform.<br>

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

{% endstep %}

{% step %}

### F**inish Embedded Signup**

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

<div align="left"><figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXcdPHPUY3shscMKwNmVk0lC0rXx7uqMvbypFPRkUz-X9EQ4uIEH5lBabgMfo57YJJeBNiM-IMazkDKsO5Rp6yzsVlPFXAFLcViHpc6QnkFvoMIzLOeH3AnB2M5Y7Zo90BxuZcLnzA?key=PrAgf3JroswxJliiZIwofKaM" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### Once completed:

* [x] 360Dialog will create the integration.
* [x] The number will be **ready for use** on the WhatsApp Business API.
* [x] **Contacts and history sync** will begin, if chosen.
* [x] Webhooks will be logged and available.

{% 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.](/docs/support/get-support.md)
{% endhint %}

> **360Dialog direct clients** don´t use a partner-configured webhook URL, so they can sync the history and then download it from the 360Dialog Hub.&#x20;

<figure><img src="/files/JTUoJRPNAPYP8TLGR16l" alt=""><figcaption></figcaption></figure>

***

### Post-Onboarding Notes

You may now:

* Set the phone number's webhook.
* Start processing Coexistence-exclusive webhooks. See [Webhook Reference](/docs/messaging/webhook/webhook-reference.md#coexistence-events) for implementation details.


---

# 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/docs/hub/embedded-signup/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.