# Migrate a number to 360Dialog

## Preparation checklist

Before migrating a number, it's important to go through the following checklist with your Client:

* [x] Ensure the number you plan to migrate can receive and verify a 6-digit PIN via SMS or voice call, and that it can accept international calls.
* [x] Your client must have Admin Access to Meta Business Manager
* [x] You are migrating the number from another BSP
* [x] Your Meta Business Account is verified. 
* [x] The existing WhatsApp Business Account (WABA) must be approved. 
* [x] The Display Name is approved. 
* [x] Your existing WABA must have a valid payment method attached (in Payment Settings). 
* [x] Two-Factor Verification (2FA) must be disabled for the number. [Check how](broken://pages/TH82hPXdyNaWILey5gnf)
* [x] Make sure the Business website is live. Meta sometimes checks if the Website listed in the Meta Business Manager > Business Info section is correct and live. If it isn't, your account will be offline after the number is migrated.
* [x] 🇧🇷 Extra step for Brazilian numbers - Check your current WhatsApp profile to see if the number includes the extra “9.” Use the exact same format when migrating.

## **How to migrate a phone number**

The business should follow the standard process to *add a number* and start the Embedded Signup Flow.<br>

{% stepper %}
{% step %}

#### Provide the company and number details

<figure><img src="/files/gd3MWfQEzavO9F2AJCIf" alt=""><figcaption><p>Integrated Onboarding - Number registration</p></figcaption></figure>
{% endstep %}

{% step %}

#### Go through Meta Embedded Signup

<figure><img src="/files/JLBoQk3dkFSbk3eb8shk" alt=""><figcaption><p>Meta Embedded Signup - Number registration</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
The phone number should be available for use within approximately five minutes. The user will receive both an email notification and an in-app message once the migration is successfully completed. If you do not receive either notification, please [contact our Support Team](broken://pages/cl1bh3IjXG2UppfFUtz7).
{% endhint %}

Troubleshooting

Here are some common errors and solutions that you might encounter during the migration process:

<details>

<summary>Error adding a new number</summary>

When adding a number, if you see a red warning screen, it usually indicates that one of the required checks has not been completed: [#preparation-checklist](#preparation-checklist "mention").&#x20;

<div align="left"><figure><img src="/files/CsbefXlAUQdNS4MOTFyp" alt="" width="548"><figcaption></figcaption></figure></div>

Go back and double-check. If everything is okay, you should see this screen after pressing Next button (yellow warning):

<div align="left"><figure><img src="/files/wZwsVZayxaTjuyWgjV8V" alt="" width="545"><figcaption></figcaption></figure></div>

</details>

<details>

<summary><strong>"This number is already connected to an existing WABA"</strong></summary>

This error may occur when adding the number for migration in step 3 verification screen. A new WABA should be created anyhow. If you face issues, try using a dummy number. For further help, please [reach out to our Support team](broken://pages/K2ANPZzA0WYR6Z1M9aI7)&#x20;

</details>

<details>

<summary><strong>"Two-factor authentication not yet disabled"</strong></summary>

Before you can verify your phone number ownership you first need to disable two-factor authentication (2FA) for this number. This can be done either by you or by the Business Solution Provider, that is currently in charge of this number.

Please confirm that the 2FA was disabled before submitting the account for migration. [Check how.](#how-can-i-check-if-2fa-is-disabled-and-disable-it-in-case-its-not)

</details>

<details>

<summary><strong>"Register Name should be present and approved"</strong> </summary>

The[ Display Name](broken://pages/-Ma-XPwH2m-EpR0kTIzD) of the account [must be approved](#how-can-i-check-if-the-display-name-of-my-number-is-approved). Migration cannot be done until the Display Name is approved. In case disaply name approval is pending, you should wait until it's finnaly approved

</details>

<details>

<summary>"This phone number is eligible to be added directly, and does not need to be migrated. Please go to the 360Dialog Client Hub and add it as a new number"</summary>

This means that you should not use the migration form to register this number. [Please follow the process listed here](https://docs.360dialog.com/360-client-hub/the-360-client-hub#6-add-an-additional-number-to-an-existing-whatsapp-account)[ ](https://docs.360dialog.com/docs/account-management/the-360-client-hub/navigation#add-a-number)instead.

</details>

<details>

<summary>"The phone number you are trying to port has already been moved to your destination WhatsApp Account. Please log in to the 360dialog Client Hub to continue."</summary>

This means that the number is already available in 360Dialog. You can use the 360 Client Hub to manage it.

</details>

<details>

<summary>"The source and destination WhatsApp Business Accounts need to represent the same business. Please use the same Business ID as before when submitting the number for migration."</summary>

This means that the Meta Business ID sent in the form is not the same ID that currently manages this account. Please check the Business Manager and/or the old BSP dashboard to confirm which Business ID manages this WhatsApp account.

[Click here to understand more about the WhatsApp accounts and IDs.](broken://pages/FOD3gVLTmuOuZ3K8bEvl)

</details>

<details>

<summary>"Something went wrong when trying to migrate your phone number. Please try again after some time. If that does not work, please contact our support via the 360Dialog Client Hub."</summary>

This means that an unexpected error occurred. Please [reach out to our Support team](broken://pages/K2ANPZzA0WYR6Z1M9aI7) with the information about this number and account so we can investigate accordingly.

</details>

## FAQ

<details>

<summary>How can I check if my number is able to receive PIN Code via SMS or Voice Call?</summary>

Try to call it from an international number and/or send an SMS to it. If you are not able to receive the call/SMS, you may have troubles verifying the phone during the migration process.

Please reach out to your phone number provider to get help.

</details>

<details>

<summary>How can I check if my Meta Business Account is verified?</summary>

Go to the [Business Security Center](https://business.facebook.com/settings/security) and ensure the status is **"** :white\_check\_mark: **Verified"** for you organization.

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

If it's not, [check here how to verify your Account](broken://pages/-MHGDy3N7xA2Fk1diVl2).

</details>

<details>

<summary>How can I check if my WhatsApp Business Account (WABA) is approved?</summary>

Go to your [WhatsApp Business account](https://business.facebook.com/latest/settings/whatsapp_account), and ensure the Account status is **"**:green\_circle: **Approved".**

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

</details>

<details>

<summary>How can I check if 2FA is disabled?</summary>

Go to your WhatsApp Manager > Account Tools > Select the phone number > Settings > Two-step verification. You will see if it is enabled or not.&#x20;

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

</details>

<details>

<summary>How can I check if my WhatsApp Business Account (WABA) has a valid payment method attached?</summary>

Go to your [WhatsApp Business account](https://business.facebook.com/latest/settings/whatsapp_account) , and the payment method should appear on the bottom-right side.

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

</details>

<details>

<summary>How can I check if the display name of my number is approved?</summary>

Go to your [phone number settings inside WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/phone_numbers), click on the phone number you want to migrate and see the *Profile* details

<figure><img src="/files/9RLgOKLwVq9wol5UsFyk" alt=""><figcaption></figcaption></figure>

</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/partner/partner-hub/migrating-phone-numbers/migrating-existing-waba.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.