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

### **Start 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.com/).\
   \
   If you already have a 360Dialog Hub account, you can get started by signing into your account on the [360Dialog Hub](https://app.360dialog.com/).
2. Open 360Dialog Hub and click the **Add number** button:

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

{% hint style="warning" %}
**Add number disabled**

The **Add Number** button is disabled for **Partner-Paid** accounts. ⇒ If this button is disabled, it indicates that you have a Partner-Paid account, where your partner manages WhatsApp API billing on your behalf. In this case, you must add a number through your integration partner’s application. If you do not have an integration partner, please contact our support team for assistance.
{% endhint %}

3. Select the desired pricing plan and click Continue

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

4. Enter the phone number and click Next.

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

5. Select the option **Yes, Business App**

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

{% endstep %}

{% step %}

### Flow varies depending on the origin of the number (EU vs. non-EU)

1. **EU numbers**
   * Choose the option Yes, I have a Facebook account (It is not possible to continue without a Facebook account)

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

2. **Non-EU numbers**
   * Can see two options: *Yes, I have a Facebook account*, or *No, I don´t have a Facebook account.*

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

{% hint style="warning" %}
Using WhatsApp login, the businesses can onboard the number without a Facebook account.\
It is in the Beta stage. If you are interested, please [contact us](/docs/support/get-support.md).
{% endhint %}

3. **Click Open Meta Signup**
   * Non-EU numbers can see the option to Continue with WhatsApp Business (just in case the feature is enabled and they are not logged in to any Facebook Manager)
   * EU number can continue with Facebook

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

<figure><img src="/files/Ej139eLN3R9Ew3UKuX6o" alt=""><figcaption></figcaption></figure>
{% 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 either scan the QR displayed on screen or insert the access code:\
     ![](/files/UjKyZPZHW4eF4MizSvbf)
     {% 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;
>
> ![](/files/TgCmz5ftrL6QunPlrHQ7)

***

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