StoreIVR
  • Introduction
  • Channels
    • Channels Overview
  • WhatsApp
    • Business API
    • Prerequisites
    • Message Templates
    • Conversations
    • Capacity, Quality Rating, and Messaging Limits
    • QR Codes
    • Official Business Account (OBA)
    • Meta CloudAPI - Developer App
    • Migration: BSP to CloudAPI
  • SMS
    • Overview
    • 🇮🇳DLT for India 🇮🇳
      • Principal Entity [PE] Registration
      • Header / Sender ID
      • Consent Template
      • Message Template
    • 🇮🇳TFSC [2-Way] 🇮🇳
      • MO [User Initiated]
      • MT [Business Initiated]
    • 🌐TFSC - FTEU
      • 🇦🇺Australia 🇦🇺
      • 🇨🇩Congo 🇨🇩
      • 🇮🇩Indonesia 🇮🇩
      • 🇺🇬Uganda 🇺🇬
    • 🇺🇸10-DLC for the USA 🇺🇸
  • eMail
    • Overview
  • Voice
    • Overview
Powered by GitBook
On this page
  • BASIC CHECKLIST
  • Create a Meta Developer App
  • Setup Payment Method
  • Start the Migration
  • Disable Two-step verification
  • Initiate Phone Migration
  • WABA-ID of the destination WABA
  • Verify Phone Ownership
  • Select SMS of VOICE to receive your code
  • To verify the code received
  • Register Phone
  • Register the Phone Number to your WABA
  • Troubleshoot
  • Verify if App is Subscribed
  • Override Callback URL

Was this helpful?

  1. WhatsApp

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.

PreviousMeta CloudAPI - Developer AppNextOverview

Last updated 2 years ago

Was this helpful?

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

-

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.

Setup Payment Method

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

          • Select the Business Account

          • [ Payment Settings ]

            • [ Add payment method ]

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

Start the Migration

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.

Embedded Signup

You will need to access the Meta Business Manager.

          • 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

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

Initiate Phone Migration

WABA-ID of the destination WABA

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

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

{
    "success": true
}

Verify the Code

To verify the code received

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

Headers

Name
Type
Description

Authorization*

Bearer

Access Token

Request Body

Name
Type
Description

code*

NUM

{
    "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

{
  "success": true
}

Troubleshoot

Verify if App is Subscribed

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

Override Callback URL

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

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

We have created a quick collection.

1

2

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

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

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

6-digit registration code received after making the call.

6-digit registration code received after making the call.

Meta CloudAPI - Developer App
Business Manager
Business Settings
Accounts
WhatsApp Business Accounts
Postman Collection
Business Manager
Business Settings
Accounts
WhatsApp Business Accounts
Business Manager > Business Settings > Accounts > WhatsApp Business Accounts
Create Developer App
Setup Payment Method
Disable Two-step verification
Initiate Phone Migration
Request Phone Pin
Verify Phone Pin
Register Phone
Request the Code
language codes
Request the Code
Request the Code
Postman Collection is based on this Offical Guide
Offical Guide | Disable Two-step verification
Offical Guide | Step 1: Initiate Phone Migration
Run in Postman
Migrate Phone Number - WhatsApp Business Management API - Documentation - Facebook for DevelopersFacebook for Developers
Two-Step Verification - WhatsApp Business Platform On-Premises API - Documentation - Meta for DevelopersMeta for Developers
Migrate Phone Number - WhatsApp Business Management API - Documentation - Meta for DevelopersMeta for Developers
Registration - WhatsApp Business Platform Cloud API - Documentation - Meta for DevelopersMeta for Developers
Offical Guide | Register Phone
Postman
[POST] Register Phone
Postman
Get All Subscriptions for a WABA
Logo
Logo
Logo
Logo
Postman
Override Callback URL
Logo
Migrate Phone Number - WhatsApp Business Management API - Documentation - Meta for DevelopersMeta for Developers
Official Guide | Step 2: Verify Phone Ownership
Migrate Phone Number - WhatsApp Business Management API - Documentation - Meta for DevelopersMeta for Developers
Offical Guide | Scroll to Verify Code section
Logo
Logo
Logo
Logo
Postman
[POST] Request Verification Code
Postman
[POST] Verify Code
Postman
[POST] Initiate Phone Migration
Logo
View of WhatsApp Manager showing Two-step verification is already disabled.
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
Confirmation Link
Business Manager's eMail will receive the Link. |
Learn more
Logo
Logo