UCal
  • Welcome
  • 🚀Getting Started
    • Quick Start
      • What is IS-Messenger?
      • Setting Up an Account
      • Connecting Channels
      • Inviting Your Teammates
      • Getting Contacts to Message You
      • Automated Welcome and Away Messages
      • Responding to Messages
      • Glossary of Terms
    • Connecting a Channel
    • Invite your teammates
    • Getting Contacts to Message You
    • Automated Welcome and Away Messages
    • Responding to messages
    • Glossary of Terms
    • Creating a Chatbot
  • ⚙️Workspace Modules
    • Dashboard
    • Inbox
      • Inbox Overview
      • Assignment and closing a conversations
      • Custom Inboxes
      • Interacting with Respond AI Prompts
      • Using AI Assist
    • Contacts
      • Contact Details
      • Contacts Overview
      • Merge Suggestions
      • Contact Activity
      • Contact Channels
      • Contact Import
      • Segments
    • Broadcast
      • Broadcast Overview
      • Managing Broadcasts
    • Workflow
      • Triggers
      • Workflow Step
        • Step: Send a Message
        • Step: Ask a Question
        • Step: Assign To
        • Step: Branch
        • Step: Update Contact Tag
        • Step: Update Contact Field
        • Step: Open Conversation
        • Step: Close Conversation
        • Step: Add Comment
        • Step: Jump To
        • Step: Wait
        • Step: Date & Time
        • Step: HTTP Request
        • Step: Trigger Another Workflow
        • Step: Add Google Sheets Row
        • Step: AI Agent
      • Workflow Templates
    • Reports
      • Reports: Conversations
      • Reports: Responses
      • Reports: Resolutions
      • Reports: Messages
      • Reports: Contacts
      • Reports: Assignments
      • Reports: Leaderboard
      • Reports: Users
      • Reports: Broadcasts
  • ⚙️Workspace Setting
    • Managing a Workspace
    • General
    • Users
      • Access Levels
    • Teams
    • Channels
      • Chat Menus
    • Contact Fields
    • Growth Widgets
      • Website Chat Widget Quick Start
      • Website Chat Widget Overview
      • Workspace Settings: Growth Widgets
      • Install Website Chat Widget on Squarespace
      • Install Website Chat Widget on Joomla
      • Install Website Chat Widget on Wix
      • Install Website Chat Widget on Shopify
      • Install Website Chat Widget on WordPress
      • How to Track Conversation Source from Multiple Websites
    • Respond AI
    • Integrations
      • Dialogflow
        • Dialogflow: Connecting to Dialogflow
        • Dialogflow: Creating a Chatbot
        • Dialogflow : Managing Intents
        • Dialogflow: Parameters
        • Dialogflow: Events
        • Dialogflow: Response Templates
        • Dialogflow: Custom Payloads
        • Dialogflow: Fulfillment Webhook Request
      • E-Commerce & CRM Integrations
        • E-Commerce Integration: Shopify
        • E-Commerce Integration: BigCommerce
        • E-Commerce Integration: WooCommerce
        • E-Commerce Integration: Magento
        • CRM Integration: HubSpot
        • CRM Integration: Salesforce
        • CRM Integration: Pipedrive
        • CRM Integration: ActiveCampaign
      • Zapier
      • Developer API
      • Webhooks
      • Make (formerly Integromat)
    • Closing Notes
    • Snippets
    • Files
    • Data Export
    • Data Import
  • ⚙️User Account
  • Profile
  • User Activity Status
  • Notifications
  • Resetting your Passwords
  • 👨‍👧‍👦CONTACT AND MESSAGES
    • Dynamic Variables
      • Dynamic Variables Overview
      • How to Use Dynamic Variables
    • Contact Search and Custom Inbox
    • Conversations
  • ⚙️MESSAGING CHANNELS
    • Channel Overview
    • Facebook Messenger
      • Facebook Messenger Quick Start
      • Facebook Chat Plugin
      • Private Replies
      • Message Tag
    • Instagram
      • Instagram Overview
      • Instagram Quick Start
    • WhatsApp
      • WhatsApp Business API Quick Start
      • Getting Ready for Inbound Conversations
      • Getting Ready for Promotional Messaging
      • WhatsApp Official Business Account (Green Tick)
      • Grow your WhatsApp Audience by Maximizing Entry Points
      • Get WhatsApp API Account for Government Agencies
      • Meta Business Verification
      • WhatsApp Message Templates
      • WhatsApp Pricing
      • WhatsApp Business Platform (API) Channel Configuration
      • WhatsApp Messaging Limits
      • Meta Product Catalog
      • Change Your WhatsApp Business Display Name
      • Phone Number Migration to IS-Messenger WhatsApp Business API
      • Turn-off WhatsApp Number Two-Step Verification
      • WhatsApp Cloud API
        • Migrating from On-Premises API to Cloud API
        • Migrating from Cloud API to On-Premises API
        • Set up the WhatsApp Echo Bot
        • Load Testing on Cloud API
        • Experiments
        • Webhooks Setup
      • 360Dialog WhatsApp
      • Twillio WhatsApp
      • MessageBird WhatsApp
      • Vonage WhatsApp
      • Phone Number Migration to WhatsApp Cloud API
    • Website Chat Widget
      • Install on WordPress
      • Install on Shopify
      • Install on Wix
      • Install on Squarespace
      • Install Website Chat Widget on Joomla
    • LINE
      • LINE Overview
      • LINE Quick Start
    • Telegram
      • Telegram Overview
      • Telegram Quick Start
    • Viber
      • Viber Overview
      • Viber Quick Start
    • SMS Overview
      • Twilio SMS Quick Start
        • Importing Contacts to Twilio SMS
      • MessageBird SMS Quick Start
      • Vonage SMS Quick Start
    • Twitter Overview
      • Twitter Quick Start
    • WeChat
      • WeChat Overview
      • WeChat Quick Start
    • Google Business Message
    • Email
      • Google Workspace Quick Start
      • Other Email
    • Custom Channel
      • Custom Channel Overview
      • Custom Channel Quick Start
  • New Release Update
  • Support Use Cases
    • How to Identify Contacts by Email and Phone NumberI
    • How to Enrich Customer Data from a CRM or other Business Software
    • How to Route Customers to the Right Team Automatically
    • How to Auto-Assign Customers to a Team or Dedicated Agent
    • How to Send Outbound Support Messages
    • Support: Closing Conversations
    • How to Supervise Your Support Agents
    • How to Analyze Reports for Support
    • How to Send CSAT to Customer and Save Data in Google Sheets or CRMs
  • Handling Inbound Conversations
    • Managing Spam
    • Create Automated Welcome and Away Messages
    • Get Contacts’ Consent for Personal Data Collection
    • Create Automated Chat Menus
    • Collect Contacts’ Emails and Phone Numbers
    • Route Contacts by Shifts
    • Route Contacts by Team Functions
    • Route New & Returning Contacts
    • Route VIP Contacts
    • Assignment Strategy: Automatic Contact Distribution & Load Balancing
    • Assignment Strategy: Unassign Agents after Conversations Closed
  • Capture Conversations
    • How to Streamline Meeting Scheduling via CTC Ads
    • How to Automate Product Info Sharing in Conversations Initiated via CTC Ads
    • How to Track Conversation Source from Multiple Websites
    • How to Route Contacts from CTC Ads to Agents
  • Automate Conversations
    • How to Maximize Customer Service Potential with AI Agent
    • How to Automate Contact Information Collection with AI
    • How to Route Contacts to Preferred AI Agent
    • How to Automatically Qualify Contacts Based on Budget Using AI Agent
    • How to Route Contacts by their Preferred Language
    • How to Create Automated Chat Menus
    • Assignment Strategy: How to Automate Contact Distribution & Load Balancing
    • Assignment Strategy: Unassign Agents after Conversations Closed
    • How to Create Automated Welcome and Away Messages
    • How to Block Contacts and Manage Spam
    • How to Route New and Returning Contacts
    • How to Collect Contacts’ Emails and Phone Numbers
    • How to Route New and Returning Contacts
    • How to Route Contacts by Team Functions
    • How to Route Contacts by Shifts
    • How to Get Contacts’ Consent for Personal Data Collection
    • How to Route VIP Contacts
  • How to Promptly Transfer Conversation Between Agents
  • How to Guide Customers from Exploration to Purchase with Engaging Menus
  • How to Optimize Customer Onboarding with Automated & Customized Welcome Messages
  • Converse with Customers
    • How to Get a Complete View of the Customers
    • How to Simplify Customer Escalation with Automation
    • How to Transfer Contacts to the Next Shift Automatically
    • How to Optimize Agents’ Productivity in the Messages Module
    • How to Align AI Conversations with Your Brand Voice
    • How to Draft Customer Replies with AI
    • How to Convert Image to Text Using AI
    • How Automate Calculations Using AI
  • Broadcasts Use Cases
    • How to Sending a Simple Broadcast
    • How to Start a Workflow Based on Broadcast Response
    • How to Import to Broadcast via WhatsApp
    • How to Troubleshoot a Failed Broadcast
  • Sales Use Cases
    • How to Collect Leads' Email and Phone Number
    • How to Enrich Contact Data and Qualify Leads
    • How to Route Leads
    • How to Auto-Assign Leads to Sales Agents
    • How to Send Outbound Sales Messages
    • How to Track Productivity by Closing Conversations
    • How to Supervise Sales Agents
    • How to Analyze Reports for Sales
  • Accessing Help Menu
