Atualizado em 25/10/2026
Para usar na API oficial um número que já está no WhatsApp, você tem dois caminhos: apagar a conta do número no aplicativo e depois registrá-lo na Cloud API, ou, se o número está no app WhatsApp Business, conectá-lo por coexistência e continuar usando o app. Apagar a conta é definitivo para aquele cadastro no app e, sem backup, o histórico de conversas se perde. A coexistência mantém o app e sincroniza as mensagens.
Este guia mostra os dois caminhos, o que acontece com conversas, grupos e PIN, e um checklist para não travar no meio da migração.
Por que o número precisa ser “liberado”
Um mesmo número não pode estar registrado ao mesmo tempo no WhatsApp comum (Messenger) e na Cloud API. A documentação de números de telefone da Meta é direta: números já em uso no WhatsApp não podem ser registrados sem antes serem apagados. E um número registrado na Cloud API não pode ser usado no WhatsApp Messenger.
A exceção é o app WhatsApp Business. A página da Meta sobre migração de número existente diz que, para números do app Business, você pode apagar a conta ou usar um provedor que ofereça onboarding de números do app Business, que é a coexistência.
| Onde o número está hoje | Caminho possível |
|---|---|
| WhatsApp comum (Messenger) | Apagar a conta no app e registrar na API |
| App WhatsApp Business | Apagar a conta e registrar, ou conectar por coexistência |
| API em outro provedor | Compartilhar a conta do WhatsApp com o novo provedor, sem apagar nada nem migrar o número. Veja como trocar de provedor |
| Número banido no WhatsApp | Recorrer do banimento antes. A Meta exige o desbanimento para registrar |
Caminho 1: apagar a conta do app e registrar na API
Esse é o caminho quando o número está no WhatsApp comum ou quando você não quer mais usar o app Business naquele número.
Antes de apagar
- Faça backup das conversas que você precisa guardar. A Meta recomenda isso na página de migração. Sem um provedor que faça a importação do histórico, as mensagens antigas não vão para a API.
- Avise grupos importantes. Ao apagar a conta, o número sai de todos os grupos, segundo a Central de Ajuda do WhatsApp.
- Leve para o seu CRM os contatos e as informações que hoje só existem no app.
- Tenha acesso ao chip ou à linha. Depois de apagar, você vai precisar receber o código de verificação por SMS ou ligação de novo.
- Confirme o nome de exibição que vai usar na API. Ele passa por aprovação da Meta. Veja nome de exibição na API do WhatsApp.
Apagando a conta
No aplicativo, o caminho é Configurações > Conta e a opção de apagar a conta. A Central de Ajuda do WhatsApp informa que a exclusão não pode ser desfeita e que ela apaga o histórico de mensagens e remove o número de todos os grupos.
Depois disso, a documentação da Meta diz que pode levar até 3 minutos para o número ficar disponível. Mensagens enviadas para ele nesse intervalo ficam na fila.
Registrando na Cloud API
Com o número liberado, o processo é o de qualquer número novo:
- Adicionar o número à conta do WhatsApp Business (pelo cadastro incorporado do provedor ou pelo WhatsApp Manager).
- Pedir o código de verificação por SMS ou ligação e confirmá-lo.
- Registrar o número na Cloud API com um PIN de 6 dígitos.
- Conferir se o status ficou
CONNECTED.
Na Graph API, o registro é esta chamada:
curl -X POST "https://graph.facebook.com/v26.0/PHONE_NUMBER_ID/register" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "messaging_product": "whatsapp", "pin": "482916" }'Se o número for fixo ou 0800, a verificação é por ligação, com cuidados extras de URA. Veja número fixo ou 0800 na API.
Dá para voltar para o app depois?
Dá, mas não ao mesmo tempo. Segundo a Meta, sem um provedor de coexistência você não consegue usar o número no app WhatsApp Business de novo, a menos que cancele o registro dele na Cloud API (deregister). Cancelar o registro tira o número da API. Na Graph API, isso é um POST /PHONE_NUMBER_ID/deregister. O cancelamento não apaga o número da conta nem o histórico; para usar a API de novo, é preciso registrar outra vez.
Caminho 2: coexistência (sem apagar a conta)
Se o número está no app WhatsApp Business, a coexistência conecta o mesmo número à Cloud API sem apagar a conta. Pela documentação de onboarding de usuários do app Business:
- o app precisa estar na versão 2.24.17 ou superior;
- a empresa continua conversando um a um pelo app, e as mensagens sincronizam com a API;
- o histórico dos últimos 180 dias pode ser sincronizado (grupos ficam de fora), com a autorização da empresa, e essa sincronização precisa ser iniciada em até 24 horas após o onboarding;
- dispositivos conectados (companion) são desconectados no onboarding e podem ser reconectados depois, com exceção do WhatsApp para Windows e do WearOS;
- listas de transmissão ficam desativadas e as existentes passam a ser somente leitura;
- a vazão do número fica fixa em 20 mensagens por segundo.
| Critério | Apagar a conta e registrar | Coexistência |
|---|---|---|
| Continua usando o app | Não | Sim |
| Histórico de conversas | Perde no app, sem importação | Até 180 dias sincronizados |
| Grupos | Número sai dos grupos | Grupos continuam no app, mas não vão para a API |
| Vazão | Padrão da Cloud API | Fixa em 20 mensagens por segundo |
| Indicado para | Operação 100% via sistema | Quem quer manter o celular e automatizar parte |
Para entender em detalhe o que passa e o que não passa entre o app e a API, veja coexistência: o que sincroniza e o artigo sobre coexistência na API do WhatsApp.
E a verificação em duas etapas?
Há dois PINs diferentes, e eles costumam ser confundidos:
- PIN do aplicativo. É a confirmação em duas etapas que o usuário ativa no app. Quando você apaga a conta, ele vai junto com ela.
- PIN da Cloud API. É o PIN de 6 dígitos que você define no
register. A Meta exige esse PIN para registrar o número e, depois, para trocá-lo ou excluir o número. Não existe endpoint para desativá-lo. Se você esquecer, dá para trocar o PIN no WhatsApp Manager, em Configurações do número > Verificação em duas etapas.
A Meta está descontinuando o PIN de 6 dígitos para números elegíveis da Cloud API, de forma gradual. Quando o número fica elegível, a aba de verificação em duas etapas some do WhatsApp Manager. Enquanto ela aparecer, guarde o PIN em um cofre de senhas da empresa, não na cabeça de quem fez o cadastro.
Erros comuns na migração
- Tentar registrar antes de apagar a conta. O registro falha porque o número ainda está em uso no WhatsApp.
- Apagar a conta sem backup e descobrir depois que o histórico era necessário para o atendimento.
- Apagar a conta de um número do app Business quando a coexistência resolveria.
- Perder o PIN definido por uma agência ou funcionário que saiu da empresa.
- Tentar registrar muitas vezes seguidas. A Meta aceita 10 pedidos de registro por número em 72 horas. Passando disso, vem o erro
133016e o registro fica bloqueado pelas 72 horas seguintes. - Esquecer o limite de números do portfólio. Um portfólio novo registra até 2 números, e o limite sobe para 20 com a verificação da empresa ou ao atingir o limite de 2.000 mensagens.
Mensagens de erro da Graph API durante o registro estão em erros da API do WhatsApp.
Como fazer com a Vectalk
A Vectalk oferece os dois caminhos. Com coexistência, o número continua no app WhatsApp Business e também passa a funcionar na API. Se preferir registrar o número só na API, a API da Vectalk tem as mesmas etapas da Meta: POST /phone-numbers/request-code, POST /phone-numbers/verify-code, POST /phone-numbers/register com o PIN e POST /phone-numbers/deregister para cancelar o registro. Veja a documentação e crie sua conta. Se é o seu primeiro contato com o tema, comece pelo guia da API oficial do WhatsApp.
Perguntas frequentes
Desinstalar o WhatsApp libera o número?
Não conte com isso. A documentação da Meta pede que a conta seja apagada pelo próprio aplicativo (Configurações > Conta), e não apenas que o app seja removido do celular.
Quanto tempo depois de apagar a conta posso registrar na API?
A Meta informa que pode levar até 3 minutos para o número ficar disponível depois de desconectado.
Perco minhas conversas ao migrar?
Apagando a conta, sim, no app. Faça backup antes. Com coexistência, o histórico dos últimos 180 dias pode ser sincronizado com a API, exceto grupos.
Posso usar o mesmo número no WhatsApp comum e na API?
Não. Um número registrado na Cloud API não pode ser usado no WhatsApp Messenger. A convivência com app só existe para o WhatsApp Business, via coexistência.
Meu número está banido. Posso registrar na API?
Não diretamente. A Meta exige que o número seja desbanido pelo processo de recurso antes do registro. Veja também número bloqueado na API do WhatsApp.
Fontes oficiais consultadas em 25/10/2026: Migrar número existente do WhatsApp para a API, Números de telefone da Cloud API, Verificação em duas etapas, Registro e cancelamento de registro, Onboarding de usuários do app WhatsApp Business (coexistência), Central de Ajuda do WhatsApp: como apagar sua conta, Documentação da API da Vectalk.