Migrate WhatsApp Business API number from another Facebook Business Manager (FBM)

If you are unable to proceed using the existing WhatsApp Business API number integration method, please refer to the approach outlined in this document.

Usage Background

1. Currently, can not find the one with full access role to log in to Facebook Business Manager（FBM）. However, an admin role is required to log in and grant authorization for using the MM Lite API.

2. The WhatsApp account payment method has not been correctly set to Omnichat.

3. Coexistence WABA need to change to new FBM

Step 1: Turn off two-step verification

Turn off two-step verification from the WhatsApp accounts under original FBM

You will receive an email titled “Two-Step Verification Reset” in your personal Facebook email inbox. Please open the email and click the link to proceed with the verification process.

Step 2 : Connect the number to the new WABA under target FBM

Through embeded signup flow, connect the number to the new WABA under target FBM

You can select an existing WABA (or create a new one) to connect the phone number.

Scenario 1:

If a message with a yellow background is displayed, it indicates that migration can be performed.

Scenario 2:

If it is highlighted in red, it means the migration cannot be proceeded. You'll need to delete the phone number from the original FBM first (refer to the steps here). If you do not have the permissions to access that FBM, you cannot proceed the following steps. Please help contact the one with the access of original FBM to delete the number.

If it can be migrated, then you can proceed.

Step 3: Select the Phone Number to connect to the Omnichat Backend

Click "Connect Phone Number" to connect the WhatsApp number displayed in the pop-up window to the Omnichat backend.

Supplement for Scenario 2: Deleting the original WhatsApp phone number from the Meta Business Manager (FBM)

If a red error prompt appears during the embedded signup flow stating, "To use this number, please disconnect it from the existing account," you must first return to the original FBM and delete that phone number. Only after doing so can you proceed to complete the integration.