Como migrar meu número do WhatsApp para a API oficial sem perder nada

Se você está procurando como migrar meu número do WhatsApp para a API oficial com medo de perder o número, o histórico ou ter que apagar a conta, respira: hoje isso não é mais necessário. Com o modo de coexistência, o mesmo número continua funcionando no app WhatsApp Business no celular e passa a funcionar também na API oficial (WhatsApp Cloud API) ao mesmo tempo. Você não perde conversas antigas e não fica sem WhatsApp em nenhum momento da conexão.

Esse é o ponto que mais gera confusão. Muita gente ainda acredita que migrar para a API significa "queimar" o número no celular. Era assim no passado. Não é mais.

Coexistência: o que mudou na prática

Antigamente, quando um número entrava na API, ele deixava de funcionar no aplicativo comum. Quem operava pelo celular perdia o acesso direto e passava a depender só de integrações. Isso assustava (com razão) qualquer empresa que já tinha uma base de clientes ativa no número.

A coexistência resolveu isso. Você conecta o número à API oficial e continua atendendo pelo app WhatsApp Business no telefone, com o histórico preservado. As duas pontas convivem: o time responde manualmente pelo celular quando quiser, e as automações, disparos de template e integrações rodam pela API.

Segundo a covercut, BSP oficial do WhatsApp, na coexistência as conversas iniciadas pelo próprio celular não têm custo de conversa, o que é ótimo para quem faz atendimento manual e quer usar a API só para o que precisa de escala.

Antes de migrar: o que você precisa ter em mãos

A migração em si é rápida, mas alguns pré-requisitos evitam retrabalho. Vale organizar isso antes de começar:

Acesso ao celular com o número que vai ser conectado, para receber o código de verificação.
Uma conta no Gerenciador de Negócios da Meta (Business Manager). Se você ainda não tem, dá para criar durante o processo.
Os dados da empresa (CNPJ, nome oficial, site) para a verificação do negócio, que ajuda a elevar limites depois.
Definir onde as mensagens da API vão ser recebidas e enviadas: uma integração própria via API REST ou uma ferramenta de atendimento como o Chatwoot.

Esse último ponto costuma pegar quem está começando. A API oficial não tem um aplicativo de conversa próprio. Ela é uma porta de comunicação. Quem conversa é a integração que você conecta em cima dela. No modo coexistência isso fica mais tranquilo, porque o app do celular ainda serve para o atendimento manual enquanto você monta o restante.

O passo a passo da migração com coexistência

O caminho oficial e seguro passa pelo fluxo de conexão da própria Meta, o Embedded Signup. É por ali que a covercut conecta os números dos clientes com suporte a coexistência. Na prática, o fluxo funciona assim:

Conta e verificação: você acessa o fluxo de conexão, faz login com sua conta Meta e seleciona (ou cria) o Business Manager da empresa.
Seleção do número: informa o número que já usa no WhatsApp Business. Como é coexistência, você não precisa desinstalar o app nem apagar a conta.
Verificação do número: a Meta envia um código para confirmar que o número é seu. Você digita e confirma ou faz a leitura do QrCode.
Autorização da coexistência: no próprio app WhatsApp Business você aprova a conexão com a API. É esse aceite que mantém o app e a API convivendo no mesmo número.
Integração ativada: com o número conectado, a plataforma passa a enviar e receber mensagens pela API, enquanto o celular segue funcionando.

Do começo ao fim, quando a documentação está em ordem, isso leva minutos. O que costuma atrasar é a verificação da empresa na Meta, que pode demorar mais e depende dos documentos estarem batendo com o registro do negócio.

O que muda no dia a dia depois de conectar

Depois que o número está na API, algumas regras da Meta passam a valer para as mensagens ativas (aquelas que você inicia). A principal é a janela de 24 horas: quando um cliente te manda mensagem, você pode responder livremente por 24 horas. Passou disso, só consegue iniciar contato com um template aprovado pela Meta.

Templates são modelos de mensagem que passam por aprovação antes do primeiro envio. Eles se dividem em três categorias: marketing, utilidade (utility) e autenticação. Quando um cliente nos procura com template rejeitado, quase sempre é porque tentou empurrar conteúdo promocional dentro de uma categoria de utilidade, ou porque o texto tinha algo que a Meta interpreta como spam. Categorize certo e escreva de forma clara que a aprovação flui.