Powered by GitBook
On this page
  • Benefits of Migrating to WhatsApp Cloud API
  • What will be Migrated?
  • Pre-Migration Requirements: What to Prepare for Your Migration Setup
  • Configuring Phone Numbers and WABA IDs
  • API Documentation for the Migration Process
  • Step 1: Begin Phone Number Migration
  • Parameters
  • Step 2: Request for Code (PIN) to Verify Phone Ownership
  • Parameters
  • Step 3: Verify the Code
  • Parameters
  • Step 4: Register Phone Number
  • Step 5: Check the Migrated Phone Number in Meta Developer App
  1. MESSAGING CHANNELS
  2. WhatsApp

Phone Number Migration to WhatsApp Cloud API

PreviousVonage WhatsAppNextWebsite Chat Widget

Last updated 1 year ago

Benefits of Migrating to WhatsApp Cloud API

WhatsApp Cloud API is a new platform that offers businesses a direct connection to WhatsApp's infrastructure and it’s a self-service option as compared to going through WhatsApp partners (BSPs). Some benefits of using WhatsApp Cloud API are:

  • a more cost-effective option.

  • a more reliable and stable connection to the platform.

  • the ability to build custom integrations that fit your specific business needs.

  • a flexible and scalable solution for businesses of all sizes.

