Migration: BSP to CloudAPI

If you want to migrate from an existing Business Service Provider (BSP) to Meta's CloudAPI, without losing your display name, sending limit & approved templates.

Considering you have a Meta Developer account and a Verified Meta Business

Migrated
Not Migrated

Any High quality message templates previously approved

Low quality, rejected, or pending message templates.

Display name

-

Quality rating

-

Messaging limits

-

Official Business Account status

-

LogoMigrate Phone Number - WhatsApp Business Management API - Documentation - Facebook for DevelopersFacebook for Developers
Postman Collection is based on this Offical Guide

BASIC CHECKLIST

Create a Meta Developer App

Please follow the steps enlisted in the below-mentioned article. In case you have already done a valid app, you can choose to skip this step.

Meta CloudAPI - Developer App

Setup Payment Method

Make sure you have a payment method associated with the WABA.

https://business.facebook.com/billing_hub/payment_settings?asset_id=&business_id=<Business-ID>

Start the Migration

You can use Terminal or CMD. To make it easy, we have created a Postman Collection.

We have created a quick Run in Postman collection.

Edit the Collection's Variables before running the endpoints.

Disable Two-step verification

You can skip this if your Phone Number already had Two-step verification disabled.

View of WhatsApp Manager showing Two-step verification is already disabled.

Embedded Signup

You will need to access the Meta Business Manager.

  • Business Manager

    • Business Settings

      • 1 Accounts

        • 2 WhatsApp Business Accounts

          • 3 Select the Business Account

          • 4 Settings

          • 5 WhatsApp Manager

            • 6 Select the WhatsApp Account

              • 7 Account Tools

              • 8 Phone numbers

              • Settings (Gear Icon)

                • 10 Two-step verification

                • 11 [ Turn off two-step verification ]

                  • 11.a Verify the eMail and click [ Ok ]

                • 12 An eMail will be sent to the Business Manager's eMail.

                  • 13 Click on the [ TURN OFF TWO-STEP VERIFICATION ]

https://business.facebook.com/wa/manage/phone-numbers/?business_id=<Business-ID>&phone_number=&waba_id=&childRoute=PHONE_PROFILE%2FRECOVERY

WhatsApp Manager
Open WhatsApp Manager of exiting BSP WABA / On-Premise WABA
WhatsApp Overview | Select the WhatsApp Account
Turn Off 'Two-step verification' of exiting BSP WABA / On-Premise WABA
Business Manager's eMail will receive the Link. | Learn more
Confirmation Link

BSP Classic Signup / -or- / Self-Hosted On-Premise

LogoTwo-Step Verification - WhatsApp Business Platform On-Premises API - Documentation - Meta for DevelopersMeta for Developers
Offical Guide | Disable Two-step verification

Initiate Phone Migration

WABA-ID of the destination WABA

POST https://graph.facebook.com/{{Version}}/{{WABA-ID}}/phone_numbers

To find the ID of a WhatsApp Business Account, go to Business Manager > Business Settings > Accounts > WhatsApp Business Accounts. Find the account you want to use and click on it. A panel opens, with information about the account, including the ID.

Headers

Name
Type
Description

Authorization*

Bearer

Access Token

Request Body

Name
Type
Description

cc*

NUM

Numerical country code for the phone number being registered.

phone_number*

NUM

Phone number being migrated, without the country code or plus symbol (+).

migrate_phone_number*

Boolmen

To migrate a phone number, set this to true.

{
  "id": "<Phone-Number-ID>"
}

Verify Phone Ownership

Request the Code

Select SMS of VOICE to receive your code

POST https://graph.facebook.com/{{Version}}/{{Phone-Number-ID}}/request_code

Now that you have requested the migration, you need to confirm it by verifying ownership of the phone number.

Headers

Name
Type
Description

Authorization*

Bearer

Access Token

Request Body

Name
Type
Description

code_method*

ENUM

Method of receiving the registration code. Supported values: SMS and VOICE.

language*

ENUM

Language in which you want to receive the registration code. See language codes.

{
    "success": true
}

Verify the Code

To verify the code received

POST https://graph.facebook.com/{{Version}}/{{Phone-Number-ID}}/verify_code

The code (6-digit pin) received from the previous Request the Code step is to be used to verify the ownership.

Headers

Name
Type
Description

Authorization*

Bearer

Access Token

Request Body

Name
Type
Description

code*

NUM

6-digit registration code received after making the Request the Code call.

{
    "success": true
}

Register Phone

Register the Phone Number to your WABA

POST https://graph.facebook.com/{{Version}}/{{Phone-Number-ID}}/register

You need to register the phone number you want to use to send messages.

Headers

Name
Type
Description

Authorization*

Bearer

Access Token

Request Body

Name
Type
Description

messaging_product*

ENUM

Messaging service used. In this case, use "whatsapp".

pin*

NUM

6-digit registration code received after making the Request the Code call.

{
  "success": true
}

Troubleshoot

Verify if App is Subscribed

Make sure your Meta Developer App ID is listed in your WABA.

LogoPostman
Get All Subscriptions for a WABA

Override Callback URL

In case you are not receiving messages to your chat interface, you can choose to override the Callback URL.

LogoPostman
Override Callback URL
PreviousMeta CloudAPI - Developer AppNextOverview

Last updated

Was this helpful?