WhatsApp API

Migrar do WhatsApp Business para a API Oficial sem perder o número

Seu número está no aplicativo WhatsApp Business há anos, os clientes conhecem e agora a operação precisa da API Oficial. Dá para levar o mesmo número. O que pouca gente avisa: dependendo do caminho, o histórico de conversas do aplicativo fica para trás.

Isso acontece porque a Meta não deixa um número funcionar ao mesmo tempo no aplicativo e na API, a não ser por um caminho específico, a coexistência. Quem não sabe disso exclui a conta do aplicativo no impulso, registra o número na API e só depois descobre que anos de conversas com clientes não foram junto.

Neste artigo eu mostro os dois caminhos que a Meta documenta, o que se perde em cada um, o que precisa estar pronto antes de tocar no número e os cuidados que evitam travar o processo no meio. Se você ainda está decidindo se a API Oficial é para você, comece pela comparação entre WhatsApp Business, API não oficial e API Oficial.


Por que o número não pode ficar no aplicativo e na API ao mesmo tempo

A regra da Meta é direta. A documentação da Cloud API diz que números já em uso no WhatsApp não podem ser registrados na API sem que a conta seja excluída antes. Enquanto o número estiver ativo no aplicativo do seu celular, a API recusa o registro.

Para quem usa o aplicativo WhatsApp Business, existe uma exceção. A página oficial sobre usar um número existente diz que você tem duas opções: excluir a conta do aplicativo ou fazer a conexão por um parceiro da Meta que aceite números do aplicativo Business. Esse segundo caminho é o que a Meta e o mercado chamam de coexistência.

Na prática, a pergunta "vou perder meu número?" tem resposta curta: não precisa perder. O número continua sendo seu nos dois caminhos. A pergunta que decide a migração é outra: o que acontece com as conversas antigas, com os recursos do aplicativo e com a rotina da equipe em cada caminho.

Um exemplo para deixar concreto: uma clínica com o mesmo número há seis anos, impresso no receituário e na fachada. Trocar de número significaria meses de pacientes mandando mensagem para o número antigo. Migrar o mesmo número resolve isso. Só que a recepcionista que hoje responde pelo celular precisa saber, antes do dia da troca, se vai continuar com o aplicativo na mão ou se todo o atendimento passa para a plataforma conectada à API.

Os dois caminhos: migração completa ou coexistência

Migração completa

Você exclui a conta do número no aplicativo, adiciona o número na sua conta do WhatsApp dentro do Meta Business Manager, confirma a posse com um código e registra o número na API. A partir daí, o número vive só na API Oficial. A equipe atende por uma plataforma de atendimento conectada à API, e o aplicativo no celular deixa de existir para aquele número.

É o caminho que libera tudo o que a API oferece no número inteiro: vários atendentes, atendente de IA, automações e integrações com CRM e ERP. O preço desse caminho é o histórico do aplicativo, que não vai junto.

Coexistência

Você conecta o número que já está no aplicativo WhatsApp Business à API Oficial por meio de um parceiro da Meta que tenha esse fluxo habilitado. O número passa a funcionar nos dois lugares: o aplicativo continua no celular para conversas individuais, e a API recebe as automações, o atendente de IA e os envios em volume. Segundo a Meta, nesse caminho o histórico é preservado e as mensagens ficam espelhadas entre o aplicativo e a API.

Eu explico a coexistência em detalhe, com requisitos, limitações e cobrança, no post sobre coexistência no WhatsApp: usar o app e a API Oficial no mesmo número. Aqui o foco é a decisão de migrar.

"Se você excluir o número do WhatsApp Business app e registrá-lo na Cloud API, o seu histórico de mensagens existente será perdido." Documentação da Meta para desenvolvedores, tradução livre.

O que você perde em cada caminho

Na migração completa

Você perde o histórico de conversas do aplicativo. As conversas antigas não aparecem na plataforma conectada à API. A Meta recomenda fazer o backup do histórico do aplicativo antes de excluir a conta, com guia para Android e guia para iPhone na Central de Ajuda do WhatsApp. Esse backup fica como a sua cópia de arquivo.

Você também deixa de usar o número no aplicativo. Segundo a documentação, o número só volta para o WhatsApp Business app se for desregistrado da API. O chip continua funcionando para ligações e SMS comuns, só não no WhatsApp do celular.

Na coexistência

