Phone Number Migration Guide

Migration path from a WhatsApp for Business app to the WhatsApp for Business API

WhatsApp officially offers a migration path from the WhatsApp for Business App to the WhatsApp for Business API, which works like a charm. Here is a peek into how we tackled it.

Please note that this is a report based on our experience, in rare individual cases we have also experienced failed migrations. The risk of a successful migration is borne solely by the brand and the decision is made solely by WhatsApp. Also be mindful of the fact that there is no way back to the Business Client, following an upgrade. Your former WhatsApp Business Client can not be used afterwards.

In short: what's the official migration path?

WhatsApp for Business -> WhatsApp for Business API:

  1. First of you need to get your display name approved. Your WhatsApp Business Solution Provider can do this while setting up your WhatsApp Business Account in Facebook Business Manager. This step is essential to create a certificate, otherwise, the WhatsApp Business API client will not work.

  2. It is possible to keep the phone number that is already registered in your WhatsApp Business application. However, it is required to delete the old account associated with that phone number and then triggering the WhatsApp for Business API registration process. The migration of your phone number is described here. While you are migrating your number all incoming messages will be queued by WhatsApp servers and delivered after a successful migration. attention icon From here there is no way back; existing chats (history) cannot be imported once the number has been moved to the API; profile settings need to be reconfigured. Your former WhatsApp Business Client can not be used afterwards.

  3. The number is now on the WhatsApp Business API. All numbers set up for the WhatsApp for Business API need to remain with the Business Service Provider that originally implemented the number. There is currently no way to move the number to another Business Service Provider.

The upgrade to WhatsApp Business API is now complete. ✓

Any more questions?

Can I use a phone number that is already on WhatsApp?

If that phone number has not been used on WhatsApp Business API, you can use that phone number. Follow the migration steps outlined here to reuse that phone number.

I have uninstalled WhatsApp - can I start the process?

It doesn't matter if the number was in use or is currently in use. If you have access to these numbers, try this before attempting to register with the Business API.

  1. Take a consumer device (ios/android) and install the consumer app

  2. Use it to register the numbers you have. As it's a landline, select voice.

  3. Once registered, delete the account using the app -> At this stage, the number should have been removed from any existing registrations.

  4. Use WhatsApp for Business API to register the number, and select voice again.

Will I loose data?

Deleting the WhatsApp account on your Android or iPhone will cause any incoming messages to be queued by the WhatsApp servers and then subsequently delivered upon successful registration.

Can I import my backup using the WhatsApp for Business API?

There is currently no option to import previous conversations.

Can I migrate my number from another Business Solution Provider (BSP)?

A number migration from a BSP to another BSP is NOT possible.

Is there an extra fee for the number migration?

The number migration is a time-consuming process. Please check with your customer success manager to see if there is an extra fee for the migration.

Will the migration affect Official Business Approval?

Official Business Approval is only available for selected WhatsApp for Business API clients. It's not affected by the migration, but once the number has been upgraded to the WhatsApp for Business API it's possible to request the OBA-status.