Outro ponto novo é o opt-in. Para mandar mensagem ativa fora da janela de 24h, você precisa de consentimento do cliente. Isso não é burocracia à toa: número que dispara para quem não pediu perde qualidade rápido.

Qualidade e limites do número

A Meta classifica a qualidade do seu número em três faixas: Alta (verde), Média (amarela) e Baixa (vermelha). Qualidade baixa pode reduzir seus limites de envio ou até restringir o número. Na prática, o que mais derruba a qualidade é disparo em massa para lista fria, template mal escrito e gente marcando "bloquear" ou "denunciar".

Existem também limites diários de conversas que você inicia (os tiers de mensagens). Eles sobem conforme volume, qualidade e verificação da empresa. Os patamares mudam com o tempo, então não vale decorar número: o importante é entender que quem mantém qualidade alta e verifica a empresa destrava limites maiores mais rápido.

Quem paga o quê: o ponto que gera mais dúvida

Aqui vale separar duas cobranças que as pessoas costumam misturar.

A cobrança das mensagens é da Meta e vai direto para você. O cliente cadastra o próprio cartão na conta da Meta, e a Meta cobra por conversa (não por mensagem individual) nesse cartão. O modelo de preço da Meta muda de tempos em tempos, e na coexistência as conversas iniciadas pelo celular não geram custo.

A covercut, como BSP oficial, cobra apenas uma mensalidade fixa pelo serviço: a plataforma, a conexão do número pelo fluxo oficial da Meta com suporte a coexistência, infraestrutura e suporte. Não cobramos por mensagem, por conversa nem por template, e não intermediamos a cobrança da Meta. Essa parte é direto entre você e a Meta.

Erros comuns que atrapalham a migração

Alguns tropeços aparecem toda semana no suporte:

Achar que precisa apagar a conta: não precisa. Com coexistência o app e a API dividem o mesmo número.
Não verificar a empresa: adiar a Business Verification trava os limites lá na frente, justo quando você quer escalar.
Começar disparando marketing pesado: número novo na API sem histórico de qualidade e mandando promoção para lista comprada é receita para cair para o vermelho.
Escrever template com pressa: categoria errada e texto genérico geram rejeição. Vale caprichar no primeiro modelo.

Se você já usa o WhatsApp Business no celular e não quer arriscar o número, o próximo passo é simples: separe os documentos da empresa, defina onde vai receber as mensagens (integração própria ou Chatwoot) e conecte pelo fluxo oficial com coexistência. Assim o número entra na API sem que você perca uma única conversa no caminho.

Perguntas frequentes

Vou perder minhas conversas antigas ao migrar para a API oficial?

Não. Usando o modo de coexistência, o número é conectado à API sem apagar a conta nem desinstalar o app. O histórico de conversas no celular continua lá e você segue atendendo normalmente pelo aplicativo.

Consigo continuar usando o app do WhatsApp no celular depois de conectar a API?

Sim. Esse é o ponto central da coexistência: o app WhatsApp Business no celular e a API oficial funcionam ao mesmo tempo, no mesmo número. Seu time atende manualmente pelo telefone e as automações rodam pela API.

Preciso apagar minha conta do WhatsApp Business para usar a API?

Não é necessário. Com coexistência, apagar a conta ou desinstalar o app não faz parte do processo. Sem coexistência, o número deixaria de funcionar no app comum, mas conectando com suporte a coexistência isso não acontece.

Quem paga pelas mensagens depois da migração?

A cobrança das mensagens é feita pela Meta diretamente para você, com o seu cartão cadastrado na conta da Meta, e é por conversa, não por mensagem. A covercut cobra apenas uma mensalidade fixa pelo serviço e não repassa nem cobra por mensagem, conversa ou template.

Quanto tempo leva para migrar o número?

A conexão em si leva minutos quando os dados estão em ordem. O que pode demorar mais é a verificação da empresa na Meta, que depende dos documentos baterem com o registro do negócio, mas ela pode ser feita em paralelo enquanto o número já opera.