Migrate a phone number - Chat App Message Service - Alibaba Cloud Documentation Center

You can migrate a phone number that has registered with another Business Solution Provider (BSP) to Alibaba Cloud. The following information about the migrated phone number will be retained: the display name of the enterprise to which the phone number belongs, quality rating, messaging limits, official business account status, and message templates that have been approved.

Procedure

Create a migration task for a phone number

For more information about how to migrate a phone number, see Migrate phone numbers to a different WABA. After you create a new WhatsApp Business account (WABA) and bind the WABA ID with the PID according to the description in the Embedded signup topic, you can call this operation to migrate a phone number.

Important

Before you start to migrate the phone number, make sure that the following prerequisites are met: The two-step verification for the phone number is disabled. The enterprise has passed the verification. The WABA is in the Approved state.

API reference

CreateChatappMigrationInitiate

Examples

Sample success responses in JSON format

{
  "RequestId": "90E63D28-E31D-1EB2-8939-A9486641****",
  "Code": "OK",
  "Message": "SUCCESS",
  "Data": {
    "PhoneNumber": "8613900001234",
    "Id": "82828893332",
    "Status": "MIGRATING"
  }
}

Obtain a verification code for phone number migration

You can call this operation to obtain a verification code.

A verification code is valid for 14 days. Before you call this operation, you can call the GetPhoneNumberVerificationStatus operation to check whether the phone number that you want to migrate has been verified. If the phone number has been verified, you do not need to call this operation. Otherwise, you can call this operation to obtain a verification code.

API reference

GetMigrationVerifyCode

Examples

Sample success responses in JSON format

{
  "RequestId": "90E63D28-E31D-1EB2-8939-A948664****",
  "Code": "OK",
  "Message": "None",
  "Data": {
    "PhoneNumber": "8613800001234",
    "Id": "82828893332"
  }
}

Verify a specified phone number for migration

You can call this operation to verify a specified phone number for migration.

API reference

ChatappMigrationVerified

Examples

Sample success responses in JSON format

{
  "RequestId": "90E63D28-E31D-1EB2-8939-A9486641****",
  "Code": "OK",
  "Message": "SUCCESS",
  "Data": {
    "PhoneNumber": "8613800001234",
    "Id": "82828893332"
  }
}

Register a phone number for migration

You can call this operation to register a phone number for migration.

After the phone number is registered, the phone number will be migrated from the source WABA to the destination WABA, and all the original approved templates will be migrated to the destination WABA.

API reference

ChatappMigrationRegister

Examples

Sample success responses in JSON format

{
  "RequestId": "90E63D28-E31D-1EB2-8939-A9486641****",
  "Code": "OK",
  "Message": "SUCCESS"
}