> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/tong-xun-qu-dao/integrations/whatsapp-business-api-zheng-he-dao-omnichat/migrate-whatsapp-business-api-number-from-another-facebook-business-manager-fbm.md).

# 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.

{% hint style="info" %}

### 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/overview).
2. The WhatsApp account payment method has not been correctly set to Omnichat.
3. Coexistence WABA need to change to new FBM
   {% endhint %}

#### Step 1: Turn off two-step verification

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

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F0BoUTnCdugIgKuWIdAon%2Fimage.png?alt=media&amp;token=f3b7cc17-0388-410f-a9d4-d9a639c6d642" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FFjh6mTwQeShsSmVVVNoW%2Fimage.png?alt=media&amp;token=6a5bed36-82c8-42fb-82dd-ba4407c6e590" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FhvFJESwjoBY4gEfiiyM1%2Fimage.png?alt=media&amp;token=98741c19-bd8f-4d26-8d79-3f5c40f77c8d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FJ74VAxQH09NQkIapd60g%2Fimage.png?alt=media&amp;token=866890de-dfec-4c0d-a321-869b4efa7792" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FXRYmbU4qboXPnoQuW3wV%2Fimage.png?alt=media&amp;token=ce54fb86-f2ab-4e09-adb1-4774726f9e52" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FW1QNZl9xARFr9nrh9qW5%2Fimage.png?alt=media&amp;token=79be2157-d3d3-406c-87c3-fbff97d3aa98" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fg8oMiaYqV63rAs63VXQC%2Fimage.png?alt=media&amp;token=0823cd53-3e80-42f0-81e0-0d4ba8de84d5" alt=""><figcaption></figcaption></figure>

#### 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

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FJfNua0cb0nBCjl6Cdpyd%2Fimage.png?alt=media&amp;token=8a9ee843-d018-4b88-a122-c19b0b612319" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FJLSyC5y3fVMMEeJQEYPS%2Fimage.png?alt=media&amp;token=324a6924-0cb3-4d84-a6e9-ddb5257b9f3a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can select an existing WABA (or create a new one) to connect the phone number.
{% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FBZySaynA1KqVGpfZ5BgZ%2Fimage.png?alt=media&amp;token=c457cfcb-5233-4568-9c53-d1245d9175c9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F0IX4Hizk6ne9Rhhqc23O%2Fimage.png?alt=media&amp;token=4b22d610-8bc8-4243-b430-9831c2cce7fa" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FfXQKr1KckLjKadNBMzmC%2Fimage.png?alt=media&amp;token=21f41182-1a00-4cc3-833c-754a3d2d7d1b" alt=""><figcaption></figcaption></figure>

{% columns %}
{% column %}
Scenario 1:

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

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FUVyQXpKWPEoLCjiZZrGc%2Fimage.png?alt=media&amp;token=c3b5d3f0-503a-4ccb-9990-66e58cface54" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Scenario 2:

If it is highlighted in red, it means the migration cannot be proceeded. <mark style="color:$danger;">You'll need to delete the phone number from the original FBM first (refer to the steps</mark> [<mark style="color:$danger;">here</mark>](#supplement-for-scenario-2-deleting-the-original-whatsapp-phone-number-from-the-meta-business-manager)<mark style="color:$danger;">). 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.</mark>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FvZsgsCAOpG0pjm6rvCXH%2Fimage.png?alt=media&amp;token=dbdfcfe8-58d2-4ab6-9e3e-9e1852e80500" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

If it can be migrated, then you can proceed.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FcY6HFRy3CFcnkZy5GcrJ%2Fimage.png?alt=media&amp;token=017244fb-d044-48d2-93a4-46c91338dbf7" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FPUiWRhAXJnBJUZf4NqVW%2Fimage.png?alt=media&amp;token=5a6a4fa3-a41f-4bd4-bd07-5dc83908641e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FiUTtEMjlsNI6M3R6q2DG%2Fimage.png?alt=media&amp;token=3d0fef6b-c9b2-4837-b807-efef77434ba5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F4XUkYzkmKVMGqBMbBDMd%2Fimage.png?alt=media&amp;token=f80c4aba-9ece-42f6-9b2e-7d6f27ba70e3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FYrUyjPSDF8yhEa983tJX%2Fimage.png?alt=media&amp;token=eb9810b9-7e40-4ca0-8d68-7d5dca170867" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F82WSgkdARi7olaxpeUcC%2Fimage.png?alt=media&amp;token=e9bd01c9-8694-4a66-8fd2-543f87e59306" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fsz9DRfp0JcXJqUo5azSl%2Fimage.png?alt=media&amp;token=66b78950-17c5-4eb5-a9bb-5c337090de65" alt=""><figcaption></figcaption></figure>