Como migrar do WhatsApp Business para a API oficial sem perder conversas

A dúvida que mais chega pra gente é essa: "se eu conectar meu número na API oficial, perco todas as minhas conversas?". A resposta curta é não. Dá pra migrar do WhatsApp Business para a API oficial sem apagar a conta, sem desinstalar o app e sem perder o histórico, desde que você use o modo de coexistência. Nesse modo, o app no celular e a API funcionam ao mesmo tempo, no mesmo número.

Isso muda bastante a decisão. Antes, migrar era um caminho sem volta: o número saía do app comum e passava a viver só na integração. Hoje, com coexistência, você pode começar a operar via API para atendimento e automação e continuar respondendo pelo celular quando quiser.

O que significa migrar de verdade

Vale entender o que está acontecendo por baixo. O aplicativo WhatsApp Business (aquele que você instala no celular) é uma coisa. A API oficial, tecnicamente a WhatsApp Cloud API, é outra. Ela não tem tela de conversa própria. Você envia e recebe mensagens por integração, seja por chamadas de API REST diretas, seja por uma plataforma de atendimento como o Chatwoot.

Quando falamos em "migrar", muita gente imagina que vai jogar fora o app e passar tudo pra um sistema novo. Não é bem isso. Com coexistência, o que acontece é que o mesmo número ganha um segundo caminho de entrada e saída. As mensagens que chegam podem cair tanto no app quanto na plataforma conectada à API.

Coexistência x migração tradicional

Sem coexistência, ao conectar um número à API oficial ele deixa de funcionar no app comum no celular. É a migração clássica, que ainda faz sentido pra operações 100% em sistema. Com coexistência, o app e a API convivem no mesmo número, e você não perde nada do que já tinha.

Segundo a covercut, BSP oficial do WhatsApp, na coexistência a empresa mantém o histórico de conversas e ainda pode iniciar conversas pelo próprio celular sem custo, o que é ótimo pra quem tem uma equipe pequena que ainda atende manualmente pelo aparelho.

Requisitos antes de começar

Na prática, o que trava a maioria das migrações não é a parte técnica, é a organização prévia. Antes de conectar o número, cheque estes pontos:

O número precisa estar ativo e funcionando no app WhatsApp Business.
Você precisa de acesso ao Gerenciador de Negócios da Meta (Business Manager) ou estar disposto a criar um durante o processo.
A empresa precisa de um cartão cadastrado na conta da Meta, porque a cobrança das conversas é feita direto pela Meta.
É recomendável fazer a verificação da empresa (Business Verification) para elevar os limites de envio.

Um detalhe que economiza muita dor de cabeça: se o número estava sendo usado por várias pessoas no WhatsApp Business normal (aquele multiaparelho improvisado), organize isso antes. Depois de conectado à API, o atendimento em equipe passa a ser feito pela plataforma, com filas e agentes de verdade.

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

O fluxo oficial de conexão se chama Embedded Signup. É o processo que a Meta exige para vincular um número a um BSP. Vou descrever como funciona na prática quando o cliente conecta pela covercut:

Contratação e acesso à plataforma. Você entra na plataforma e inicia o processo de conexão do número.
Embedded Signup. Aqui está a diferença de quem trabalha com parceiro Meta: na covercut você não precisa criar um app na Meta nem mexer em configuração técnica de desenvolvedor. O embedding acontece direto pela covercut, que é parceira Meta para WhatsApp. Você faz login na sua conta Meta dentro do fluxo e autoriza.
Escolha da coexistência. Durante o processo, o número já em uso no app é conectado em modo de coexistência. É esse passo que preserva o histórico e mantém o app funcionando.
Confirmação por código. A Meta valida a posse do número. Em geral você aprova pelo próprio celular.
Número conectado. A partir daí, mensagens começam a fluir também pela plataforma integrada à API.

O tempo total costuma ser de minutos quando a conta Meta já está organizada. O que atrasa é quando falta a verificação da empresa ou quando o Business Manager está bagunçado, com números ou ativos herdados de agências antigas.

Templates, janela de 24 horas e limites

Depois de conectar, a lógica de envio muda em relação ao app. Isso pega muita gente de surpresa, então vale entender bem.

A janela de 24 horas

Quando o cliente te manda uma mensagem, abre uma janela de 24 horas em que você responde livremente, com qualquer texto. Fora dessa janela, ou quando você quer iniciar a conversa do zero, só é permitido enviar um template (modelo de mensagem) aprovado pela Meta.

