# Migrating WhatsApp Business from another provider (BSP)

### Overview <a href="#id-01g4jvggabpdj7s7w3f6mk2p59" id="id-01g4jvggabpdj7s7w3f6mk2p59"></a>

The migration process means that a phone number that is already registered in the WhatsApp Business API can be moved between WhatsApp Business API accounts. This allows for businesses to change BSP's (Business Solution Provider) or move their number to a new account, **but only if the source and destination Facebook Business Manager IDs are the same**. After being migrated, a phone number keeps its display name, quality rating, messaging limits, Official Business Account status, and any quality message templates previously approved as soon as they do not exceed the maximum capacity of templates per WABA (250 max).

### What Is / Isn't Migrated in the process? <a href="#id-01g4jvggabqfddq6fb0apry3ds" id="id-01g4jvggabqfddq6fb0apry3ds"></a>

Here is a summary:

<figure><img src="https://675349995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJNEE9TMK4fU91VKstBr%2Fuploads%2Fgit-blob-456ae21ec0e47ed93c9e32ff07ea5709c4fa7608%2FMigration_chart.png?alt=media" alt=""><figcaption></figcaption></figure>

**Template Messages and chat history migration** Only the high-quality message templates are migrated on this process. In practice, they are copied to the destination WABA. These templates do not need to go through review again and can be sent immediately. Low quality, rejected, or pending templates are not migrated. Any existing message templates in the destination WABA will not be overwritten. Messages and chat history are not migrated with this process.&#x20;

**Billing Migration** Messages sent before migration are charged to the source BSP. Messages sent after migration are charged to the destination BSP. Messages sent from the source that are not delivered before migration are still charged to the source BSP when they get delivered.&#x20;

**Official Business Accounts (Green Badge)** Official Business Accounts (OBA's) can be migrated between WABA's. The only requirement is that the two-factor authentication requires to be disabled during the migration process. It can be re-enabled after the number is migrated.

### Prerequisites for Migration <a href="#id-01g4jvggab36vvgt5ae308k0vj" id="id-01g4jvggab36vvgt5ae308k0vj"></a>

*These prerequisites are mandatory for MessageBird Support to have prior to you submitting your migration request.* If any information is missing, please find it before submitting it to MessageBird Support. Partial or incomplete information cannot be sent and may extend the time, or cancel the request altogether for the migration.

### Requirements for phone numbers to be migrated to MessageBird: <a href="#id-01g4jvggab12dbzjs1cbcbdg4q" id="id-01g4jvggab12dbzjs1cbcbdg4q"></a>

* You must have physical access to be able to receive and verify a 6 Digit PIN code through SMS or Voice Call per every number to be migrated.
* The WhatsApp Business Account connected to the number to be ported must be [**verified**](https://www.facebook.com/business/help/1095661473946872?id=180505742745347) by Facebook. Accounts and numbers in "Sandboxed" mode cannot be migrated.

*Please keep in mind, Facebook rules state that the BSP cannot refuse or delay the disablement of 2FA or the porting process at all. If this is an issue, please reach out to Facebook directly from your Facebook Business Manager.*

### Preparation checklist <a href="#id-01g4jvggacf97bk1fkam9mg77q" id="id-01g4jvggacf97bk1fkam9mg77q"></a>

Before migrating a number, it's important to go through the following checklist:

1. **Do I know which Facebook Business Manager ID owns this account?** Please note that this requires to be the Facebook Business Manager ID of the Business Manager that is the owner of the account. If the Business Manager only has access to it but is not the owner, the migration will not work.[ You can understand how to discover this Facebook Business ID **here**](https://www.facebook.com/business/help/1181250022022158?id=180505742745347)**.**
2. **Do I have admin access to the Facebook Business Manager that owns this account?**
3. **Is the Facebook Business Manager**[ **verified**](https://www.facebook.com/business/help/1095661473946872?id=180505742745347)**?**
4. **Do I have access to this phone number to receive and verify a 6 Digit PIN Code through SMS or Voice Call?**
5. **Do I have confirmation from the old BSP that the Two-Factor Verification (2FA) is disabled for this account?**
6. **Do I have a channel already in MessageBird? If so, please provide us with your** [**workspace ID**](https://docs.bird.com/connectivity-platform/troubleshooting/where-can-i-find-my-messagebird-workspace-id)
7. **Please provide a date and a time (Monday to Friday from 10 am to 4pm) subject to availability in the timezone desired. This will be confirmed by an agent via the request form.**
8. **Please provide us a WhatsApp phone number (preferably personal and different to the one that is going to be migrated) we will reach you via WhatsApp in the time scheduled, so we can receive the OTP in real time.**

**Once you are ready, the process can be initiated by filling out this** [**form**](https://bird.com/support-center/inbox-request/new)**.**&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/connectivity-platform/account/migrating-whatsapp-business-from-another-provider-bsp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.