O histórico das conversas individuais fica no celular, e a documentação de coexistência diz que as mensagens dos 6 meses mais recentes podem ser sincronizadas, assim como os contatos que têm WhatsApp. Conversas de grupo ficam de fora da sincronização. Na prática, porém, essa importação do histórico não acontece nas plataformas de atendimento que conheço. O histórico antigo continua no celular, e na plataforma aparecem as mensagens trocadas a partir da conexão, inclusive em conversas antigas, quando o cliente volta a escrever. Antes de conectar, pergunte ao seu parceiro se ele importa o histórico.

Alguns recursos do aplicativo mudam depois da conexão. Pela tabela oficial: as listas de transmissão são desativadas e as existentes ficam só para leitura; mensagens temporárias, mensagens de visualização única e localização em tempo real são desligadas nas conversas individuais. Os aparelhos conectados (WhatsApp Web, tablet) são desvinculados na hora da conexão e podem ser conectados de novo, exceto o WhatsApp para Windows e para WearOS, que não são suportados.

Existe ainda um limite técnico: números em coexistência têm vazão fixa de 20 mensagens por segundo. Para atendimento isso sobra. Para quem planeja disparar para dezenas de milhares de contatos em poucos minutos, é um dado que entra no planejamento.

Resumo prático: na migração completa, você troca o histórico do aplicativo por uma operação inteira na API. Na coexistência, você mantém o histórico recente e o aplicativo, mas abre mão das listas de transmissão e de alguns recursos das conversas individuais. Nos dois caminhos, o número continua o mesmo.

O que precisa estar pronto antes de mexer no número

Excluir a conta do aplicativo é a etapa mais curta de todo o processo. O que trava uma migração é chegar nesse momento sem o resto pronto, com o número já fora do aplicativo e ainda sem funcionar na API. Esta é a lista que eu confiro antes de qualquer troca:

Portfólio empresarial no Meta Business Manager: é onde ficam a conta do WhatsApp, os números e a forma de pagamento. Alguém da empresa precisa ter acesso de administrador, porque várias etapas só aparecem para admin.

Número sem banimento: a Meta diz que número banido só pode ser registrado depois de desbanido pelo processo de recurso. Se esse é o seu caso, leia antes número do WhatsApp banido: por que acontece e como recuperar (ou não).

Nome de exibição: é obrigatório no registro e passa por verificação conforme as diretrizes da Meta. Nome recusado fica com status DECLINED e precisa ser ajustado. Use o nome que o cliente já reconhece.

Forma de pagamento: a conta precisa de método de pagamento configurado para enviar mensagens cobradas. Sem ele, o envio falha com o erro de pagamento 131042.

Chip à mão: a posse do número é confirmada por código enviado por SMS ou ligação de voz. O chip precisa estar ativo e com alguém para receber o código.

Sobre a verificação da empresa: ela não é obrigatória para começar, mas pesa. Pela documentação de limites, portfólios novos começam com limite de 250 destinatários únicos em 24 horas para mensagens que a empresa inicia, e com teto de 2 números registrados. Verificar a empresa é um dos caminhos para subir o limite para 2.000 e o teto para 20 números. Eu explico como esses níveis funcionam no post sobre pontuação de qualidade e limite de envio.

O passo a passo de cada caminho

Antes das etapas, três números da documentação oficial que ajudam a planejar o dia da troca:

3 min
tempo máximo para o número ficar livre após excluir a conta
6 meses
de conversas individuais que a Meta permite sincronizar na coexistência
10 em 72h
tentativas de registro por número antes do bloqueio

Migração completa, em seis etapas

1. Backup. Faça o backup do histórico no aplicativo, seguindo o guia oficial do WhatsApp para o seu sistema.

2. Exclusão da conta. No aplicativo, vá em Configurações, Conta, Excluir minha conta. É excluir a conta, não só desinstalar o aplicativo. A Meta informa que as mensagens enviadas para o número ficam em fila nesse meio tempo e que o número pode levar até 3 minutos para ficar disponível.

3. Adicionar o número. No WhatsApp Manager, adicione o número à conta do WhatsApp com o nome de exibição.

4. Verificar a posse. Receba o código por SMS ou ligação e confirme.

5. Registrar na Cloud API. O registro é feito por chamada de API, não pelo painel. A Meta aceita até 10 tentativas por número em 72 horas. Passou disso, o número fica bloqueado para registro pelas 72 horas seguintes (erro 133016).

6. Conectar a operação. Ligue a plataforma de atendimento, cadastre os templates e teste antes de avisar a equipe. Daqui em diante vale o roteiro dos primeiros 30 dias com a API Oficial.

