> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/hub/embedded-signup/coexistence-onboarding.md).

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

> **Profile picture updates are not supported after onboarding. Businesses should ensure that the profile picture is set correctly in the WhatsApp Business App before starting the onboarding process**

{% 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.360dialog.com/docs/hub/embedded-signup/coexistence-onboarding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.