Skip to main content

WhatsApp Business API Number Migration to edna

Last updated: 30 March 2026

Migrating a WhatsApp Business API number involves transferring it between Business Solution Providers (BSPs) while retaining the phone number. During the process, the number is unlinked from the current BSP and connected to edna via the embedded sign-up process for registering a WhatsApp Business account.

tip

edna is an official Meta BSP partner that helps businesses connect to the WhatsApp Business API quickly and reliably. developers.facebook.com

info

After migration, the number and its quality remain unchanged; only the technical infrastructure — BSP, API, billing and integrations — changes. There is no need to manually delete the number from the previous BSP.

What is transferred during a WhatsApp Business API number migration​

Transferred

  • Phone number
  • Display name
  • Number limits and quality
  • WhatsApp Business official account status (exceptions may apply)
  • Registered high-quality templates (GREEN)

Not transferred

  • Chat history
  • Statistics and analytics
  • Integration and webhook settings
  • Low-quality templates
  • Rejected or pending templates

How to Migrate a WhatsApp Business API Number to edna​

tip

We recommend:

  • Schedule the migration during a period of low traffic.
  • Notify customers of possible brief service interruptions.
  • Back up critical data outside of WhatsApp.

Step 1. Ensure compliance with requirements and note the limitations​

  • On the Facebook website, you have access to an active and verified company business portfolio where your current WhatsApp Business account is linked. business.facebook.com

  • You have administrator rights to manage the business portfolio.

  • Your WhatsApp Business account and display name are approved.

  • The WhatsApp Business API number is active and can receive international calls or SMS messages.

  • Two-factor authentication is disabled for the WhatsApp Business API number in WhatsApp Manager.

    How to disable two-factor authentication
    warning

    Only users with administrator access can disable this feature. www.facebook.com

    1. Log in to Meta Business Manager and select the desired business portfolio. business.facebook.com

    2. Go to the Accounts → WhatsApp accounts section, select the WhatsApp account for which you want to disable two-factor authentication, and click WhatsApp Manager.

    3. In the Account management tools → Phone numbers section, click the icon in the phone number row.

    4. In the Two-factor authentication section, click Disable Two-factor authentication and confirm the action.

    5. In the email you receive, click the link to complete the disabling process.

warning
  • You cannot send messages during the migration.
  • There may be a brief period of downtime, usually lasting no more than one minute.
  • To verify your number, you must receive a one-time password via an international call or SMS.

Step 2. Prepare for the migration​

  1. Schedule a downtime period and time for reconfiguring the integration.
  2. Verify access to the company’s business portfolio on Facebook. business.facebook.com
  3. Prepare a phone number for verification via an international call or SMS.

Step 3. Fill out the form in your edna Pulse account​

  1. Go to the Channels section.
  2. Click Add Channel and select WhatsApp.
  3. Follow the instructions to fill out the channel form. File IconHow to Connect a WhatsApp Channel

Step 4. Register a WhatsApp Business account​

warning

In this step, the phone number will be unlinked from your current BSP and migrated to edna.

  1. After filling out the form in your edna Pulse account, click Continue with Facebook.

  2. Switch to or log in to the desired Facebook account.

  3. Click Continue to grant edna permission to manage your WhatsApp Business account.

  4. Select the company’s business portfolio and click Next:

    • Business Portfolio — select the company’s business portfolio.

      tip

      The business portfolio must be linked to the BSP from which the migration to edna is being performed.

    • WhatsApp Business Account — select this option to create a new WhatsApp Business account.

  5. Enter your company information and click Next.

  6. Add the phone number you want to migrate to edna.

    warning

    A warning will appear stating that the entered number is already linked to another BSP.

    tip

    Continuing with registration will transfer the number to a new WhatsApp Business account, and edna will become your new BSP.

  7. Enter your WhatsApp Business display name, select a verification method, and click Next.

    tip

    Make sure the specified number can receive international phone calls or SMS messages. The recommended method for verifying the number is a phone call.

  8. Verify the number using the selected method and click Next.

  9. Click Finish to save the settings.

Step 5. Specify post-migration settings and verify functionality​

  1. Go to the Integration → Settings section in your edna Pulse account.

  2. Generate a new API key and configure the webhook URL to receive incoming messages.

    File IconSpecifying API Settings

  3. Update the edna Pulse integration API on your side.

  4. Go to the Integration → Testing section in your edna Pulse account and verify that messages are being sent and received.

    tip

    Make sure the message was received on the added device.

    File IconTesting WhatsApp Channel API

  5. Go to the Analytics → Messages section and make sure the test message you sent is displayed there.

    File IconHow to View and Download Message Report
warning

Sometimes the migration may not complete on the first attempt. If errors occur, contact your personal edna manager.

FAQ​

Will my chat history be lost during migration?

Yes, chat history is not transferred.

Do I need to delete my number with my old provider?

No, the number is automatically unlinked from the previous BSP during the migration process.

How long does migration take?

Migration can take anywhere from a few minutes to two weeks. In most cases, the process is completed in a few minutes.

Will the service be unavailable?

Yes, the number may be temporarily unavailable during migration.

Will message templates be transferred?

Yes, only templates with an active status and a high quality rating (GREEN) will be transferred.

Will the number quality or limits change?

No, the number's quality and limits will remain unchanged.

Can the migration be canceled?

No, once the migration is complete, cancellation is not possible and a new migration will be required to revert.

Troubleshooting​

I'm not receiving the one-time password to verify my number
  • Make sure your number can receive international calls or SMS messages.
  • Try a different verification method (e.g., a phone call instead of an SMS).
  • Check that the number isn’t blocked by your carrier.
  • Make sure the IVR is configured correctly, if used.
Error during registration
  • Verify that you have administrator rights in the business portfolio.
  • Log out and log back into your Meta account.
  • Try using a different browser or clearing your cache.
Messages are not being sent after migration
  • Make sure the API integration is up to date.
  • Check the status of message templates.
Incoming messages are not arriving
  • Verify that the webhook URL is correct.
  • Make sure the webhook is accessible and responding to requests.
tip

If you cannot resolve the issue, contact edna support.