How to Port Numbers on WhatsApp API

1. Step by Step

2. FAQ

The number portability process is a procedure designed by Meta that allows an active number with a BSP (Business Solution Provider) to be linked to another BSP. Before we begin, it is important to understand that:

• Origin BSP: Provider where the number is currently active.

• Destination BSP: Provider where the number will be activated.

Before You Start

For this process to be carried out, the following essential points and requirements are crucial:

• Have access to the same Business Manager (BM) where the number was activated with the Origin BSP, with administrator permission.

• Two-factor authentication disabled.

• That the number in question can receive SMS or an international voice call.

• Approved display name.

ATTENTION! The display name approval must be done with the Origin BSP. The Destination BSP cannot handle the procedures to approve and update the number.

Step by Step

After creating the WABA, the Destination BSP is responsible for carrying out the number migration process to the new setup. Follow the steps and logical guidelines below:

1. Remove Authentication: Ensure that the Origin BSP has removed two-factor authentication from the number or disable it yourself if you have access.

2. Display Name Approval: Validate the display name with the Origin BSP.

3. Create the WABA: Use the administrator access of the Business Manager (BM) to proceed with creating the new account.

4. Data Preservation: When migrating the number, verify that the following information remains the same and has been copied to the new WABA:

   • Number quality

   • Official account badge

   • Support tier

   • Display name

   • Approved templates (which are copied to the new WABA)

FAQ

What is the role of the Origin BSP in number portability?

The Origin BSP is responsible for removing two-factor authentication from the number. After this removal, the remaining steps can be completed by the client and the Destination BSP. Additionally, they are responsible for supporting the display name approval.

What is the role of the Destination BSP?

The Destination BSP is responsible for assisting with the number portability and ensuring it works in the new setup, as well as supporting any questions and access issues.

How do I disable two-factor authentication?

You can request the removal of authentication from the BSP where the number is activated or, if you have access to the WABA, you can perform the process yourself. To access the instructions provided by Meta, click here.

I no longer have access to the Business Manager, what should I do?

The BSP does not have access to your Business Manager; they only have access to the WABA. In this case, you need to inform the Destination BSP (where the number will be migrated) so they can assist you with the situation.

Is it possible to migrate a number that is operating on Cloud API?

Yes. With Meta’s updates, it is no longer necessary for the number to be migrated to On-Premises to carry out the portability process. To learn about the number activation process after portability, click here and here to learn about the migration process between Cloud and On-Premises.

Where can I find all the official information from Meta?

All information about the process can be found by accessing Meta’s official documentation: Migrate Phone Number - WhatsApp Business Management API - Documentation - Meta for Developers.

Need more help? Explore our content at Blip Academy or Blip Community, watch tutorials on our YouTube channel, or ask your questions in our support channel 😃