Migrar WhatsApp Business App para API Oficial 2026

Empresária migrando do WhatsApp Business App para a API oficial no celular e no notebook no escritório

Resposta rápida: Para migrar do WhatsApp Business App para a API oficial em 2026 sem trocar de número, o caminho é o Coexistence: você registra o mesmo número na Cloud API via Embedded Signup e habilita a coexistência no Meta Business Manager. App e API passam a rodar no mesmo número, com sincronia entre os dois lados e importação de até cerca de 6 meses do histórico de conversas individuais. O onboarding leva poucos minutos; a sincronia do histórico roda em segundo plano por algumas horas.

· espaço publicitário ·

Em resumo

O Coexistence deixa o WhatsApp Business App e a Cloud API oficial funcionarem no MESMO número ao mesmo tempo — você não precisa mais escolher um ou outro.
Durante o onboarding dá para importar cerca de 6 meses do histórico de conversas individuais; grupos não sincronizam.
O cadastro é feito pelo Embedded Signup (pop-up da Meta) direto ou dentro do painel de um BSP, e leva de 5 a 15 minutos.
A sincronia do histórico não é instantânea: roda em segundo plano por algo entre 4 e 6 horas.
Fora da janela de 24h você passa a depender de template aprovado para iniciar conversa — essa é a maior mudança de rotina.
Ponta a ponta, contando verificação e propagação, a Meta indica de 1 a 3 dias úteis.

1. Confirme que você realmente precisa da API (e não só do App)
O WhatsApp Business App resolve bem quem atende sozinho ou com uma equipe pequena no celular. A API oficial existe para quem precisa de vários atendentes no mesmo número, integração com CRM/n8n, disparo de templates em escala e limites de envio maiores. Se o seu gargalo é 'só cabe um celular e uma pessoa por vez', é sinal de migração. Se não é, talvez você só precise organizar o App. Decidir isso antes evita pagar por conversa e por BSP sem necessidade.
2. Deixe a conta Meta Business e a verificação em ordem
Acesse business.facebook.com e confira se existe um Business Portfolio com o nome jurídico, endereço, site e telefone da empresa preenchidos corretamente. Dado incompleto aqui é o motivo número um de registro travado depois. Só quem é proprietário ou administrador do portfólio conclui o cadastro, porque o fluxo usa o Facebook Login. Se a empresa ainda não é verificada pela Meta, comece a verificação — na primeira vez ela costuma levar alguns dias úteis.
3. Faça um backup do que está só no celular
Aqui vale um cuidado que muita gente pula: o histórico que fica salvo no aparelho é seu, e o Coexistence importa apenas o período recente de conversas individuais. Grupos não vão. Antes de mexer, salve etiquetas, respostas rápidas, catálogo e qualquer conversa crítica que você não pode perder. É rápido e te tira do risco de descobrir tarde demais que algo ficou de fora.
4. Registre o mesmo número na Cloud API via Embedded Signup
O Embedded Signup é o pop-up hospedado pela Meta, aberto na conta de desenvolvedor (developers.facebook.com) ou dentro do painel de um BSP certificado. Nele você seleciona o Business Portfolio, cria ou vincula a conta do WhatsApp Business (WABA) e informa o mesmo número que está no App. Quando o fluxo oferece a opção de coexistência, é ela que preserva o número e o histórico — não escolha 'novo número' se a intenção é manter o seu. O passo em si leva de 5 a 15 minutos.
5. Habilite o Coexistence e espere a sincronia rodar
Confirmado o registro, o Coexistence espelha as mensagens entre o App e a Cloud API e puxa até cerca de 6 meses das conversas 1:1 para o ambiente conectado. Essa sincronia não é instantânea — roda em segundo plano por volta de 4 a 6 horas. Nesse período, continue atendendo normalmente pelo celular; nada trava. Só não estranhe se o histórico completo demorar a aparecer no CRM: é o processo terminando de propagar.
6. Recrie templates, conecte o CRM e valide antes de escalar
Na API você não manda texto livre para iniciar conversa fora da janela de 24h: precisa de template aprovado pela Meta. Recrie no Meta Business Manager (ou no BSP) os modelos equivalentes ao que você disparava, separados por categoria — marketing, utilidade e autenticação. Aponte os webhooks do CRM/n8n para a Cloud API, mande mensagens de teste para números seus e confira o registro nos dois lados. Só libere para a base quando entregabilidade e resposta dentro da janela estiverem estáveis.

O que mudou: agora não é mais 'App ou API'

