Dá para usar o mesmo número ao sair da Cloud API? Como migrar o número para a não oficial

Sim: dá para levar o mesmo número da API oficial do WhatsApp para a API não oficial. O caminho é remover o número da Cloud API, voltar a ativá-lo no aplicativo WhatsApp Business e conectá-lo à WAME (api-wa.me) por QR Code ou código de pareamento. O que não dá é usar o mesmo número nos dois lados ao mesmo tempo — para isso, a estratégia é ter dois números.

A pergunta ficou frequente com a nova cobrança da Meta: a partir de 1º de outubro de 2026, toda mensagem de serviço enviada pela Cloud API é cobrada, desde a primeira, sem faixa grátis (detalhes em WhatsApp API mais cara em outubro). Quem decide mover o atendimento quase sempre quer manter o número que os clientes já conhecem. Este guia mostra como, e o que fica para trás.

Por que o número não pode ficar nos dois lados?

Porque as duas APIs usam o número de formas incompatíveis:

• Cloud API: o número é registrado nos servidores da Meta e deixa de funcionar no aplicativo comum.
• API não oficial: a WAME se conecta como um aparelho conectado ao WhatsApp que roda no celular — igual ao WhatsApp Web. Para isso, o número precisa estar ativo no app.

Um número só pode estar em um desses estados. Por isso "migrar" significa tirá-lo de um e colocá-lo no outro.

Mesmo número, número novo ou híbrido?

Antes do passo a passo, vale decidir se migrar o número é mesmo a melhor opção:

O modelo híbrido — oficial para template, não oficial para conversa — está detalhado em estratégia híbrida. Se a sua dúvida é migrar sem risco, veja também migrar o WhatsApp em paralelo, sem risco.

Passo a passo para levar o mesmo número

1. Prepare o sistema antes de desligar

Deixe a integração com a WAME pronta antes de tirar o número da Cloud API, para que a janela sem atendimento seja de minutos:

• Crie a instância não oficial na WAME.
• Aponte o webhook com o formato da Meta, para o seu sistema continuar lendo o mesmo envelope:

curl -X PUT "https://us.api-wa.me/SUA_KEY_NOVA/instance" \
  -H "Content-Type: application/json" \
  -d '{
    "allowWebhook": true,
    "allowNumber": "all",
    "webhookMessage": "https://seu-dominio.com/webhook/SEGREDO",
    "webhookConnection": "https://seu-dominio.com/conexao/SEGREDO",
    "webhookFormat": "meta"
  }'

• Troque, no seu código, a URL base e a autenticação. O corpo de envio continua o da Cloud API em POST /{key}/message. A lista completa de ajustes está em trocar graph.facebook.com pela WAME.

2. Guarde o que não vai junto

• Lista de quem optou por receber mensagens e o histórico de conversas que está no seu sistema.
• O PIN de verificação em duas etapas do número, se foi definido na Cloud API — ele pode ser pedido quando o número for ativado no app.
• Textos dos templates, se quiser reaproveitar como mensagens comuns. Na não oficial não há template: o texto é livre.

3. Remova o número da Cloud API

• Se o número está numa instância oficial da WAME: use o endpoint de remoção do registro.

curl -X POST "https://us.api-wa.me/SUA_KEY_OFICIAL/instance/official/deregister"

• Se está em outro provedor (BSP): peça a remoção do registro ao provedor ou faça pelo painel dele.

Dependendo de como o número foi cadastrado na conta da Meta, também pode ser preciso remover o número da conta do WhatsApp Business no WhatsApp Manager antes de o aplicativo aceitar a verificação. Se o app recusar, esse costuma ser o motivo.

4. Ative o número no aplicativo WhatsApp Business

Instale o WhatsApp Business num celular, informe o número e confirme o código recebido por SMS ou ligação. Configure nome, foto e descrição — o perfil completo ajuda o número a parecer o que ele é: uma empresa real.

5. Conecte na WAME

No app: Aparelhos conectados > Conectar um aparelho. Leia o QR Code do painel da WAME ou use o código de pareamento:

curl -X POST "https://us.api-wa.me/SUA_KEY_NOVA/instance/pairing-code" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumber": "5511999999999" }'

A resposta traz o código em code. Se você só tem o celular à mão, siga como conectar pelo celular, sem QR Code.

6. Volte a atender, com calma no começo

O número tem histórico com os seus clientes, mas é um aparelho novo conectado. Nos primeiros dias, priorize responder quem chama e segure disparos ativos. O plano de ritmo está em como aquecer um número na API não oficial.

O que fica para trás?

E se o número estiver em Coexistência?

Coexistência é o modo em que o número fica no app WhatsApp Business e na Cloud API ao mesmo tempo. É um caso diferente do descrito acima, e não vamos prometer como ele se comporta ao ser conectado também como aparelho na API não oficial. Se o seu número está em Coexistência, fale com o suporte da WAME antes de conectar. Para entender o modo, veja API oficial sem perder o celular.

Riscos que valem a pena conhecer

A camada não oficial não é afiliada nem endossada pela Meta, e o uso é responsabilidade de quem envia. Para quem migra o atendimento — responder clientes que falam com você —, o risco de bloqueio é muito baixo para quem usa do jeito certo. O que derruba número é spam, e a WAME não apoia spam: a API recusa envio para muitos números novos por minuto e texto repetido em massa, e avisa pelo webhook de conexão quando o número dá sinal de restrição. A análise completa está em riscos de trocar a API oficial pela não oficial.

Em resumo

• Dá para usar o mesmo número, mas não nos dois lados ao mesmo tempo.
• Ordem: preparar o sistema, guardar o que não vai junto, remover da Cloud API, ativar no app, conectar na WAME.
• Instância oficial da WAME: remoção com POST /{key}/instance/official/deregister.
• Templates, quality rating e histórico da conta oficial ficam para trás; número e clientes continuam.
• Coexistência é caso à parte: fale com o suporte antes.

Conclusão

Migrar o número da Cloud API para a API não oficial é um processo de poucos passos, e o que ele preserva é justamente o que importa para o atendimento: o número que o cliente já salvou. O que fica para trás — templates, quality rating, histórico da conta oficial — pesa só para quem ainda depende de campanhas e autenticação, e para esses casos o híbrido com dois números resolve melhor. Com o sistema preparado antes, a troca dura minutos, e o seu código continua lendo o mesmo envelope da Meta. A referência dos endpoints está na documentação.