Migrate number from Meta or alternate BSP to 360dialog Cloud API
Bring your WhatApp Business API Number to 360dialog!
Last updated
Was this helpful?
Bring your WhatApp Business API Number to 360dialog!
Last updated
Was this helpful?
We have changed the migration flow to make it simpler. Now, after going through the , you can directly go through the normal "Add number" flow.
Number migration means that a phone number that is already registered for the WhatsApp Business API can be moved between WhatsApp Business Accounts.
This allows for businesses to change BSPs (Business Solution Provider) or move their number to a new account. It is possible to migrate a number between accounts only if the source and destination Business Manager IDs are the same.
After being migrated, a phone number keeps its display name, , , , and any message templates previously approved
Display name
Quality Rating
Messaging Limits
Official Business Account status
Uploaded Media
Approved high quality message templates
Low quality, rejected, or pending message templates
Catalogs
Message and chat history
Template Messages and chat history migration
Only the high quality message templates are migrated on this process. In practice, they are copied to the destination WABA. These templates do not need to go through review again and can be sent immediately.
Low quality, rejected, or pending templates are not migrated. Any existing message templates in the destination WABA will not be overwritten.
Message and chat history are not migrated with this process.
Billing Migration
Messages sent before migration are charged to the source BSP. Messages sent after migration are charged to the destination BSP. Messages sent from the source, and that are not delivered before migration, are still charged to the source BSP when they get delivered.
Official Business Accounts (Blue Badge)
Official Business Accounts (OBAs) can be migrated between WABAs. The only requirement is that the two-factor authentication needs to be disabled during the migration process. It can be re-enabled after the number is migrated.
Before migrating a number, it's important to go through the following checklist:
You must have Admin Access to Meta Business Manager
You are migrating the number from another BSP
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.
When adding a new number, if you see this screen (red warning): It means that one of the above checks are not fulfilled.
Go back and double check. If everything is okay, you should see this screen after pressing Next button (yellow warning):
If you are working with a 360dialog's Partner, use their normal add number process.
Your number should be available within the next 5 mins, you will receive an email notification.
Here are some common errors and solutions that you might encounter during the migration process.
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.
This means that the number is already available in 360dialog. You can use the 360 Client Hub to manage it.
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.
Yes
Yes
Yes
Yes
Yes
Yes
No
No
No
Ensure the phone number you want to migrate is able to receive and verify a 6 Digit PIN Code through SMS or Voice Call (ensure you can receive international calls).
Your Meta Business Account is verified.
The existing WhatsApp Business Account (WABA) must be approved.
The Display Name is approved.
Your existing WABA must have a valid payment method attached (in Payment Settings).
Two-Factor Verification (2FA) must be disabled for the number.
Extra step for Brazilian numbers: Check in your current WhatsApp profile if the number registered has the extra 9 or not. When migrating the number, it should look exactly the same as the current profile.
If you want to integrate directly with 360dialog's API, .
Otherwise, please reach out to our Support Team through the Support Widget
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
Please confirm that the 2FA was disabled before submitting the account for migration.
The of the account . 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
This means that you should not use the migration form to register this number. instead.
This means that an unexpected error occurred. Please with the information about this number and account so we can investigate accordingly.
Go to the and ensure the status is " Verified" for you organization.
If it's not, .
Go to your , and ensure the Account status is " Approved".
Go to your , click on the phone number you want to migrate and see the Tw-steps verification details
Go to your , and the payment method should appear on the bottom-right side.
Go to your , click on the phone number you want to migrate and see the Profile details