How to migrate a phone number to a different WABA?

If you would like to use the same phone number with another WABA, you could request a phone migration to our Support team. (This only applies for migrating the phone number from another BSP to Stella)

Please note we could only migrate the number to a different WABA if both source and destination WABA use the same Facebook Business Manager.

Before You Start

To be eligible for migration, the business must meet the following criteria:

Asset	Requirements for Migration
Phone number	Must be currently registered with the source WABA. If two-factor authentication was ever enabled for this number, it needs to be disabled. This means that the source WABA owner must disable the two-factor 6-digit pin that was previously set. The phone number's owner is responsible for reaching out to the source WABA's owner.
Source WABA	Must have Business Verification completed and approved. WABA’s review status must be Approved.
Destination WABA	Must have Business Verification completed and approved. WABA’s review status must be Approved.

If all the requirements are fulfilled, please find the migration procedure below:

1. Start the WABA setup with embedded sign-up in the channel.

2. Select the existing Facebook Business Manager account (which was used to create the source WABA) and create a new WABA account.

3. Once the WABA account has been set up, please DO NOT continue to step 2 in the following screenshot.

4. Go to WhatsApp manager at https://business.facebook.com/settings/whatsapp-business-accounts/ to get the new WABA ID

5. Submit a ticket to Stella Support with the new WABA ID and the phone number to migrate the number from another BSP to our new WABA

6. Our support will arrange a time with you to receive SMS/voice call for verification during migration
7. You can continue the embedded sign up flow and select the number for deployment

**Please note the phone number will still be in use until it is connected with the new WABA, therefore there is no need to unsubscribe from the BSP before the migration. The number will be disconnected automatically from the old WABA once you have successfully deployed the number if you are using embedded signup (step 7).

1. There will be minimal downtime when deploying the number to our server
   
2. All the logs/conversations will be lost, they will not migrate to the new server
   
3. The Offical Business Account (green check) will transfer together with the phone number

• Related Articles

• Can we migrate the same phone number to another FBM?

  Currently, WhatsApp does not support migrating the phone number to another WABA if they are from a different Facebook Business Manager. It is advised to get an entirely new number to register to the new FBM with the embedded signup. 

• I have a smartphone with the phone number assigned to WABA. Do I have to keep this device connected or online? Does WhatsApp check that the line is active? Can I switch off the device and have the Stella chatbot still work?

  If you have registered a phone number with WABA (WhatsApp Business API) in Stella, there is no need for the use of a device as there is no interface for WABA. Also, if you have registered a phone number with WABA. that number could not be used on any ...

• Why is the phone number on Stella slightly different than the phone number I first registered?

  WhatsApp may automatically add country codes to numbers of certain countries. Please see the related documentation here.

• What is the phone number limit for a WABA?

  By default, you can register 25 phone numbers per WhatsApp Business Account.

• Will the WhatsApp Offical Business Account (green check) also migrate to the new WABA?

  Yes, the Offical Business Account (green check) will transfer together with the phone number. Please note if two-factor authentication was ever enabled for this number, it needs to be disabled before the migration. For more details about two-factor ...