For the complete documentation index, see llms.txt. This page is also available as Markdown.

Migrate a number to 360Dialog

This document explains how to migrate a number to 360Dialog from another BSP or directly from Meta.

How to migrate a phone number

Migration is initiated using Embedded Signup.

2fa must be disabled on the existing WABA before initiating the migration using the Embedded Signup.

1

Login / Create an account

Businesses working with a 360dialog Partner must follow the Partner process to launch the Embedded Signup. Businesses that integrate directly with 360dialog / without a Partner must log in or create an account.

2

About your number

When confirming the status of the number, select option "Yes, this number is connected to the WhatsApp Business API".

This indicates that the number is already registered to the WhatsApp Business Platform with an alternate BSP.

3

Start Embedded Signup

Click Start Embedded Signup to launch the Embedded Signup flow hosted by Meta.

4

Login

Login to a Facebook user account with admin permissions for the Meta Business Portfolio.

5

Select the Business Portfolio

Select the target Business Portfolio to which the phone number will be migrated.

6

Create a new WABA

Select the option to create a new WhatsApp Business Account. It is required to create a new WABA so the 360dialog Credit Line can be set.

7

Select an existing WhatsApp profile

Create or select a WhatsApp profile

8

Trigger OTP

Enter the phone number to be migrated and OTP.

9

Enter OTP

Received the OTP using SMS or Voice, enter the code to confirm the migration.

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. 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 from Meta Business manager > WhatsApp Manager > Phone Number

"Register Name should be present and approved"

The Display Name of the account must be 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 and ensure the status is " Verified" for you organization.

If it's not, check here how to verify your Account.

How can I check if my WhatsApp Business Account (WABA) is approved?

Go to your WhatsApp Business account , and ensure the Account status is "🟢 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 , 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, 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 to resolve the error.

Last updated

Was this helpful?