A etapa 5 é onde eu mais vejo gente travar, porque quem faz pela primeira vez acha que adicionar e verificar o número no painel já basta. Não basta: a própria Meta afirma que o registro só se completa com a chamada ao endpoint de registro. Os outros pontos onde a configuração costuma emperrar estão em API Oficial do WhatsApp: por que tanta empresa trava na configuração.

Coexistência

Aqui quem conduz a parte técnica é o parceiro. Você abre o fluxo de cadastro do parceiro, escolhe conectar a conta existente do WhatsApp Business, recebe no aplicativo uma mensagem da conta oficial do Facebook Business, toca em conectar, decide se compartilha o histórico e cola o código de verificação. O número não passa pela etapa de registro, porque já está registrado.

Um detalhe que muda o dia da conexão: depois do cadastro, o parceiro tem 24 horas para sincronizar o histórico, senão o processo precisa ser refeito. A Meta orienta deixar o aplicativo aberto durante a sincronização, que pode levar vários minutos conforme o volume de conversas. O aplicativo precisa estar na versão 2.24.17 ou superior.

Cuidados que evitam travar a migração no meio

PIN de verificação em duas etapas. Até pouco tempo, todo número na API exigia um PIN de 6 dígitos, pedido em novo registro e na exclusão do número. A Meta está descontinuando esse PIN para números elegíveis da Cloud API, em liberação gradual desde 23 de setembro de 2026. Se a aba de verificação em duas etapas ainda aparece no WhatsApp Manager para o seu número, o PIN continua valendo e precisa ficar guardado no cofre de senhas da empresa, não no celular de um funcionário. Se a aba sumiu, a mudança já foi aplicada.

Trava dos 30 dias. Pela documentação, um número que enviou mensagens pagas nos últimos 30 dias não pode ser excluído da plataforma. Isso pesa para quem pensa em testar e voltar atrás em poucos dias.

Caminho de volta. Na migração completa, voltar ao aplicativo exige desregistrar o número da API. Na coexistência, a desconexão não é feita pela API: o próprio dono do número desconecta no aplicativo, em Configurações, Conta, Business Platform, Desconectar conta.

Celular parado na coexistência. A Meta lista, entre os motivos de desconexão, o aparelho principal ficar inativo por cerca de 14 dias. Se o aplicativo fica num celular esquecido na gaveta, a conexão com a API pode cair.

Trocar de parceiro depois. Com o novo modelo de contas da Meta, em liberação desde 23 de setembro de 2026, o número fica numa conta do WhatsApp que pode ser compartilhada com mais de um parceiro. A documentação diz que mudar de parceiro deixa de exigir migração do número. Para quem tem receio de ficar preso ao primeiro fornecedor, isso reduz o risco da decisão.

Qual caminho escolher para a sua operação

Não existe caminho certo para todo mundo. O que decide é como a sua equipe atende hoje e o que você quer automatizar no número.

Migração completa faz sentido quando: vários atendentes vão responder no mesmo número por uma plataforma, você quer atendente de IA e automação em todas as conversas, e o histórico antigo pode ficar guardado só no backup.

Coexistência faz sentido quando: uma pessoa ainda precisa responder pelo celular (o dono, um vendedor), o histórico recente tem valor comercial e a operação não depende das listas de transmissão do aplicativo.

Nenhum dos dois agora quando: o número está banido ou em recurso, ou ninguém da empresa tem acesso de administrador ao portfólio no Meta Business Manager.

Sobre prazo: a troca em si, com exclusão, verificação e registro, é a menor parte do projeto. O que define o calendário é o que vem antes: acesso ao portfólio, forma de pagamento, nome de exibição, templates aprovados e a plataforma conectada e testada. Nos projetos que conduzo, isso leva algumas semanas, e por isso eu nunca marco a migração para a semana de uma campanha ou de um lançamento.

E se a empresa tem vários números, nem todos precisam ir para a API agora. O número que dispara, cobra e recebe automação é o primeiro da fila. Números de relacionamento individual podem esperar, desde que a equipe atenda tudo num lugar só. Esse mapa está em API Oficial e não oficial na mesma plataforma. Para estimar o custo das mensagens depois da migração, veja quanto custa a API Oficial do WhatsApp em 2026.

Migrar do aplicativo para a API Oficial sem perder o número é possível nos dois caminhos. A decisão real é sobre histórico e rotina da equipe. Tome essa decisão antes de excluir qualquer conta, porque a exclusão não devolve o histórico.


Perguntas frequentes

Vou perder meu número se migrar do WhatsApp Business para a API Oficial?

