Migrar de Evolution API para Cloud API Oficial WhatsApp 2026

Profissional migrando de Evolution API para a Cloud API oficial do WhatsApp em notebook no escritório

Resposta rápida: Migrar da Evolution API para a Cloud API oficial não é uma portabilidade automática: o número precisa ser cadastrado do zero na plataforma da Meta, e a Evolution roda sobre o WhatsApp Web, sem transferência direta. O caminho seguro é rodar os dois ambientes em paralelo, cadastrar o número na Cloud API via Embedded Signup (por um BSP ou pela conta de desenvolvedor Meta), validar templates e disparos, e só então desativar a Evolution. O histórico local de conversas da Evolution não migra.

· espaço publicitário ·

Em resumo

Não é portabilidade: a Evolution usa o WhatsApp Web; a Cloud API exige cadastrar o número na infraestrutura oficial da Meta.
O caminho padrão de cadastro em 2026 é o Embedded Signup — um pop-up da Meta via Facebook Login, feito por você direto ou dentro do painel de um BSP.
O mesmo número não pode ficar ativo na Evolution (WhatsApp Web) e na Cloud API ao mesmo tempo — há uma janela de corte no momento do registro.
Rode Evolution e Cloud API em paralelo o máximo possível: só desligue a Evolution depois que templates e fluxos estiverem validados na oficial.
O histórico de conversas guardado na Evolution não é transferido para a Cloud API — exporte ou registre o que for crítico antes.
Na Cloud API você passa a operar por regras: janela de 24h para mensagem livre e template aprovado para iniciar conversa fora dela.

1. Mapeie o que a Evolution faz hoje antes de mexer em nada
Liste tudo que sua instância Evolution executa: fluxos de disparo, webhooks conectados ao CRM ou ao n8n, mensagens automáticas, número de contatos ativos e volume diário. Isso vira seu checklist de validação depois. Anote também o que é opt-in real (quem autorizou receber) — porque na Cloud API você vai precisar disso para não ter template reprovado nem quality rating baixo. Sem esse inventário, a migração vira tentativa e erro no ar.
2. Prepare a conta no Meta Business Manager e a verificação da empresa
Acesse business.facebook.com e garanta uma conta Meta Business (Business Portfolio) com o nome jurídico, endereço, site e telefone da empresa preenchidos corretamente. Informação incompleta aqui trava o registro do WhatsApp depois. Só o proprietário ou administrador do portfólio consegue concluir o cadastro, porque o fluxo usa o Facebook Login. Se a empresa ainda não é verificada pela Meta, inicie a verificação — ela pode levar de 7 a 14 dias úteis na primeira vez.
3. Decida: número novo ou o mesmo número da Evolution
Aqui está a decisão que define o resto. Se o número da Evolution é o contato oficial que seus clientes já conhecem, você vai querer levá-lo para a Cloud API — mas isso significa desconectá-lo do WhatsApp Web/Evolution no momento do cadastro. Se preferir risco zero de downtime, cadastre um número novo na Cloud API, teste tudo e migre a comunicação aos poucos. Para operações que não podem parar, número novo em paralelo é o caminho mais tranquilo.
4. Cadastre o número na Cloud API via Embedded Signup
Desde 2026, o Embedded Signup é o caminho padrão: um pop-up hospedado pela Meta, aberto direto na sua 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 registra o número, confirmando por SMS ou chamada. Se estiver migrando o número que estava na Evolution, é neste ponto que ele deixa de responder pelo WhatsApp Web — por isso faça em horário de baixo movimento.
5. Recrie templates e reconecte os webhooks
Na Cloud API você não dispara texto livre para iniciar conversa: precisa de templates HSM aprovados pela Meta. Recrie no Meta Business Manager (ou no BSP) os modelos equivalentes aos disparos que a Evolution fazia, separados por categoria — marketing, utilidade e autenticação. Em paralelo, aponte os webhooks do seu CRM/n8n para os endpoints da Cloud API. Envie mensagens de teste para números seus, valide o recebimento e o registro no CRM, e só então libere para a base.
6. Rode em paralelo, valide e só então desligue a Evolution
Não corte a Evolution no mesmo dia (a menos que esteja migrando o mesmo número, caso em que o corte é forçado no passo 4). Deixe os dois ambientes convivendo enquanto você confere entregabilidade, respostas dentro da janela de 24h, aprovação de templates e estabilidade dos fluxos. Migre os clientes menos críticos primeiro. Quando as métricas estiverem estáveis por alguns dias, aí sim desative a instância Evolution — e guarde um backup do que precisar.

