Como migrar o número do WhatsApp Business (app) para a API oficial

O número que os clientes já conhecem costuma ser o maior ativo do atendimento no WhatsApp. Por isso, a dúvida de quase toda empresa que decide migrar número para a API oficial é a mesma: dá para levar o número sem perder contatos, conversas e o costume dos clientes? Dá — mas o resultado depende do caminho escolhido. Este guia mostra as duas formas que a Meta documenta, o que fazer antes, o que muda depois e como conferir se deu tudo certo.

Se você ainda está decidindo se precisa da API, comece por o que é a API oficial do WhatsApp.

Antes de começar: os dois caminhos de migração

Checklist antes de migrar

• Acesso ao chip ou à linha: o número precisa receber SMS ou ligação para o código de verificação. Números fixos funcionam se recebem ligação.
• Portfólio empresarial na Meta (antigo Gerenciador de Negócios), com acesso de administrador.
• Nome de exibição que represente a empresa, de acordo com as regras da Meta. Ele passa por revisão.
• Backup das conversas do app, se for usar a migração tradicional.
• Plataforma escolhida e configurada antes da troca: fluxos de boas-vindas, horários, equipe e regras de transferência.
• Templates básicos (confirmação, lembrete) já pensados, porque fora da janela de 24 horas só eles podem ser enviados. Veja templates do WhatsApp.
• Horário de baixo movimento para a troca, de preferência fora do pico.

Caminho 1: migração tradicional, passo a passo

É o caminho descrito pela Meta para números que estão no WhatsApp Messenger ou no app WhatsApp Business. A regra central, segundo a documentação de números comerciais: um número em uso no WhatsApp só pode ser registrado na API depois de apagado.

1. Faça o backup das conversas do app (Google Drive no Android, iCloud no iPhone) e exporte as conversas importantes. A Meta avisa que o histórico do app será perdido na migração.
2. Anote o que precisa ser refeito: foto de perfil, descrição, endereço, horário, respostas rápidas, etiquetas e catálogo.
3. Apague a conta no app: abra o WhatsApp Business, vá em Configurações > Conta > Apagar minha conta e siga os passos.
4. Aguarde alguns minutos: a Meta indica até 3 minutos para o número ficar disponível.
5. Registre o número na plataforma. Na Nabot, a conexão usa o cadastro incorporado da Meta: você entra com sua conta do Facebook, escolhe ou cria o portfólio, informa o número e recebe o código por SMS ou ligação.
6. Defina o PIN de verificação em duas etapas, exigido no registro do número na API. Guarde o PIN: ele será pedido para trocar o PIN ou apagar o número.
7. Configure o perfil comercial de novo, já na plataforma.

Caminho 2: coexistência entre o app e a API

Na coexistência, a empresa conecta o número do app WhatsApp Business à Cloud API sem apagar a conta. As mensagens enviadas e recebidas ficam espelhadas entre os dois: a equipe pode continuar respondendo um a um no celular enquanto a API cuida de automação e envios em volume.

Requisitos e o que é sincronizado

• App WhatsApp Business na versão 2.24.17 ou superior.
• Onboarding feito por um parceiro da Meta que habilite esse fluxo no cadastro incorporado.
• Contatos que têm WhatsApp podem ser sincronizados.
• Conversas dos últimos 6 meses podem ser sincronizadas, se a empresa autorizar.

O que muda no app

• Mensagens temporárias, visualização única e localização em tempo real ficam desativadas nas conversas individuais.
• Listas de transmissão viram somente leitura e não é possível criar novas.
• Grupos não são suportados nem sincronizados.
• Dispositivos conectados como o WhatsApp para Windows e o WearOS são desconectados.
• O celular principal precisa ser aberto com regularidade: depois de cerca de 14 dias sem uso, a conexão é desfeita.

Na cobrança, mensagens enviadas pelo app continuam gratuitas, e as enviadas pela Cloud API seguem a tabela da Meta. Para se desconectar, a empresa usa o próprio app, em Configurações > Conta > Business Platform.

O que se mantém e o que se perde

Depois da migração: como verificar se deu certo

1. Status do número: no WhatsApp Manager, o número precisa aparecer como conectado para enviar e receber mensagens pela API.
2. Teste de entrada: mande uma mensagem de outro celular e confira se ela chega na plataforma.
3. Teste de resposta: responda pela plataforma dentro da janela de 24 horas e veja se chega ao celular de teste.
4. Template de teste: envie um template aprovado para um contato da equipe.
5. Nome de exibição: confira se foi aprovado.
6. Limite de envio: anote o limite atual. Contas novas começam com 250 destinatários únicos em 24 horas fora da janela de atendimento, segundo a documentação de limites. Detalhamos isso em janela de 24 horas e limite de mensagens.

Nos primeiros dias, acompanhe a qualidade do número e as primeiras respostas dos clientes. Se o seu plano é usar um agente de IA logo de cara, veja como dividir o trabalho entre IA e equipe em IA para WhatsApp.

Erros comuns na migração

• Apagar a conta sem backup e perder conversas com combinados importantes.
• Migrar sem acesso ao chip: sem o código de verificação, o número fica parado no meio do caminho.
• Trocar no horário de pico, deixando clientes sem resposta durante a configuração.
• Não avisar a equipe de que o atendimento passa a ser feito na plataforma.
• Planejar uma campanha grande no primeiro dia, sem considerar o limite inicial de envio.
• Perder o PIN de verificação em duas etapas.

Se a ideia era só começar rápido, sem burocracia, existe também a conexão via WhatsApp Web, com riscos diferentes. Comparamos as opções em WhatsApp oficial vs. ferramentas não oficiais.

Perguntas frequentes sobre a migração

Os clientes percebem a mudança?

O número continua o mesmo, então eles continuam escrevendo normalmente. A diferença aparece na experiência: respostas mais rápidas, botões e, se você quiser, atendimento automático.

Quanto tempo leva?

A troca em si leva minutos. O que demora mais é o preparo: portfólio na Meta, revisão do nome de exibição, verificação da empresa e configuração da plataforma.

Preciso verificar a empresa na Meta?

Não para começar, mas a verificação é um dos caminhos para aumentar o limite de envio de 250 para 2.000 destinatários por dia. Para campanhas, vale fazer cedo.

Quanto custa depois de migrar?

Responder clientes dentro da janela de 24 horas não é cobrado pela Meta; templates são, por categoria e país. A conta completa está em quanto custa a API oficial do WhatsApp, e os planos da Nabot em preços.