Migrate WhatsApp Phone Numbers

Prev Next

Migrating WhatsApp Business phone numbers involves associating them with a WhatsApp Business Account (WABA) under a BSP's Business Manager ID. You can have multiple WABAs, but to link them with a Business Solution Provider (BSP), the phone numbers must be migrated to the BSP's WABA accounts. 

Because Insider One is one of the official Business Service Providers, when you migrate WhatsApp phone numbers to Insider One's WhatsApp Account, you can have the following benefits that might differ according to your package:

  • Template creation in InOne,

  • WhatsApp Conversational Commerce,

  • WhatsApp Live and AI conversation.

This guide covers the following concepts:

How to migrate a WhatsApp phone number

The Embedded Signup itself is not enough to migrate a WhatsApp Phone Number. You also need to follow a few steps to migrate your phone number easily. 

Before migrating a phone number, ensure that:

- You have a WhatsApp phone number that is currently active and reachable.

- Your phone number can receive an SMS or a call.

- You have your Meta Business Manager ID.

- You remove 2FA (Two-Factor Authentication) from your WhatsApp phone number if you have enabled it.
- If your current BSP has data localization (local storage) enabled for the phone number, you must request the provider to de-register this setting via Meta before starting the migration. Insider does not support local storage. If this setting remains enabled, the migration will fail. Refer to Meta’s guide for further information on de-registering.

When a business is migrated from another BSP, migration is possible if your existing WABA and the new WABA to be created under Insider One are both under the same Business Portfolio on your side. Template migration requires additional action; in this case, Insider One recommends creating a task for the Insider One team.

Refer to Meta’s guide for further details on template migration.

Important: Insider One doesn’t recommend migrating old templates. Insider One's proprietary advanced click tracking (CTA-based) structure will not be present in previously created templates. If migrated templates are used, click tracking will not function correctly for those templates. For this reason, we advise you to create new templates on the Insider One platform instead of migrating existing ones.

After you meet the prerequisites, your Facebook Business Manager Admin needs to complete the steps below:

  1. Navigate to Inone > Campaigns > Messaging > WhatsApp > Settings.

  1. Click the +Integrate Account button.

  1. Select the Migrate Account option as your integration method and click Next to proceed.

  2. A pop-up will appear to continue on your Meta Business account. Click Continue to move on to the next steps.

  3. Choose your verified Meta Business account. Then, create your new WhatsApp Business Account. After selecting the business portfolio, choose "Create New Account" for both dropdown fields and click Next.

If you want to add multiple phone numbers to the same panel, ensure that you select the same WhatsApp Business Account (WABA) for all added numbers. Refer to the Multi-Number Support on a Single Panel for WhatsApp for further information.

  1. Select "Add a New Number" from the dropdown and receive the OTP code.

  2. After reviewing your information, click Confirm.

  3. Your account is now connected to Insider One. You will be redirected to Insider One's InOne panel.

Here you go! You have easily migrated your WhatsApp phone number.

MM API registration

Marketing Messages API (MM API) is a new WhatsApp API introduced by Meta after the Cloud API. Designed for direct marketing use cases, MM API offers a simplified integration experience, improved deliverability performance, and a focus on enhancing customer engagement. It helps businesses achieve results equal to or better than those obtained through the Cloud API, especially in high-volume message delivery scenarios.


MM API registration is the final step of the WhatsApp migration process.

For further information on MM API, refer to Meta's guide.

Once the migration is complete, follow these steps to register your WhatsApp number with the MM API.


To complete the MM API registration, you must have Admin access in your Meta Business Manager. This is the same level of access required during the initial WhatsApp integration.

  1. Navigate to WhatsApp > Settings > Integration. Click the Register Now button. 

  2. Click the Continue button.

  3. In the new page, scroll down and enable the “Improve marketing message performance by sharing Cloud API events” toggle. Click Continue to proceed. 

  4. Click the Get Started button. 

  5. Make sure to select the business that your WABA is linked to, then click Next.

  6.  Click Continue.

  7. Click Finish to finalize the registration. 

  8. Congratulations! You have completed the Marketing Message API registration.

Integration vs Migration: Key differences for WhatsApp registration

The table below outlines the key differences between Integration and Migration methods for registering WhatsApp, helping you choose the right approach based on your setup.

Integration

Migration

Purpose

To create a new WhatsApp Business Account from scratch.

To migrate an existing WhatsApp phone number to Insider One.

Use Case

Ideal for new businesses or adding numbers to a current account.

Suitable for businesses transitioning from another BSP to Insider One.

Initial Requirements

You do not need an existing WhatsApp Business Account. Purchase the phone number before starting the integration. The integration option is enabled by default, and no additional requirements apply.      

An existing WhatsApp phone number that is already in use. The phone number must be reachable for OTP.

You must have Admin access to the Facebook Business Account.

Please contact the Insider One team to enable the migration option.

Steps Involved

If you don’t have a Business Account, you can create one during the process or select an existing Business Account to add a new number.

The current Business Account must be selected, but creating a new WhatsApp Business Account is still required.