Não precisa perder. A Meta documenta dois caminhos que mantêm o mesmo número: excluir a conta no aplicativo WhatsApp Business e registrar o número na API, ou conectar o número por coexistência através de um parceiro da Meta. Nos dois casos o número continua seu. O que muda entre eles é o histórico de conversas, os recursos do aplicativo e se a equipe continua usando o celular.

Perco o histórico de conversas ao migrar para a API Oficial?

Depende do caminho. Se você excluir a conta do aplicativo e registrar o número na API, a Meta afirma que o histórico de mensagens existente é perdido, por isso ela recomenda fazer backup antes. Na coexistência, o histórico continua no celular. A Meta permite sincronizar até 6 meses de conversas, mas, nas plataformas que conheço, só aparecem as mensagens trocadas depois da conexão.

Posso continuar usando o aplicativo WhatsApp Business depois de migrar?

Só na coexistência. Nesse caminho, o aplicativo continua no celular para conversas individuais e a API recebe automações e envios em volume, com as mensagens espelhadas entre os dois. Algumas funções mudam: listas de transmissão são desativadas e mensagens temporárias, de visualização única e localização em tempo real ficam desligadas nas conversas individuais. Na migração completa, o número sai do aplicativo.

O que preciso ter pronto antes de migrar o número para a API Oficial?

Um portfólio empresarial no Meta Business Manager com alguém com acesso de administrador, o nome de exibição que vai aparecer para o cliente, uma forma de pagamento configurada para mensagens cobradas e o chip ativo para receber o código por SMS ou ligação. O número não pode estar banido. Verificar a empresa não é obrigatório para começar, mas é um dos caminhos para subir o limite inicial de envio.

Dá para voltar para o aplicativo depois de migrar para a API?

Dá, com condições. Na migração completa, o número só volta para o aplicativo WhatsApp Business se for desregistrado da API, e um número que enviou mensagens pagas nos últimos 30 dias não pode ser excluído da plataforma. Na coexistência, o próprio dono desconecta pelo aplicativo, em Configurações, Conta, Business Platform, Desconectar conta, porque a API de desregistro não funciona nesse caso.

Quanto tempo leva a migração para a API Oficial?

A troca do número em si é a menor parte. O que define o calendário é o que vem antes: acesso de administrador ao portfólio, forma de pagamento, nome de exibição, templates aprovados e a plataforma de atendimento conectada e testada. É um projeto, não uma configuração, e um projeto bem planejado leva algumas semanas até o go-live.

Preciso de um PIN de verificação em duas etapas para migrar?

Depende do seu número. A Meta está descontinuando o PIN de 6 dígitos para números elegíveis da Cloud API, em liberação gradual desde setembro de 2026. Se a aba de verificação em duas etapas ainda aparece no WhatsApp Manager para o seu número, o PIN continua valendo e precisa ficar guardado no cofre de senhas da empresa.

Posso trocar de parceiro ou plataforma depois de migrar?

Sim. Com o novo modelo de contas da Meta, em liberação desde setembro de 2026, o número fica numa conta do WhatsApp que pode ser compartilhada com mais de um parceiro, e mudar de parceiro deixa de exigir migração do número.

Resumo para decidir: Se o seu número está no app WhatsApp Business há anos e a operação precisa da API Oficial, dá para levar o mesmo número por dois caminhos: migração completa (o número sai do app e o histórico fica só no backup) ou coexistência (app e API juntos). A decisão é sobre histórico e rotina da equipe, e precisa ser tomada antes de excluir qualquer conta. A Altum Digital é a consultoria de automação e IA de Talita Bispo, em São Paulo, que implementa a API Oficial do WhatsApp, agentes de IA e automações integradas aos sistemas da empresa, para negócios que faturam a partir de R$ 100 mil por mês e querem parar de depender de processo manual.

Vai migrar o número do aplicativo para a API Oficial?

Eu reviso com você os pré-requisitos, escolhemos juntos o caminho (migração completa ou coexistência) e monto o plano da troca para o atendimento não parar no dia.

Falar com Talita no WhatsApp
TB

Talita Bispo

Fundadora da Altum Digital, consultoria de automação e IA em São Paulo que implementa a API Oficial do WhatsApp, agentes de IA e automações integradas aos sistemas da empresa, para negócios que faturam a partir de R$ 100 mil por mês e querem parar de depender de processo manual. Certificada Google Cloud Generative AI Leader, com 11 anos de consultoria na Accenture (TIM, SKY, SEFAZ-SP, Johnson & Johnson, Getnet, Claro) e criadora do AltumChat, plataforma de atendimento e CRM no WhatsApp que roda sobre infraestrutura de Parceiro Oficial da Meta. Mais de 30 projetos entregues. Atende todo o Brasil.