> 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

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), without enabling coexistence.
{% endhint %}

### Before you start

Make sure the following are in place before you begin:

* The latest version of the WhatsApp Business App is installed on a smartphone with a camera. A QR code must be scanned during signup.
* The profile picture is set correctly in the WhatsApp Business App. Profile picture updates are not supported after onboarding.

#### Business portfolio requirements

You can create a new Meta business portfolio, or connect to an existing one, during Embedded Signup. Note the following:

* Choose your business portfolio carefully. It cannot be changed after the number is registered.
* The portfolio must be owned by the business sending the messages. Adding users who do not belong to this company can cause the portfolio to be blocked.
* Complete the Business Info section in your Business Portfolio Settings. You must include a legal name, an address, a website, and the business phone number you intend to use for messaging.

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

{% stepper %}
{% step %}

### **Launch Embedded Signup**

The entry point depends on your setup:

* **Direct 360dialog clients:** Log in to the Hub and click Add channel.
* **Clients using an integration partner:** Launch Embedded Signup from the partner's application. Some partners provide a link or button for this.

<div align="left"><figure><img src="/files/kqg9O1pgL4kSKPhs4fi4" alt="Add channel &#x22;+&#x22; button" width="513"><figcaption><p>Add channel button</p></figcaption></figure></div>

{% hint style="warning" %}
**Add Channel button disabled**

The Add channel button is disabled for Partner-Paid accounts, where an integration partner handles your WhatsApp API billing. In this case, start Embedded Signup from your partner's application. If you do not have an integration partner, or need help registering a number, contact our Support team.
{% endhint %}

Then complete the following:

1. Select the desired pricing plan and click Continue.<br>

   <div align="left"><figure><img src="/files/vkIF9hefIbXKIy36sSU8" alt="" width="521"><figcaption></figcaption></figure></div>

2. Enter the phone number and click Next.<br>

   <div align="left"><figure><img src="/files/ibUqdwTCnU6UJNYjOQP7" alt="" width="524"><figcaption></figcaption></figure></div>

3. Select the option Yes, Business App.<br>

   <div align="left"><figure><img src="/files/dyCWLH4TYMn6FSw5oqS2" alt="" width="488"><figcaption></figcaption></figure></div>

   <br>

{% endstep %}

{% step %}

### Choose your account-flow (EU vs non-EU)

The next screen, Do you have a Facebook account?, varies depending on the origin of the number:

* **EU numbers:** Select Yes, I have a Facebook account. It is not possible to continue without a Facebook account.
* **Non-EU numbers:** Select either 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="info" %}
**WhatsApp Login Availability**\
With WhatsApp login, businesses can onboard a number without a Facebook account. This feature is in Beta. If you are interested, contact us.
{% endhint %}

Next, click Open Meta Signup.&#x20;

<div align="left"><figure><img src="/files/cNFUpJLo98EUGN0fjAkc" alt="" width="563"><figcaption></figcaption></figure></div>

This opens Meta's signup in a pop-up window, so make sure pop-ups are allowed:

* **EU numbers:** Continue with Facebook.
* **Non-EU numbers:** You may also see Continue with WhatsApp Business, if the feature is enabled and you are not logged in to any Facebook Manager.

<div align="left"><figure><img src="/files/Ej139eLN3R9Ew3UKuX6o" alt="" width="437"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

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

1. Select Connect a WhatsApp Business App.\ <br>

   <div align="left"><figure><img src="/files/lGQTtuK9ofQHhB5HW6KN" alt="" width="375"><figcaption></figcaption></figure></div>

2. Enter the phone number 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 prompts you to scan a QR code.**an a QR code**.<br>

   <div align="left"><figure><img src="/files/P6l0KpAon6MU3lr15lI2" alt="" width="375"><figcaption></figcaption></figure></div>

5. Tap the message, then either scan the QR code shown on screen or enter the access code.<br>

   <div align="left"><figure><img src="/files/UjKyZPZHW4eF4MizSvbf" alt="" width="356"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### C**onfirm migration and history sync**

Tapping the message opens the Connect to the Business Platform screen.&#x20;

* [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, including the account name and time zone.<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>
* Continue to complete signup.&#x20;

\---

Once completed:

* 360dialog creates the integration.
* The number is ready for use on the WhatsApp Business Platform.
* Contacts and history sync begins, if chosen.
* Webhooks are logged and available.
  {% endstep %}
  {% endstepper %}

***

{% hint style="info" %}
**Setup Time**\
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, or if the setup takes longer than 5 minutes, contact [our Support Team](/docs/support/get-support.md).&#x20;
{% endhint %}

#### Coexistence Webhook Download

360dialog direct clients do not use a partner-configured webhook URL, so you can sync the history and then download it from the 360dialog Hub. Note: this option is not available for Clients who use an integration Partner.&#x20;

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

***

### After onboarding

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.