Durante anos, migrar do WhatsApp Business App para a API oficial era um divórcio: ou você ficava no aplicativo do celular, ou levava o número para a API e perdia o atendimento manual simples. Quem tinha o número principal da empresa no App muitas vezes travava aí, com medo de perder histórico e de complicar a rotina de quem responde no dia a dia.

O Coexistence, que a Meta liberou de forma ampla ao longo de 2025 e consolidou em 2026, quebrou essa escolha. Ele deixa o WhatsApp Business App e a Cloud API funcionarem no mesmo número, ao mesmo tempo. Na prática: o dono ou o atendente segue respondendo pelo celular quando quer, e o time, os bots e o CRM operam pela API — sem dois números, sem dois aparelhos.

Histórico: o que vem junto e o que fica para trás

Essa é a dúvida que trava mais gente. A resposta honesta: o Coexistence importa até cerca de 6 meses das suas conversas individuais durante o onboarding, e daí em diante espelha o que entra e sai dos dois lados. Isso é continuidade, não arquivo completo — a ideia é você não começar do zero, não guardar tudo desde sempre.

O que não sincroniza: grupos ficam de fora, alguns tipos de mensagem podem não passar, e recursos como editar ou apagar mensagem deixam de valer nesse modo. Mensagens respondidas só pelo celular continuam salvas localmente; as que passam pela API ficam registradas também na plataforma conectada. Por isso o backup do passo 3 não é firula: é o que garante que nada crítico se perca no caminho.

Aspecto	WhatsApp Business App (saindo do isolamento)	API oficial via Coexistence (chegando)
Número	O mesmo	O mesmo, sem troca
Atendimento manual no celular	Sim	Continua funcionando junto com a API
Vários atendentes / CRM	Não	Sim, pela API
Histórico individual	Fica no aparelho	Importa ~6 meses no onboarding
Grupos	Funcionam no App	Não sincronizam
Iniciar conversa fora da janela de 24h	Texto livre	Só com template aprovado

Quanto tempo leva de verdade

O Embedded Signup em si é rápido: de 5 a 15 minutos para registrar o número. A sincronia do histórico roda depois, em segundo plano, por algo entre 4 e 6 horas. E o processo completo — contando verificação da empresa, aprovação e propagação — a Meta estima entre 1 e 3 dias úteis quando a conta já está com os dados em ordem.

O gargalo quase nunca é o cadastro técnico. É a verificação da empresa na Meta na primeira vez e a aprovação dos templates. Por isso o conselho de sempre: resolva a parte burocrática antes, deixe os templates prontos para submeter, e o dia da migração vira quase um detalhe operacional.

Coexistence não serve para todo mundo

Um ponto que vale deixar claro para não gerar frustração: o Coexistence é a ponte para quem está no WhatsApp Business App oficial. Quem opera hoje por uma API não oficial baseada em WhatsApp Web (Evolution, Z-API e afins) não tem coexistência — nesse caso a transição é um corte, com planejamento em paralelo, e o histórico local não vai junto.

Se esse é o seu caso, o roteiro é outro. E se você ainda está decidindo entre continuar no App ou partir para a API, vale entender antes as diferenças reais de cada um e o custo por conversa, para não migrar por modismo e sim por necessidade.

Perguntas frequentes

Consigo manter o mesmo número ao migrar do App para a API oficial?

Sim. É exatamente para isso que o Coexistence existe: você registra o mesmo número da conta do WhatsApp Business App na Cloud API e passa a operar nos dois ambientes ao mesmo tempo, sem trocar de número e sem parar o atendimento pelo celular.

Vou perder o histórico de conversas do aplicativo?

Não todo. Durante o onboarding, o Coexistence importa cerca de 6 meses das suas conversas individuais para a plataforma conectada e passa a espelhar as novas. Grupos e alguns tipos de mensagem não sincronizam, então faça um backup do que for crítico antes de começar.

Preciso de um BSP para fazer essa migração?

Não obrigatoriamente. Empresas com equipe técnica podem registrar direto pela conta de desenvolvedor da Meta via Embedded Signup. Sem equipe técnica, um BSP certificado facilita o cadastro, os disparos de template e o suporte. Em ambos os casos, o Embedded Signup é o fluxo de onboarding padrão.

Depois de migrar, ainda posso responder pelo celular?

Sim. Essa é a graça do Coexistence: o WhatsApp Business App continua funcionando no mesmo número enquanto a API atende o time e as automações. Só lembre que, fora da janela de 24h, iniciar conversa passa a exigir template aprovado pela Meta.

Fontes