Learn more about .

What will be Migrated?

Note that the following elements can be migrated from the WhatsApp BSP to the WhatsApp Cloud API.

Can be migrated

  • Phone number associated with the account.

  • Any previously approved high-quality message templates.

  • Display name of the Phone number.

  • Quality rating of the Phone number.

  • Messaging limits.

  • Official WABA status.

Cannot be migrated

  • Low-quality, rejected, or pending message templates.

Pre-Migration Requirements: What to Prepare for Your Migration Setup

Take note of phrases that will be frequently used throughout this document: -Source WABA: The WhatsApp BSP from which we are migrating. -Destination WABA: The WhatsApp Cloud API to which we are migrating.

Pre-Migration Requirements Checklist:

  • Business ID: The Source and Destination WABAs must be associated with the same MBM or have the same business ID.

  • WABA Review Status: The review status of the Source and Destination WABAs must be approved.

  • Payment Method: A payment method must be configured for both the Source and Destination WABA. Ensure that the payment method is set up at both the source and the destination.

  • Two-Step Verification: Two-step verification must be disabled on the phone number being migrated.

When all of the above is checked and completed, the migration process can continue.

Configuring Phone Numbers and WABA IDs

Meta has designed the WABA IDs to not be migratable. Due to certain limitations, a workaround has been implemented as a solution. For migration of phone numbers to occur, both source and destination WABA IDs must be under the same Meta business manager account. This means that migrating a phone number will only result in the transfer of that number between WABAs and will not allow for any other changes. To successfully migrate a phone number, the following steps must be carried out:

  • Add a new number to the destination WABA: This will generate a new WABA ID for the number you wish to migrate to. You may skip this step if you have an existing WABA with a number that is no longer being used.

  • Delete the new number from the destination WABA: This will vacate a spot for a number to be added to the destination WABA. Alternatively, if you have an existing unused number, you can delete that number.

