> 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/migrations/migrate-a-number-to-360dialog.md). # Migrate a number to 360Dialog ## **How to migrate a phone number** Migration is initiated using Embedded Signup. ### Checklist Before migrating a number, please ensure the following checklist is completed: * [ ] The number can receive and verify a 6-digit PIN via SMS or voice call, and it can accept international calls. * [ ] The user performing the migration must have the required access to the Meta Business Portfolio or WhatsApp Asset. * [ ] The source Meta Business Portfolio is verified. * [ ] The source WhatsApp Business Account (WABA) is approved. * [ ] The Display Name is approved. * [ ] Two-Factor Verification (2FA) is disabled for the number. * [ ] The business website is live and accessible. Meta may verify the website listed in Meta Business Suite > Business Info, and if it is incorrect or inactive, the account could be taken offline following the number migration. ### Process {% stepper %} {% step %} #### Log in to 360dialog Please [log in](https://app.360dialog.com/) to your 360dialog account. If you don't have an account, you can create one [here](https://login.360dialog.io/u/signup?state=hqFo2SBYYVpfcU1Pck1vTUFXZTQ5MGY5YlJ4YXNvaTFtVWY2V6Fur3VuaXZlcnNhbC1sb2dpbqN0aWTZIGJNMndmSnpNNEFQX3E0QXQyNUNRSVNwTmNkSXZYdEM0o2NpZNkgcUhTQ05hdkVUVW9PQk5pS3MyVjV6d1Z1cWs4OVNGN1qlb3JnaWS0b3JnX2dZSDVqa0dDVkxueGltb3Onb3JnbmFtZbtpbml0aWFsX3NpZ251cF9vcmdhbml6YXRpb24). > If you work with the integration partner, please start from their app. > {% endstep %} {% step %} #### Click **Add number** On the numbers page, click **Add number** {% 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 %} {% endstep %} {% step %} #### Select a Pricing Plan Select the desired pricing plan and click Continue {% hint style="info" %} Applicable for the direct-payment model. In the partner payment model, this step is skipped. {% endhint %} {% endstep %} {% step %} ### Add payment method (if applicable) Direct payment clients need to have a valid payment method. They can create it during the onboarding. For clients for whom this step is not relevant, it is skipped. (E.g., partner payment model or already created payment method) {% endstep %} {% step %} ### Enter phone number Please enter the phone number and click Next {% endstep %} {% step %} ### Info about the number Please select the correct option. Migration flow is triggered when the option **Yes, Business API** is chosen.
{% endstep %} {% step %} ### Complete the requirements questions To successfully migrate the number, all requirements must be met, so the answer to all the questions must be **yes**. If not, please follow this [flow](/docs/hub/migrations.md#limitations).
{% endstep %} {% step %} ### Launch Embedded Signup Click on the Embedded Signup Button. Review and accept the terms provided by Meta by clicking **Continue** {% endstep %} {% step %} #### Select Business Assets Select the Meta Business Portfolio to which the phone number will be migrated.
{% endstep %} {% step %} ### Add Number Please add the existing number. You will see this note:
{% endstep %} {% step %} ### Trigger OTP Choose between a text message and a phone call. {% hint style="warning" %} **Expected Migration Message** When migrating a phone number to 360dialog, the message should be returned in the Embedded Signup: 'This number is registered to an existing WhatsApp Business account or another Business Solution Provider'. {% endhint %} {% endstep %} {% step %} ### Enter OTP Received the OTP using SMS or Voice, enter the code to confirm the migration. {% endstep %} {% step %} ### Connecting your account This may take a few moments. Please don´t close the screen. {% endstep %} {% step %} ### Finish the Embedded Signup Once the number is successfully onboarded, you can finish the Embedded Signup by clicking Finish. {% endstep %} {% step %} ### The number is connected The embedded Signup window will be automatically closed, and you will be redirected back to the 360Dialog Hub or to the partner application. {% endstep %} {% endstepper %} Troubleshooting Here are some common errors and solutions that you might encounter during the migration process:
This number is registered to an existing WhatsApp Account. This means that the WhatsApp number was not registered with the WhatsApp Business Platform previously and is registered with a standard WhatsApp consumer App / WhatsApp Messenger. Therefore, it is not required to do the migration flow. \ \ Solution: Open the standard WhatsApp consumer app / WhatsApp Messenger on mobile and [delete the associated account](https://faq.whatsapp.com/2138577903196467/?cms_platform=android). Then it will be possible to register the number for the WhatsApp Business Platform.
"Two-factor authentication not yet disabled" Before migrating a phone number, two-factor authentication (2FA) must be disabled on the existing WABA. 2FA [must be disabled](/docs/resources/phone-numbers/2fa.md) from Meta Business manager > WhatsApp Manager > Phone Number
"Register Name should be present and approved" The[ Display Name](/docs/resources/phone-numbers/display-names.md) of the account [must be approved](#how-can-i-check-if-the-display-name-of-my-number-is-approved). Phone numbers cannot be migarted if the Display Name is not approved. In case display name approval is pending, wait until it's approved or contact support.
"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" This means that you should not use the migration form to register this number.
"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." This means that the number is already available in 360Dialog.
"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." This means that an unexpected error occurred. Contact our support team so we can investigate accordingly.
## FAQ
How can I check if my number is able to receive PIN Code via SMS or Voice Call? 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.
How can I check if my Meta Business Account is verified? Go to the [Business Security Center](https://business.facebook.com/settings/security) and ensure the status is **"** :white\_check\_mark: **Verified"** for you organization.
If it's not, [check here how to verify your Account](broken://pages/-MHGDy3N7xA2Fk1diVl2).
How can I check if my WhatsApp Business Account (WABA) is approved? Go to your [WhatsApp Business account](https://business.facebook.com/latest/settings/whatsapp_account) , and ensure the Account status is **"**:green\_circle: **Approved".**
How can I check if 2FA is disabled? Go to your WhatsApp Manager > Account Tools > Select the phone number > Settings > Two-step verification. You will see if it is enabled or not.
How can I check if my WhatsApp Business Account (WABA) has a valid payment method attached? 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.
How can I check if the display name of my number is approved? 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
How can I migrate a COEX number from another BSP to 360dialog? If your business customer worked with a partner in the past and still shares the previous credit line, they may see an error when attempting to switch to a new partner. Follow the [guide](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/business-customer-support#switch-partners-and-remove-previous-line-of-credit) to resolve the error.
--- # 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/migrations/migrate-a-number-to-360dialog.md?ask=&goal= ``` `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.