> For the complete documentation index, see [llms.txt](https://docs.sheeps.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sheeps.cloud/guides/migracao-de-numero-de-telefone-entre-whatsapp-bsps-number-porting.md).

# Migração de Número de Telefone entre WhatsApp BSPs (Number Porting)

## O que é Portabilidade de Número?

A portabilidade do número significa que um número de telefone já registrado na WhatsApp Business API pode ser movido entre as contas da WhatsApp Business API. Isto permite que as empresas mudem os BSPs (Business Solution Provider) ou movam seu número para uma nova conta, **mas somente se os IDs do Business Manager do Facebook de origem e destino forem os mesmos**.

Após ser migrado, um número de telefone mantém seu nome de exibição (display name), taxa de qualidade ([quality rating](https://developers.facebook.com/docs/whatsapp/api/rate-limits#quality)), limites de mensagens ([messaging limits](https://developers.facebook.com/docs/whatsapp/api/rate-limits#messaging)), status da OBA ([Official Business Account status](https://developers.facebook.com/docs/whatsapp/guides/display-name#types)), e qualquer template de alta qualidade ([high quality](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/#quality-rating-and-template-status)) previamente aprovado.

#### Migração de Conta

<figure><img src="/files/6skag0z71XMEiK1Q6cZc" alt=""><figcaption></figcaption></figure>

#### Migração de Template e Histórico de Chat

Apenas os templates de alta qualidade são migrados neste processo. Na prática, eles são copiados para o WABA de destino. Estes templates não precisam passar por revisão novamente e podem ser enviados imediatamente.

Os templates de baixa qualidade, rejeitados ou pendentes não são migrados. Quaisquer templates de mensagens existentes no WABA de destino não serão sobregravados.

O histórico de mensagens e bate-papos não é migrado com este processo.

#### Migração de Faturamento

As mensagens enviadas antes da migração são cobradas do BSP de origem. As mensagens enviadas após a migração são cobradas na BSP de destino. Mensagens enviadas a partir da origem e que não são entregues antes da migração, ainda são cobradas no BSP de origem quando são entregues.

#### **Contas Comerciais Oficiais (Official Business Accounts - Green Badge)**

As contas comerciais oficiais (OBAs) podem ser migradas entre as WABAs. A única exigência é que a **autenticação de dois fatores seja desativada** durante o processo de migração. Ela pode ser reabilitada após a migração do número. Isso para que o registro do número aconteça conforme previsto e sem erro.

## **Pré-requisitos para Portabilidade de Número**

**Para fazer a portabilidade de um número para a Sheeps:**

* Você precisa de um número de telefone onde consiga receber um código PIN de verificação de 6 dígitos através de SMS ou chamada de voz.
* A conta comercial WhatsApp conectada ao número a ser portado deve ser verificada pelo Meta. **As contas no modo Sandbox não podem ser portadas.**
* Verificação em dois fatores [deve ser desabilitada do número](https://developers.facebook.com/docs/whatsapp/api/settings/two-factor/#disable).&#x20;

{% hint style="warning" %}
Você precisa solicitar ao antigo BSP de WhatsApp desativar a Verificação de Dois Fatores (2FA). O 2FA pode e deve ser desativado **sem desativar a conta**.

As regras do Meta afirmam que o BSP de WhatsApp não pode atrasar ou dificultar em nada a desativação do 2FA ou o processo de portabilidade. Se algo semelhante acontecer, por favor, informe-nos.
{% endhint %}

**Accesso de Admin ao Business Manager:**

* [Business ID](https://www.facebook.com/business/help/1181250022022158?id=180505742745347) do número a ser portado.
* O acesso de Adm é necessário para aceitar o pedido de Message-on-Behalf.

## Checklist de Preparação

Antes de migrar um número, é importante passar pela seguinte lista:

1. **ID de Facebook Business Válido**\
   Você encontra seu FB\_ID [seguindo esse passos](https://docs.360dialog.com/facebook-and-whatsapp-accounts-structure#how-to-find-the-facebook-business-manager-id). O FB\_ID deve ser associado com (deve possuir) a Conta WhatsApp > Número que você está tentando migrar. Uma visão geral do modelo de propriedade pode ser [encontrado aqui](https://docs.360dialog.com/facebook-and-whatsapp-accounts-structure#how-to-find-the-facebook-business-manager-id).&#x20;
2. **Acesso de Admin ao Business Manager**\
   Você deve ter acesso de Admin à conta da FBM.
3. &#x20;**Business Manager verificado**\
   Seu Business Manager deve estar [completamente verificado](https://docs.360dialog.com/business-verification).
4. **Acesso a Número de Telefone**\
   Você deve ter acesso ao número de telefone para receber um código PIN de 6 dígitos via SMS ou via chamada telefônica.
5. **2FA Desabilitado**\
   Você deve verificar e confirmar com seu antigo BSP de WhatsApp que a Verificação de Dois Fatores (2FA) está **desativada** no WhatsApp Business API Client existente.<br>

**Atenção Brasil!**\
Verifique em seu perfil atual de WhatsApp se o número registrado tem o 9 extra ou não. Ao portar o número, ele deve parecer **exatamente o mesmo** que o perfil atual.

### Processo de Portabilidade de Número

Depois de ter submetido as informações iniciais seja pelo suporte da Sheeps ou pelo Formulário de Portabilidade de Número , você iniciará o processo de portabilidade do número e o processo está detalhado abaixo.

### **Aceite a solicitação de Messaging on Behalf no Business Manager**

Você precisará aceitar a solicitação de Message on Behalf da 360dialog. Você deve ter acesso de Admin ao Business Manager para ver e aceitar à solicitação.

### &#x20;Registre o Número

Você deve ter acesso ao número de telefone para verificar a propriedade e reveber um código PIN de 6 dígitos por SMS ou Chamada de voz.

Se você não receber o código PIN em 1 hora depois de seu disparo, [abra um ticket junto ao nosso suporte](https://docs.360dialog.com/useful/help-and-support)

### **Espere pelo setup**

Você precisa esperar pelo setup do número. Isso pode levar alguns minutos, mas logo após a geração da chave de API já será possível.

Se sua página não mudar depois de mais de 1 hora, [abra um ticket junto ao nosso suporte](https://api.whatsapp.com/send/?phone=553496369406\&text=ola+preciso+de+ajuda+na+portabilidade+waba\&type=phone_number\&app_absent=0).

## Suporte para Migração de Número de Telefone

Para garantir que passe apenas por um tempo mínimo de inatividade enquanto porta seu número para a Sheeps, oferecemos suporte especial de portabilidade de números.

[Use este](https://api.whatsapp.com/send/?phone=553496369406\&text=ola+preciso+de+ajuda+na+portabilidade+waba\&type=phone_number\&app_absent=0)[ link para pedir suporte ](https://api.whatsapp.com/send/?phone=553496369406\&text=ola+preciso+de+ajuda+na+portabilidade+waba\&type=phone_number\&app_absent=0) e então realizar todo o processo de migração de número de telefone.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.sheeps.cloud/guides/migracao-de-numero-de-telefone-entre-whatsapp-bsps-number-porting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
