Como migrar do WhatsApp Business para a API sem perder nada

Para migrar o WhatsApp Business para a API oficial você não precisa trocar de número nem começar do zero: o processo é fazer o backup das conversas, desvincular o número do aplicativo, registrá-lo na Cloud API da Meta, ativá-lo na sua plataforma de atendimento e avisar os clientes de que nada muda do lado deles. Feito na ordem certa, a migração leva algumas horas e você mantém o mesmo número, os contatos e a operação rodando. Este guia mostra cada etapa e responde de frente os dois medos clássicos: "perco o número?" e "perco o histórico?".

Antes de começar: a API oficial (Cloud API) é a interface da Meta para empresas conectarem o WhatsApp a plataformas como a ClickDesk. Se ainda tem dúvida sobre a diferença entre o app e a API, vale ler o comparativo entre WhatsApp Business e API antes de seguir.

Antes de migrar: responda os dois medos clássicos

"Vou perder meu número?" Não. O mesmo número que hoje está no app é o que você registra na API. Ele continua sendo seu, com o mesmo DDD e a mesma identidade que os clientes já conhecem. O que muda é onde você atende: em vez do aplicativo verde no celular, você passa a atender pela plataforma, no navegador.

"Vou perder o histórico de conversas?" As mensagens antigas ficam no aparelho, não na nuvem da Meta — por isso a API não "puxa" automaticamente o que já passou. Mas você não perde o contexto: faz o backup das conversas e importa os contatos para o CRM da plataforma antes de desvincular. Da migração em diante, todo o histórico passa a ser centralizado e auditável, com o benefício extra de não ficar mais preso a um único celular.

Guarde estas duas respostas — elas são exatamente o que a sua equipe e seus clientes vão perguntar.

Passo 1: faça o backup das conversas e exporte os contatos

Antes de mexer em qualquer configuração, preserve o que já existe.

• Backup do WhatsApp Business: entre em Configurações → Conversas → Backup de conversas e force um backup manual (Google Drive no Android, iCloud no iPhone). Isso guarda o conteúdo das conversas caso você precise consultar algo depois.
• Exporte conversas críticas: para clientes importantes, use Configurações → Conversas → Histórico de conversas → Exportar conversa e salve o arquivo. É o seu registro pontual de negociações em aberto.
• Reúna os contatos: exporte a agenda comercial (contatos do Google/telefone) em CSV. São eles que você vai importar para o CRM para não perder o vínculo com nenhum cliente.

Dica prática: faça esse backup no mesmo dia da migração, não uma semana antes. Assim você não perde as conversas que entraram nesse intervalo.

Passo 2: prepare a conta no Meta Business

A API exige uma conta comercial na Meta. Se você ainda não tem, crie no business.facebook.com com o e-mail da empresa. Você vai precisar de:

• Uma conta do Meta Business Manager ativa;
• O CNPJ e os dados da empresa para a verificação;
• Um número de telefone que não esteja registrado em outra conta de API.

Deixe esses dados à mão. A verificação do negócio na Meta é o que libera limites maiores de conversas ativas e o selo de conta comercial verificada — vale iniciar cedo, porque a análise pode levar de algumas horas a alguns dias.

Passo 3: desvincule o número do app WhatsApp Business

Este é o ponto que gera mais receio, mas é direto. Um número não pode estar ativo no app e na API ao mesmo tempo. Para registrá-lo na Cloud API, ele precisa sair do aplicativo.

1. Confirme que o backup do Passo 1 está concluído;
2. No app WhatsApp Business, vá em Configurações → Conta → Excluir minha conta para liberar o número — ou, dependendo do caso, apenas desconecte-o no momento do registro na API, quando o sistema pedir;
3. Tenha o celular com o chip em mãos: você vai receber o código de verificação de 6 dígitos por SMS ou ligação.

Não pule o backup antes desta etapa. Depois que o número sai do app, o acesso ao histórico local depende do backup que você fez. É a razão de o Passo 1 vir primeiro.

Passo 4: registre e verifique o número na Meta

Com o número liberado, faça o registro na Cloud API. Na prática, a plataforma de atendimento conduz isso para você — no ClickDesk, o fluxo é guiado tela a tela:

1. Conecte sua conta do Meta Business ao ClickDesk;
2. Informe o número que vai virar oficial;
3. Receba o código de 6 dígitos por SMS ou ligação e confirme;
4. Aguarde a confirmação de registro na Meta.

A verificação do negócio (com CNPJ) roda em paralelo. Ela não bloqueia o início do atendimento — você já começa a receber e responder mensagens —, mas é o que amplia seus limites de envio ativo e habilita o selo verificado. O passo a passo técnico completo está no nosso guia da API oficial do WhatsApp.

Passo 5: ative o número na plataforma de atendimento

Registrado o número, ele aparece conectado na plataforma e as conversas passam a cair na caixa de entrada. Aproveite este momento para configurar o que o app nunca ofereceu:

• Importe os contatos exportados no Passo 1 para o CRM, recuperando o contexto de cada cliente;
• Distribua o atendimento entre vários atendentes no mesmo número, com filas e responsável por conversa — o problema de "quem respondeu o quê" desaparece. Veja como funciona WhatsApp com vários atendentes;
• Cadastre os templates de reengajamento (para falar fora da janela de 24 horas) e envie-os para aprovação da Meta;
• Configure um agente de IA no flow builder para triagem e respostas fora do horário, com o copiloto ajudando o time nas respostas.

Aqui está o ganho real da migração: o WhatsApp deixa de ser um canal isolado no celular e entra no mesmo fluxo omnichannel de e-mail, chat e telefone, com histórico único por cliente.

Passo 6: comunique os clientes (spoiler: nada muda para eles)

A parte boa da migração bem-feita é que, do lado do cliente, é invisível. Mesmo número, mesma conversa, mesmo contato salvo na agenda dele. Ainda assim, uma comunicação simples evita ruído:

• Dispare um aviso pelos canais habituais informando que o atendimento no WhatsApp ficou mais rápido e agora responde em horário estendido;
• Atualize assinaturas de e-mail, site e redes caso você exiba o número — ele continua o mesmo, mas é um bom momento para revisar;
• Alinhe a equipe interna: todo mundo atende agora pela plataforma, não pelo celular. Deixe claro onde ficam as filas e como transferir uma conversa.

Checklist rápido da migração

Quanto custa e quando vale a pena

A Meta não cobra mensalidade pela Cloud API: você paga por conversa iniciada pela empresa, mais a plataforma de atendimento. No ClickDesk, os planos começam em R$49 por agente/mês (Essencial), R$119 (Profissional) e R$219 (Avançado), com 20% de desconto no anual e trial de 14 dias sem cartão. O detalhamento dos custos de mensagem está em quanto custa a API do WhatsApp.

A migração vale a pena assim que você tem mais de um atendente no mesmo número, precisa de automação de verdade ou quer parar de correr risco de banimento por usar ferramenta não oficial por cima do app.

Migre com quem faz o processo por você

Migrar do WhatsApp Business para a API não é um salto no escuro: é uma sequência de passos com backup na frente e número preservado no fim. O que costuma travar as empresas é a parte técnica da Meta — e é exatamente aí que uma plataforma que conduz o registro faz diferença.

O ClickDesk cuida da migração de ponta a ponta: conecta seu número oficial, aprova os templates, importa seus contatos para o CRM e coloca o time e os agentes de IA para atender — em português e com suporte brasileiro. Veja o passo a passo assistido na nossa página de migração ou conheça o WhatsApp oficial no ClickDesk.

Comece a migração do seu número →