Como migrar seu número para a API oficial do WhatsApp em 2026

Dá para levar o número que você já usa para a API oficial do WhatsApp, sem trocar de telefone nem avisar a base inteira. Existem dois caminhos: apagar a conta do aplicativo e registrar o número na Cloud API, ou usar a coexistência, que conecta o número do WhatsApp Business App à API mantendo o aplicativo funcionando. Se você já está na API oficial com outra plataforma, a troca é ainda mais simples, porque o número continua na sua conta da Meta. Neste guia você vê qual caminho serve para o seu caso, o que se perde em cada um e como fazer a virada sem parar de vender.

Por que vale a pena migrar o número que você já tem

O número que está no seu cartão, no Instagram e na cabeça dos clientes vale dinheiro. Segundo a pesquisa Super Panorama Mobile Time/Opinion Box de 2026, feita com 4.138 brasileiros em março, o WhatsApp está instalado em 98,3% dos smartphones do país e 79,5% dos usuários conversaram com marcas ou empresas pelo aplicativo nos últimos 12 meses. Trocar de número significa refazer esse caminho do zero com cada cliente.

O problema é que muita empresa chegou a esse volume usando o celular, extensões ou ferramentas que espelham o QR Code do WhatsApp Web. Esse tipo de automação não é autorizado pela Meta, e é a causa mais comum de número bloqueado. Migrar para a API oficial resolve essa causa. A partir daí, o que pesa é a qualidade das suas mensagens, o opt-in dos contatos e as políticas da Meta, que continuam valendo para todo mundo.

Antes de começar: o que você precisa ter em mãos

A Meta exige que o número seja seu, tenha código de país e DDD (números curtos não funcionam) e consiga receber SMS ou ligação para o código de verificação. A própria documentação recomenda número de celular, porque fixos e VoIP costumam falhar no recebimento do SMS.

Na Central de Ajuda da WizeBot, a lista de preparação inclui:

• uma conta do Facebook ativa há pelo menos 3 meses;
• um site do seu produto ou serviço (página de Instagram ou de outra rede social não vale);
• o número de telefone que vai para a API;
• acesso ao portfólio empresarial da Meta (o antigo Business Manager) da sua empresa.

Pense também no nome de exibição, que é o nome que o cliente vê no perfil. Ele precisa seguir as diretrizes da Meta, então nada de nome genérico ou que não tenha relação com a marca. A Meta permite trocar esse nome até 10 vezes a cada 30 dias, mas cada troca passa por análise de novo.

Um cuidado importante: se o número já foi banido no WhatsApp, ele não pode ser registrado na API até ser liberado pelo processo de recurso do próprio WhatsApp. Migrar não limpa histórico de bloqueio.

Caminho 1: apagar a conta do aplicativo e registrar o número

Esse é o caminho clássico e o que a documentação da Meta descreve para quem usa o WhatsApp comum ou o WhatsApp Business App sem um parceiro com coexistência. Funciona assim:

1. Faça backup das conversas no celular (Android ou iPhone), porque o histórico do aplicativo não vai para a API.
2. No aplicativo, abra Configurações, depois Conta, e toque em Apagar minha conta.
3. Aguarde alguns minutos. Segundo a Meta, o número pode levar até 3 minutos para ficar disponível.
4. Conecte o número na plataforma que vai usar a API, recebendo o código de 6 dígitos por SMS ou ligação.

Enquanto o número está sem conta, as mensagens que chegam ficam na fila e são entregues depois do registro. Mesmo assim, faça a troca num horário de pouco movimento.

O que você precisa saber antes de apagar:

• O histórico de conversas do aplicativo se perde. O backup fica no seu celular, mas não aparece na caixa de entrada da API.
• O número deixa de funcionar no aplicativo. Ele só volta para o WhatsApp Business App se for desregistrado da Cloud API.
• Ligações e SMS normais continuam funcionando no chip, só o WhatsApp do celular sai de cena.
• Não fique repetindo a tentativa de registro. A Meta limita a 10 pedidos de registro por número em 72 horas. Se passar disso, o número fica travado até o fim desse prazo.