Once the number is deleted, proceed to migrate the customer's current number to the new WhatsApp business.

API Documentation for the Migration Process

It is important to note that currently, these migration steps outlined in the API documentation can only be executed by a developer or someone with a similar technical background. However, we understand that this can be a limitation for some and we are working towards developing a more user-friendly and accessible solution in the future. Need help? Contact Support

Step 1: Begin Phone Number Migration

Callback URL:

POST <https://graph.facebook.com/{version}/{wabaId}/phone_numbers>

Name

In

Required

Type

Description

version

path

True

string

The API version.

wabaId

path

True

string

The WhatsApp Cloud API WABA ID.

Parameters

Header

Authorization: Bearer {Access Token}

Body

Name

Type

Description

cc

num

Numerical country code for the phone number being registered.

note: Plus (+) sign is not needed for country code.

phone_number

num

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

migrate_phone_number

boolean

Set to true to migrate phone number.

Status

Name

Description

200 OK

Success.

Response

{
    "id": "phoneNumberId"
}

Step 2: Request for Code (PIN) to Verify Phone Ownership

Callback URL

POST <https://graph.facebook.com/{version}/{phoneNumberId}/request_code>

Name

In

Required

Type

Description

version

path

True

string

The API version.

phoneNumberId

path

True

string

This is the response returned in Step 1. Copy and Paste the number into the callback URL in this step.

Parameters

Header

Authorization: Bearer {Access Token}

Body

Name

Type

Description

code_method

enum

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

language

enum

Status

Name

Description

200 OK

Success.

Response

{
    "success": true
}

The code has been sent to the phone number that is being migrated via the selected method (SMS or Voice).

Step 3: Verify the Code

Callback URL

POST: <https://graph.facebook.com/{version}/{phoneNumberId}/verify_code>

The code (6-digit pin) received in the phone number from step 2 will be used to verify the ownership.

Parameters

Header

Authorization: Bearer {Access Token}

Body

Name

Type

Description

code

num

6-digit registration code received after completing Step 2.

Status

Name

Description

200 OK

Success.

Response

{
    "success": true
}

Confirms that the phone ownership is verified.

Step 4: Register Phone Number

Callback URL

POST <https://graph.facebook.com/{version}/{phoneNumberId}/register>

Parameters

Header

Authorization: Bearer {Access Token}

Body

Name

Type

Description

messaging_product

enum

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

pin

num

6-digit registration code received after Step 2.

Status

Name

Description

200 OK

Success.

Response

{
    "success": true
}

The phone number is successfully registered to the WhatsApp Cloud API WABA. You can now send messages to your destination WABA

WABA ID is not migrated. The newly migrated number will be associated with the WABA ID of the previously deleted number.

Step 5: Check the Migrated Phone Number in Meta Developer App

A successful migration can be verified through the Meta Developer App. To do this, follow these steps:

  1. Navigate to WhatsApp > Getting Started

  2. In the phone number dropdown list, confirm that the number is present and accurately reflected.

Existing Meta Developer App: If you do not have a developer app created, and get started with WhatsApp Cloud API. This app must be created under the same business account (business ID) as the source WABA.

Business Verification: The Business ID has to be verified. If your business is not yet verified, .

Go to to find the ID of a WhatsApp Business Account. Select the account you want to use. A panel with account information, including the ID will appear.

The System user generates your Access Token in the WhatsApp Business Accounts tab of the Business Manager. Read to learn how to access the system user and create or copy one.

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

⚙️
WhatsApp Cloud API here
click here to create your app in Meta Business Manager (MBM)
follow these steps to get it verified
Business Manager > Business Settings > Accounts > WhatsApp Business Accounts
this guide
language codes