> 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-business-solution-provider-bsp.md).

# Migrate WhatsApp Business API number from another Business Solution Provider (BSP)

If you are using WhatsApp Business API (WABA) with another BSP, and you would like to setup WABA in Omnichat with the same phone number that has been registered with another BSP, you can follow the below guide to migrate the phone number to Stella.

Before you start the migration, please note that:

* **There will be minimal downtime when deploying the number to our server.**
* Migrated phone numbers keep their display name, quality rating, messaging limits, Official Business Account status (Green Tick), and any High quality message templates previously approved.
* Chats from the previous BSP will not be migrated to Omnichat.
* For more information, please refer to Meta's [guide](https://developers.facebook.com/docs/whatsapp/business-management-api/guides/migrate-phone-to-different-waba/) here.

## Requirement for Migration

<table data-header-hidden><thead><tr><th width="279.53787367947854">Asset</th><th>Requirement for Migration</th></tr></thead><tbody><tr><td>Asset</td><td>Requirement for Migration</td></tr><tr><td>Phone number</td><td><strong>1.</strong> Must be currently registered with the source WABA.<br><strong>2.</strong> If two-factor authentication was ever enabled for this number,<br>it needs to be disabled. This means that the source WABA owner<br>must <strong>disable the two-factor 6-digit pin that was previously set</strong>.<br>The phone number's owner is responsible for reaching out to the<br>source WABA's owner.</td></tr><tr><td>Source WABA</td><td><strong>1.</strong> Must have Business Verification completed and approved.<br><strong>2.</strong> WABA’s review status must be Approved.</td></tr><tr><td>Destination WABA</td><td><strong>1.</strong> Must have Business Verification completed and approved.<br><strong>2.</strong> WABA’s review status must be Approved.</td></tr></tbody></table>

{% hint style="danger" %}

#### For d**isabling the two-factor** authenticatio&#x6E;**,** Please ask your existing BSP to follow the steps from the following link [**https://developers.facebook.com/docs/whatsapp/api/settings/two-factor#disable**](https://developers.facebook.com/docs/whatsapp/api/settings/two-factor#disable)

{% endhint %}

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F5nYIC4wIEVrZPlcCkbQs%2F2FV-2%20\(1\).png?alt=media\&token=35d7bae8-0f82-40de-930d-73308be842e7)

## Create a New WABA

In order to complete the migration, you need to first create a new WABA account with Omnichat as the destinated WABA account to transfer the phone number. If all the requirements are fulfilled, please follow the steps below to proceed with migration.

### **1.** Login to Omnichat Platform and create the WABA setup with embedded sign-up : [`https://app.omnichat.ai/integration.html`](https://app.omnichat.ai/integration.html)

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FQYhP1X6yxiKx9UCIg42A%2Fwhatsapp-setup-1.png?alt=media\&token=0da6d347-4f9f-4ba6-8aa9-990f024dc8ec)

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FF3WjDNahrduMdS55FsU7%2Fwhatsapp-setup-2.png?alt=media\&token=7f08ce4d-87e7-4bef-ad21-d3f03faeff29)

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FmL2KDUdmJeWg0irH5stn%2Fwhatsapp-setup-3.png?alt=media\&token=0e28f1e1-7dbd-47e1-9b2b-edf3381652bb)

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Ff8zb5voVK3ti3MhaDQhK%2Fwhatsapp-setup-4.png?alt=media\&token=ca9541ba-6203-4ac3-bee9-f17663b871b2)

### 2. Select your existing Facebook Business Manager. and create a new WABA account.

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fc0rKTqcBCbnR91fe7si6%2Fwhatsapp-setup-5.png?alt=media\&token=435176c3-8ade-4d2c-8ab9-91d354e1451f)

### 3. Create a new WABA account. (Please input your WhatsApp Business Account Name, better to use the same Name as your existing WhatsApp Business Account Name)

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FrjZhhf9LnM0im7NtK63I%2Fwhatsapp-setup-6.png?alt=media\&token=926f8ee2-619e-45c8-aa42-64d11d9d7b10)

![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F91iZJqXe5pJdiu27IdSi%2Fwhatsapp-setup-8.png?alt=media\&token=219584ab-652d-460d-915c-7f849526e3bf)

{% hint style="danger" %}

#### Stop here, *DO NOT Press Continue to Step 2 and Close the Facebook window*

{% endhint %}

### 4. Go back to Omnichat Admin Portal, click “Refresh” button at the top right corner of the “Shared WhatsApp Business Account” section, you should be able to see the newly created WABA account under the “Shared WhatsApp Business Account” section. Then send the WABA ID with your WhatsApp Phone Number to Omnichat team.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fgy9js6amOehpNuye8UDx%2F%E6%88%AA%E5%9C%96%202023-03-29%20%E4%B8%8B%E5%8D%8810.21.01.png?alt=media&amp;token=ad34069c-e654-41a1-b8b6-6a258cbc5b0f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FkNFD6RsQkIqY7qozwCp7%2F%E6%88%AA%E5%9C%96%202023-03-29%20%E4%B8%8B%E5%8D%889.58.12.png?alt=media&amp;token=a69d0643-b28f-42b0-a6a7-75815cae812b" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

1. **When WABA account migration is completed, please complete Facebook business account verification within 30 days. The verification process can be done via the security center of Facebook Business Manager.**
2. **Before obtaining Meta Business Verification for your WABA account, there is a limit of**[ **250 business-initiated messages**](https://developers.facebook.com/docs/whatsapp/messaging-limits/) **within a 24-hour period. After completing the migration process, template messages created on the previous provider cannot be transferred to Omnichat, requiring a re-submission of the application for those messages.**
   {% endhint %}