Por que 'migrar' aqui não é portabilidade

Muita gente imagina que dá para apertar um botão e transferir tudo da Evolution API para a Cloud API. Não é assim. A Evolution é uma camada não oficial que funciona espelhando uma sessão do WhatsApp Web — ela não tem vínculo nenhum com a infraestrutura da Meta. A Cloud API, ao contrário, é a plataforma oficial hospedada pela própria Meta. São dois mundos que não conversam entre si.

Na prática, isso quer dizer que o número precisa ser registrado do zero na Cloud API, e um número não pode estar ativo nos dois lugares ao mesmo tempo. No instante em que você cadastra o número na oficial, ele para de funcionar pelo WhatsApp Web onde a Evolution estava plugada. É por isso que a escolha entre 'mesmo número' e 'número novo' pesa tanto no planejamento.

Se você ainda está decidindo se vale a pena sair da Evolution, vale revisar o risco real de banimento dela antes — em ferramentas baseadas em WhatsApp Web, a Meta pode banir o número sem aviso quando detecta automação em volume.

O que você ganha e o que você perde na migração

O ganho principal é previsibilidade: na Cloud API o número não é banido só por estar conectado a uma automação, porque a conexão é autorizada pela Meta. Você passa a ter limites de envio documentados, templates aprovados e quality rating visível. A operação deixa de andar no fio da navalha.

A perda mais sentida é o histórico. As conversas guardadas na sua instância Evolution não migram para a Cloud API — se algo ali é importante, exporte antes. Você também troca a liberdade de mandar qualquer texto a qualquer hora pela disciplina das regras da Meta: fora da janela de 24h, só template aprovado. Para quem fazia disparo em massa solto, essa é a maior mudança de rotina.

Aspecto	Evolution API (saindo)	Cloud API oficial (chegando)
Conexão	WhatsApp Web (não oficial)	Infraestrutura Meta (oficial)
Risco de ban por automação	Real, sem aviso	Zero por conexão
Início de conversa	Texto livre	Template HSM aprovado
Histórico anterior	Fica na instância	Não migra
Limites de envio	Informais / arriscados	Documentados por tier
Custo	Servidor + chip	Por template entregue + BSP

Coexistência: existe algo parecido?

A Meta oferece um recurso chamado Coexistence, que deixa o WhatsApp Business App e a Cloud API rodarem no mesmo número, com sincronia dos dois lados e até 6 meses de histórico importado. É ótimo — mas é para quem sai do WhatsApp Business App oficial, não da Evolution.

Como a Evolution não é um app oficial, não há coexistência com ela: a transição é um corte, não uma convivência sincronizada. Por isso o planejamento em paralelo (número novo ou horário de baixo movimento) é o que mais aproxima você de uma migração sem trauma.

Perguntas frequentes

Consigo manter o mesmo número ao migrar da Evolution para a Cloud API?

Sim, mas com um corte. O número precisa ser registrado na Cloud API, e nesse momento ele deixa de responder pelo WhatsApp Web onde a Evolution estava conectada. Não dá para ficar ativo nos dois ao mesmo tempo. Faça o registro em horário de baixo movimento para reduzir o impacto no atendimento.

O histórico de conversas da Evolution vai para a Cloud API?

Não. As conversas guardadas na instância Evolution não são transferidas para a plataforma oficial da Meta. A Cloud API começa do zero para aquele número. Se houver conversas ou dados críticos, exporte antes de iniciar a migração.

Quanto tempo leva para migrar?

O registro do número na Cloud API costuma levar cerca de uma a duas horas quando a empresa já está verificada. O gargalo é a verificação da empresa na Meta (7 a 14 dias úteis na primeira vez) e a aprovação dos templates. Rodar em paralelo até validar tudo pode levar alguns dias, e isso é saudável.

Preciso de um BSP para migrar?

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

Fontes