Skip to main content

WABA Migration

This guide will show you how to migrate a phone number to another WABA account,

For the usual embedded sign up flow, please refer to here.

Migrate WABA number from another Business Solution Provider (BSP)

If you are using WABA with another BSP, and you would like to setup WABA in WOZTELL with the same phone number that has been registered with another BSP, you can follow the below guide to migrate the phone number to WOZTELL.

Before you start the migration, please note that:

  • There will be minimal downtime when deploying the number to our server.
  • All the logs/conversations will be lost, they will not be migrated to the new server.
  • The Official Business Account (Green Tick) will be transferred together with the phone number.

Requirement for Migration

AssetRequirement for Migration
Phone number1. Must be currently registered with the source WABA.
2. 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 WABA1. Must have Business Verification completed and approved.
2. WABAโ€™s review status must be Approved.
Destination WABA1. Must have Business Verification completed and approved.
2. WABAโ€™s review status must be Approved.
WABA Approved
WABA Approved

Create a New WABA

In order to complete the migration, you need to first create a new WABA account with WOZTELL as the designated WABA account to transfer the phone number. If all the requirements are fulfilled, please follow the steps below to proceed with migration.

  1. In Channels, select "+ New Channel".
Create WhatsApp Channel - 1
Create WhatsApp Channel - 1
  1. Enter a Channel Name; select the WhatsApp as the platform and Create.
Create WhatsApp Channel - 2
Create WhatsApp Channel - 2
  1. The channel is created. You can click on Start Setup to start setting up your WABA.
Create WhatsApp Channel - 3
Create WhatsApp Channel - 3
  1. The Embedded Sign-up will begin once you click "Start Setup". A Facebook window will pop up.
Create WhatsApp Channel - 3
Create WhatsApp Channel - 3
  1. You will be asked to log in your existing Facebook account. New Facebook Account will NOT be approved for Facebook Business Manager.
Log in Facebook Account
Log in Facebook Account
  1. Select Facebook Business Manager. and create a new WABA account.
Select Facebook Business Manager
Select Facebook Business Manager
  1. Create a new WABA account.
Create new WABA account
Create new WABA account
  1. Once the WABA account has been set up, please DO NOT continue to step 2 in the following screenshot.
WABA account created
WABA account created
  1. Head to WhatsApp Manager at to get the new WABA ID.
  1. Submit a Phone Migration Request to with the new WABA ID and the Phone Number to migrate the number from another BSP to our new WABA

  2. Our support will arrange a time with you to receive SMS/voice call for verification during migration. Then, 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 using embedded signup.

Migrate On-Premise WABA Number to Cloud API

Cloud API is a cloud-hosted version of WhatsApp Business API (WABA), which is currently in beta and only available to selected Business Service Providers (BSPs).

If you now using On-Premise WhatsApp Business API with Stella and would like to switch your WABA to Cloud API, please follow the guide below.


You will need to prepare the following items in order to perform the Cloud API migration:

  • An App and a WhatsApp Channel created at
  • The WABA was created with Embedded Signup Flow
  • The Two-factor Verification of the WABA has been disabled

If your WABA to be migrated was not created with embedded signup, you will first need a phone number migration to a new WABA account.

Please follow this guide to create a new WABA account and submit a Phone Migration Request to

Create Account in WOZTELL

  1. Visit and sign up.
  1. Create an organization name.
  1. Complete the email verification.
  1. Upon successful signup, head to Channels and select + New Channel.
  1. Enter a name and description (optional) for this channel. Then, select WhatsApp Cloud API and Create.

Submit Migration Request

  1. Once your WhatsApp channel is ready in WOZTELL, please submit a Cloud API Migration Request to and provide the following information in the email:
  • WABA Phone Number
  • Source Organization ID (The original app)
  • Source Channel ID (The original channel)
  • Destination Organization ID
  • Destination Channel ID
  1. WOZTELL support team will get back you with the Backup Data and a Backup Password. Once you have received them, please head click "Edit" to enter your WhatsApp channel.

Migration & Deployment

  1. Head to "Platform", select "Start Setup" to start the Embedded Sign-up.
  1. You will be asked to log in your existing Facebook account. New Facebook Account will NOT be approved for Facebook Business Manager.
  1. Once you have logged in your Facebook account, select "Get Started" to connect your Facebook account to WOZTELL. Then select "Continue" to share account and billing permissions with WOZTELL.
  1. In Step 1 of 3, select your existing Facebook Business Account.
  1. Then, select the corresponding WABA account.
  1. In Step 2 of 3, when you see the corresponding phone number, you DO NOT need to proceed. You can now close the Facebook pop-up window.
  1. Please wait patiently until the Platform page is refreshed.
  1. When you are brought to the "Deployment Page", please select the WABA Account, Phone Number and create a Registration Code. After that, please select "Migrate from On-Premise?".
  1. Enter the Backup Data and Backup Password, which have been provided by WOZTELL support team.
  1. Select "Migrate" to complete the migration and deployment of the WABA number. Please wait patience until the page is refreshed.
  1. Now your phone number has been successfully migrated to Cloud API!