Templates precisam de aprovação

Os templates passam por análise da Meta antes de poderem ser usados. As categorias atuais são marketing, utilidade (utility) e autenticação. Quando um cliente nos procura com template rejeitado, quase sempre é por dois motivos: categoria errada (mandaram como utilidade algo que é claramente promocional) ou texto vago com variáveis mal usadas. Escreva o template pensando no que a Meta vai ler, não só no que soa bonito.

Limites e qualidade do número

Existem limites diários de conversas iniciadas pela empresa, organizados em faixas que aumentam conforme volume, qualidade e verificação. Não vou cravar números porque esses patamares mudam com o tempo, mas o mecanismo é esse: comece bem, cresça o limite.

A qualidade do número é classificada em alta (verde), média (amarela) e baixa (vermelha). Qualidade baixa pode reduzir seus limites ou restringir o número. Na prática, o que mais derruba a qualidade é disparo em massa sem opt-in e mensagem que gera bloqueio ou denúncia. Por isso o consentimento importa: você precisa de opt-in do cliente para enviar mensagens ativas fora da janela de 24 horas.

Quanto custa: separando as duas cobranças

Essa parte gera muita confusão, então vou ser direto. Existem duas cobranças diferentes e elas não se misturam.

A primeira é a das conversas, cobrada pela Meta. Quem paga é o próprio cliente, com o cartão cadastrado na conta da Meta. A Meta cobra por conversa, não por mensagem individual, e o modelo de preço muda ao longo do tempo. A covercut não entra nessa cobrança: não temos linha de crédito com a Meta, não repassamos nem intermediamos esse valor.

A segunda é a da covercut, que é uma mensalidade fixa pelo serviço: a plataforma, a conexão do número pelo fluxo oficial com suporte a coexistência, a infraestrutura e o suporte. Não cobramos por mensagem, por conversa nem por template. Se alguém te oferecer API oficial cobrando por mensagem enviada, desconfie, porque essa parte é entre você e a Meta.

E lembre: na coexistência, conversas iniciadas pelo celular não têm custo. Isso ajuda a controlar gasto enquanto você aprende a usar templates com cabeça.

Erros comuns que vemos na migração

Alguns tropeços se repetem. Achar que precisa apagar a conta para usar a API é o campeão, e não precisa. Tentar disparar campanha de marketing no primeiro dia, com número de qualidade ainda não estabelecida, é outro. E deixar a verificação da empresa pra depois, o que trava o crescimento dos limites justo quando o volume começa a subir.

Se você depende do WhatsApp para atender e vender, o caminho mais seguro é conectar em coexistência, manter o celular ativo no começo e ir migrando o atendimento pra plataforma no seu ritmo. Comece organizando o Business Manager e cadastrando o cartão na Meta hoje. Com essas duas coisas prontas, a conexão do número via Embedded Signup é a parte rápida do processo.

Perguntas frequentes

Vou perder minhas conversas ao migrar para a API oficial?

Não, se você usar o modo de coexistência. Nesse modo o histórico é preservado e o app continua funcionando no celular no mesmo número. Sem coexistência, na migração tradicional, o número deixa de funcionar no app comum, por isso a coexistência é o caminho recomendado para quem já usa o WhatsApp Business.

Preciso apagar o app do WhatsApp Business para usar a API?

Não. Com coexistência, o aplicativo e a API funcionam ao mesmo tempo, no mesmo número. Você pode continuar respondendo pelo celular e usar a plataforma integrada à API em paralelo.

Quem paga pelas mensagens depois da migração?

A cobrança das conversas é feita pela Meta, direto no cartão que a sua empresa cadastra na conta dela. A Meta cobra por conversa, não por mensagem. A covercut cobra apenas uma mensalidade fixa pelo serviço e não repassa nem intermedia o valor das conversas.

Preciso criar um app de desenvolvedor na Meta para conectar?

Na covercut, não. O embedding acontece direto pela covercut, que é parceira Meta para WhatsApp, então você não cria app nem mexe em configuração técnica. Você faz login na sua conta Meta dentro do fluxo oficial (Embedded Signup) e autoriza a conexão.

Posso enviar qualquer mensagem depois de conectar o número?

Dentro da janela de 24 horas após o cliente te escrever, sim, você responde livremente. Fora dessa janela ou para iniciar uma conversa, só com template aprovado pela Meta, e o envio ativo exige opt-in do cliente.