Esse caminho é o mais indicado para quem vem de ferramenta não oficial com QR Code. Você encerra de vez a conexão que gerava risco e começa a operação toda dentro da API.

Caminho 2: coexistência entre o WhatsApp Business App e a API

A coexistência é um recurso da Meta que conecta um número do WhatsApp Business App à Cloud API por meio de um parceiro que suporte esse fluxo. Você continua usando o aplicativo no celular para conversas individuais e, ao mesmo tempo, a plataforma conectada à API faz automação, atendimento em equipe e campanhas.

Pela documentação da Meta, o que acontece na prática:

• Conversas recentes podem ser sincronizadas. Mensagens individuais dos últimos 6 meses podem ir para a plataforma, e o que é enviado e recebido fica espelhado nos dois lados.
• Contatos com WhatsApp podem ser sincronizados.
• Grupos não entram. Conversas em grupo não são sincronizadas.
• Listas de transmissão param. As listas existentes ficam só para leitura e não dá para criar novas. Disparos passam a ser feitos pela API, com modelos aprovados.
• Mensagens temporárias, visualização única e localização em tempo real ficam desativadas nas conversas individuais.
• Dispositivos conectados são desvinculados e precisam ser conectados de novo. WhatsApp para Windows e para WearOS não são suportados.
• A velocidade de envio fica fixa em 20 mensagens por segundo, para manter compatibilidade com o aplicativo.

Você precisa do WhatsApp Business App na versão 2.24.17 ou mais recente. Durante a conexão, o aplicativo mostra uma mensagem da conta oficial do Facebook Business com o botão para conectar à plataforma e a opção de compartilhar o histórico. Deixe o aplicativo aberto até a sincronização terminar.

Sobre custo: as mensagens que você manda pelo aplicativo continuam gratuitas, e as mensagens enviadas pela API seguem a tabela da Meta. A janela de 24 horas de atendimento vale só para o que sai pela API. Uma mensagem que o cliente mandou antes da conexão não abre janela, então a primeira resposta pela API para ele precisa ser um modelo aprovado.

Nem toda plataforma oferece coexistência, e o fluxo de conexão muda conforme o parceiro. Na WizeBot, o tutorial atual de conexão orienta apagar a conta do aplicativo antes de conectar um número que já está no WhatsApp. Se você quer manter o aplicativo em paralelo, fale com o suporte antes de apagar qualquer coisa para confirmar qual caminho está disponível para o seu número.

Caminho 3: você já está na API oficial e quer trocar de plataforma

Se o seu número já roda na API oficial com outra empresa, você não precisa apagar nada nem passar por um número novo. O número continua registrado na conta do WhatsApp que pertence ao seu portfólio empresarial na Meta. No modelo de contas atual, a Meta não move números entre contas: a nova plataforma passa a ter acesso quando você conecta ou compartilha a conta que já é dona do número.

Na prática, isso traz três vantagens:

• Seus modelos aprovados continuam na conta, então você não volta para a fila de aprovação.
• A qualidade do número e o limite de mensagens são do número, não da ferramenta. Você não começa do zero.
• A cobrança das mensagens continua com a Meta, direto na sua conta, conforme a forma de pagamento cadastrada.

Um ponto de atenção da documentação: se a sua empresa ainda compartilha a linha de crédito de um parceiro antigo, pode aparecer erro na hora de conectar o novo. Nesse caso, siga a orientação da Meta para encerrar o compartilhamento da linha de crédito com o parceiro anterior e confira a forma de pagamento da conta. O suporte da nova plataforma ajuda nessa etapa.

Na WizeBot, essa troca é acompanhada pelo suporte, o número é preservado e o fluxo antigo continua rodando até o novo estar pronto. Assim você não fica um dia sem atendimento.

Como fazer a virada sem perder venda

Migração boa é aquela que o cliente nem percebe. Algumas práticas ajudam bastante:

• Monte os fluxos antes de virar a chave. Boas-vindas, menu, perguntas frequentes e encaminhamento para o atendente devem estar prontos e testados antes de o número entrar na API.
• Peça a aprovação dos modelos logo depois de conectar. Lembrete de boleto, confirmação de Pix, código de rastreio e mensagem de reativação dependem de modelo aprovado. A análise da Meta costuma sair em minutos, mas pode levar até 24 horas.
• Escolha um horário calmo. Para um e-commerce, evite segunda de manhã ou o dia seguinte a uma campanha. Para infoproduto, não migre no meio de um lançamento.
• Avise a equipe. Quem atendia pelo celular vai passar a atender pela caixa de entrada da plataforma, com etiquetas, transferência e histórico centralizado.
• Revise sua lista antes do primeiro disparo. Mande campanha só para quem deu opt-in. Na pesquisa WhatsApp no Brasil 2026 da Opinion Box, 18% de quem recebeu oferta de empresa desconhecida disse bloquear o contato antes mesmo de ver a mensagem. Bloqueio e denúncia derrubam a qualidade do número na API.

Um exemplo comum: uma loja que vende pelo Instagram e fecha pedido no WhatsApp Business App, com 3 vendedores dividindo um celular. Na migração, o número vai para a API, o bot responde preço e frete na hora, a etiqueta "aguardando Pix" vira uma coluna no CRM e o lembrete de pagamento sai por modelo de utilidade. Os vendedores entram cada um com seu acesso, e ninguém mais precisa ficar com o celular da loja.

Para um infoprodutor, a lógica é parecida: o número de suporte entra na API, a integração com Hotmart ou Kiwify dispara a mensagem de boas-vindas e de boleto pendente, e as dúvidas recorrentes ficam com o atendimento por IA.

Erros comuns na migração

• Apagar a conta sem backup. Depois que a conta é apagada, o histórico não volta para a API.
• Usar número fixo ou VoIP sem testar o SMS. Se o código não chegar, ative o recebimento por ligação ou use um celular.
• Colocar site de rede social no cadastro. O tutorial da WizeBot pede um site próprio, e a Meta usa essas informações no cadastro da empresa.
• Escolher um nome de exibição genérico. Nome fora das diretrizes pode ser recusado e atrasar a operação.
• Disparar para a base toda no primeiro dia. Número novo na API começa com limite de envio menor e sobe com o uso e a qualidade. Veja como funciona no guia de limite de mensagens do WhatsApp API.
• Esquecer a janela de 24 horas. Fora dela, só modelo aprovado. O guia da janela de 24 horas explica quando ela abre e fecha.

Quanto custa depois da migração

A plataforma cobra a mensalidade e a Meta cobra as mensagens enviadas pela API, direto na sua conta e pela tabela oficial em reais. Na WizeBot não existe taxa escondida em cima da mensagem: você paga a Meta pelo que enviar. Para estimar o gasto do seu volume, use a calculadora de custo por mensagem e confira os detalhes no guia de custo das mensagens no Brasil em outubro de 2026.

Perguntas frequentes

Vou perder meus contatos ao migrar para a API oficial?

Os contatos salvos na agenda do celular continuam no celular. Na coexistência, os contatos com WhatsApp podem ser sincronizados com a plataforma. No caminho de apagar a conta, você importa a lista na plataforma, de preferência só com quem deu opt-in.

Meu número pode ser bloqueado depois de migrar?

A API oficial elimina o risco de bloqueio por usar ferramenta não autorizada. A Meta ainda pode reduzir o limite ou restringir a conta se as mensagens gerarem muito bloqueio, denúncia ou violarem a política. O guia sobre qualidade do número no WhatsApp API mostra como acompanhar isso.

Preciso de um número novo?

Não. Você pode migrar o número atual por qualquer um dos caminhos acima. Número novo só faz sentido se você quiser separar operações, como vendas e suporte, ou manter o aplicativo intacto num número e a automação em outro.

Quanto tempo leva?

A conexão em si costuma levar poucos minutos quando o portfólio da Meta, o site e o número estão em ordem. Na coexistência, a sincronização do histórico pode levar mais tempo, conforme o volume de conversas.

Se você quer tirar o número do celular e colocar sua operação na API oficial com fluxos, CRM e atendimento em equipe, a WizeBot faz essa conexão com acompanhamento do suporte. Você pode começar agora com 30 dias de garantia: se não gostar, devolvemos 100%. Prefere entender primeiro? Veja como funciona, compare os planos ou consulte a Central de Ajuda. #Wizebot