This topic explains how to perform a number migration in ChatAPP Message Service.
Usage notes
Downtime
Your source WABA can continue to send and receive messages during the migration without service interruption, ensuring zero downtime. After the migration is complete, you can immediately use the destination WABA to send messages.
Message templates
All high-quality message templates in the source WABA are copied and automatically approved in the destination WABA. Existing message templates in the destination WABA are not affected. Low-quality, rejected, or pending templates are not copied.
Billing
The source business is charged for messages that are sent before migration.
The source business is also charged for messages that are sent from the source but not delivered before migration.
Migrated content
The following content in the source WABA is migrated to the destination WABA:
Display name
Quality rating
Message limit
Official Business Account (OBA)
Approved high-quality message templates
Limits
-
Test business phone numbers issued by WhatsApp cannot be migrated.
You cannot migrate messages and chat history.
You cannot migrate multiple API operations at one time.
Before you begin
Asset | Requirements |
Phone number | 1. Phone numbers that are migrated must be currently registered with the source WABA. 2. If two-factor authentication, namely, two-step verification, has been enabled for the phone number, you must disable the authentication first. |
Source WABA | 1. The source WABA must complete the service authentication and pass the authentication. 2. The review status of the source WABA must be approved. |
Destination WABA | 1. The destination WABA must complete the service authentication and pass the authentication. 2. The review status of the destination WABA must be approved. |
Procedure
-
Log in to the ChatAPP Message Service console and click WABA onboarding.
Click register.
If the registration page does not open, check your browser settings to ensure pop-ups are not blocked.
Log on to your Facebook account.
ImportantDo not create a new account.
Click Get Started.
Click Continue.
In this step, you grant WhatsApp Business Account access (to add phone numbers, create message templates, and send messages) and Billing management permissions to Alibaba Cloud Singapore.
-
In Step 1 of 3, select the Meta Business Account that contains the number you want to migrate, and then click Continue.
-
Select 'Create new WhatsApp Business account', enter an account name, and click Continue. This creates the WABA.
Close the page to complete the embedded signup after you register a new WABA.
ImportantDo not proceed to Step 2 after you register a new WABA.
After you complete the above procedures, you have successfully created a WABA.
-
Open Meta Business Manager.
In the left navigation pane, click Accounts > WhatsApp accounts. Select the destination WhatsApp account, and then find the account ID (the WABA ID) in the details pane.
Check whether the service authentication and WABA verification have been approved, and whether the payment method has been specified.
-
After confirming all items are approved, return to the WABA onboarding page in the ChatAPP Message Service console and click the Number migration button on the right side of the page.
A table at the bottom of the page displays information about your registered WABA, including columns for WABA ID, Account name, Currency, Message template namespace, and Binding status. Confirm that the Binding status for the corresponding account is Bound.
Follow the instructions on the page to perform subsequent operations.
Read the notes on the page and click Next.
The notes will indicate that if two-factor authentication is enabled for the number you are migrating, you must disable it first.
-
On the start migration page, fill in the basic information and verify that key fields, such as the New WABA ID and its value, are correct.
New WABA ID: Make sure that the ID of the newly registered WABA is correct.
Click Next.
On the Start migration dialog box, enter the ID of the destination WABA and check the information.
The migration page displays fields for 'Country/region code' and 'Number to migrate'.
Country/Region code: Enter the country or region code of the phone number to migrate. Example: 86.
Number to migrate: Enter the phone number to migrate. Example: 130********.
Click Next.
On the Obtain verification code dialog box, set the parameters as needed.
Number to migrate: Check whether the phone number is correct.
Method to obtain the verification code: Select the method in which you want to receive the verification code. If the phone number to migrate is the landline, set this parameter to Voice.
Language: Select the language in which the verification code message is written or in which the voice call is made.
After you check all parameters, click Receive verification code. You will receive a verification code message or voice call from Facebook.
On the Submit verification code dialog box, enter the verification code and start the migration.
Verification code: Enter the verification code provided by Facebook.
It may take several minutes to obtain the verification code. If you do not receive the verification code and do not need to change the method to obtain the code, click Not received and send again to obtain the verification code again.
If you want to change the method to obtain the verification code, click Back and change the method to return to the previous step and change the method.
Click Start migration. After the verification code is confirmed, the migration starts.
Wait for the migration result. Do not close or refresh the page before the migration is complete.
After the migration is complete, you are informed of the migration result. The migration is complete.
Click Close Page to finish.
After the migration
After the migration is complete, if your destination WABA is an OBA or you have completed two-step verification, go to Facebook Business Manager and enable the two-step verification again. This ensures the security of your account and retains the OBA status.