Evolution API ou API oficial do WhatsApp: qual escolher para o seu bot com IA?

Fala aí, beleza? Todo bot de WhatsApp com IA trava na mesma bifurcação: subir rápido pelo Baileys ou entrar pela porta oficial da Meta

E tem um detalhe que muita gente não sabe antes de escolher: a Evolution API não é o oposto da API oficial

Ela é open source e suporta os DOIS caminhos na mesma API: canal Baileys (WhatsApp Web, não oficial), canal oficial WhatsApp Cloud API da Meta e ainda o Evolution Channel

Ou seja, a decisão real não é "ferramenta A x ferramenta B"

A decisão é sobre três coisas: quanto custa a mensagem, qual o risco de o número cair e quando migrar de um canal pro outro

Bora destrinchar isso? 😀

Evolution API (Baileys) x API oficial do WhatsApp: comparação lado a lado

Antes de qualquer conta, vale colocar os dois canais na mesma mesa

Repare que a comparação é entre CANAIS, e não entre projetos: os dois cabem dentro da Evolution API

Olhando assim já dá pra sentir o trade: de um lado você troca dinheiro por risco, do outro você troca risco por dinheiro

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

O que mudou na cobrança da API oficial do WhatsApp

Se você tinha uma planilha de custo de 2024 guardada, joga fora

A régua mudou várias vezes, e as datas importam:

• 1º de julho de 2025: a cobrança deixou de ser por conversa e passou a ser por mensagem entregue, definida por categoria de template, mercado do destinatário e faixa de volume
• 1º de julho de 2026: começou o faturamento local em reais, contas WhatsApp Business novas de clientes com país de venda Brasil podem ser criadas em BRL e são faturadas pela entidade local Facebook Brasil
• 1º de outubro de 2026: mensagens de serviço passam a ser cobradas por mensagem, ou seja, acaba a gratuidade da janela de 24 horas, e mensagens de utilidade respondidas dentro da mesma janela também passam a ser cobradas

E tem uma trava boa nisso tudo: preço na plataforma oficial só muda no primeiro dia de cada trimestre, no máximo quatro vezes por ano

Não é pouco, mas é previsível, tu consegue planejar

Quanto custa hoje mandar mensagem pela API oficial no Brasil

Agora a parte que interessa pro bolso, com destinatário no Brasil:

• Mensagem de marketing: US$ 0,0625 por mensagem
• Mensagem de utilidade: US$ 0,0068 por mensagem

A diferença entre as duas categorias é quase dez vezes, então a pergunta "que tipo de mensagem meu bot dispara?" vale mais que a pergunta "qual API eu uso?"

Mensagens que não são template, enviadas dentro da janela de atendimento de 24 horas, ainda são gratuitas hoje, em agosto de 2026

Gratuitas COM data de validade já marcada, lembra do 1º de outubro de 2026 ali em cima

Tem também a janela de entrada gratuita de 72 horas: quando o cliente chega por anúncio que clica para o WhatsApp ou por botão de CTA da Página do Facebook e a empresa responde em até 24 horas, abre uma conversa gratuita de 72 horas

Essa aqui não foi afetada pela mudança de outubro de 2026, o que muda bastante a conta de quem vive de tráfego pago

E se o volume for grande, se liga: utilidade e autenticação têm faixas de volume que reduzem o preço unitário, agregadas no nível do portfólio de negócios

Marketing não tem desconto por volume, cada mensagem custa o mesmo da primeira até a última

Já no canal não oficial, o custo não é por mensagem: é o servidor rodando, igualzinho ao raciocínio de o custo real de um assistente que sobe na sua própria máquina

O que muda é onde a fatura aparece: numa via ela vem da Meta por mensagem, na outra vem da VPS por mês

Risco de bloqueio: por que o número cai no caminho não oficial

O sintoma todo mundo já viu ou ouviu: o bot roda liso por semanas e do nada o número é banido, no meio da operação, com cliente esperando resposta

E aí vem a pergunta: foi excesso de mensagem? foi horário? foi o texto?

A causa é mais estrutural que isso

O Baileys funciona por engenharia reversa do protocolo do WhatsApp Web, ou seja, é API não oficial

E os Termos de Serviço do WhatsApp proíbem uso não pessoal, mensagens em massa e automatizadas no app de consumidor, além do uso de clientes não oficiais ou modificados

Não é interpretação minha: os próprios mantenedores do Baileys declaram publicamente no repositório que não endossam uso que viole os Termos de Serviço do WhatsApp e desencorajam mensagens em massa ou automatizadas

Então a solução honesta aqui NÃO é um ajuste de configuração mágico

Não existe flag que faça um cliente não oficial virar oficial, e eu não vou te vender truque de sobrevivência que os fatos não sustentam

A saída sustentada é uma só: trocar o canal para a Cloud API, e o melhor é que dá pra fazer isso dentro da própria Evolution API, que tem documentação específica dessa integração

Subindo a Evolution API na VPS: o que aparece na prática

No vídeo abaixo eu mostro a instalação profissional que uso na prática numa VPS: EasyPanel pra instalar os serviços, n8n como motor das automações e a Evolution API como a peça que faz a comunicação entre WhatsApp e n8n nos dois sentidos

E tem uma coisa que confunde MUITA gente quando explico isso: o WhatsApp fica no celular do cliente e só se comunica com o servidor

Nada do WhatsApp roda na sua infraestrutura, beleza?

A ordem que eu sigo no vídeo é essa:

1. Registrar o domínio e criar três subdomínios apontando pro IPv4 do servidor (um pra Evolution API, um pro n8n, um pro EasyPanel), ANTES de instalar qualquer serviço. Erro comum: ficar mexendo no TTL do registro de DNS, eu crio o registro e não altero o TTL
2. Instalar os serviços pelo EasyPanel. Eu recomendo justamente pra quem é leigo em infraestrutura: evita decorar comando de terminal do Linux e dá menos margem de erro na instalação
3. Subir o n8n como motor das automações e a Evolution API como ponte com o WhatsApp

Alguns detalhes de bastidor que eu comento por lá: eu calibro o tamanho da máquina pelo uso (plano mais básico pra quem só estuda, plano acima pra quem já tem agência e vários projetos de cliente rodando), prefiro servidor no Brasil porque sinto o fluxo do n8n responder mais rápido, e dispenso o backup diário do provedor porque prefiro resolver backup por software dentro do servidor

Tome cuidado com um ponto: contratar período longo em vez de mensal, porque os descontos que aparecem na primeira compra não são resgatáveis depois

Eu rodo vários fluxos ativos assim, já perdi a conta de quantos, e nunca tive problema nem falta de suporte

Mas o passo a passo funciona igual em qualquer VPS, isso não é dogma

Agora um detalhe que NÃO está no vídeo e que morde o deploy hoje: a partir da versão 2.4.0, a Evolution API passou a exigir ativação de licença (gratuita) no primeiro acesso ao Manager, feita pela interface /manager, e a API fica bloqueada enquanto a ativação não é feita

Instalações em versões anteriores à 2.4.0 continuam funcionando normalmente, sem exigir ativação

E pra quem sobe tudo automatizado, sem abrir navegador, a 2.4 incluiu um caminho opcional de auto ativação headless por variável de ambiente:

[email protected]

No boot, o runtime chama o endpoint /v1/register/auto do servidor de licenciamento, persiste a chave e ativa a instância

Se falhar, ele cai de volta no registro manual pelo /manager

Essa mudança não passou batida na comunidade não: virou reclamação pública no repositório, dizendo que a ativação obrigatória da v2.4.0 quebra deployments automatizados e self hosted

Ah, e antes que tu caia num link velho: o repositório oficial hoje vive na organização evolution-foundation, em github.com/evolution-foundation/evolution-api

As URLs antigas em EvolutionAPI foram migradas

O código segue distribuído sob licença Apache 2.0, que permite uso comercial, redistribuição e modificação

Quando cada caminho faz sentido para o seu bot com IA

Dá pra resolver essa escolha por cenário, sem achismo:

Protótipo interno, número próprio de teste

Canal Baileys resolve

É o cenário em que o número é descartável e o custo por mensagem seria puro atrito pra validar uma ideia

É aqui também que dá pra brincar de fluxo mais rico, tipo montar mensagens interativas com botões e listas antes de decidir qualquer coisa

Atendimento de cliente pagante, volume previsível

Canal oficial

O número virou ativo do negócio, e o risco de banimento no caminho não oficial é estrutural, não é ajuste

Disparo de marketing

Canal oficial, e com a calculadora aberta

US$ 0,0625 por mensagem no Brasil e sem desconto por volume: aqui o custo morde de verdade quando a base cresce

Notificações de utilidade (confirmação, aviso, status)

Canal oficial

US$ 0,0068 por mensagem já é outra faixa, e utilidade tem escalonamento por volume que reduz o unitário

Operação que vive de anúncio que clica para o WhatsApp

Canal oficial, sem dúvida

A janela gratuita de 72 horas quando o cliente chega por anúncio ou botão de CTA da Página e a empresa responde em até 24 horas continua valendo, e não foi afetada pela mudança de outubro de 2026

Quando migrar da Evolution API para a API oficial

Meu veredito é chato de propósito: não existe "melhor", existe momento

Os gatilhos que eu olharia pra migrar de canal:

• Quando o número deixa de ser descartável, ou seja, quando perder aquele número significa perder histórico e cliente
• Quando existe contrato ou receita atrelada ao canal: aí o risco deixa de ser seu e passa a ser do cliente que te paga
• Quando o template vira a maior parte do tráfego, porque template é justamente o que a Meta cobra e o que ela permite
• Quando a data de 1º de outubro de 2026 entrar na sua conta: com o fim da gratuidade da janela de 24 horas pra mensagens de serviço, o custo do atendimento muda e precisa ser simulado antes, não depois

E aqui vai a boa notícia que desarma o medo de migrar: migrar não é trocar de stack

A Evolution API suporta multi provider, com Baileys, Meta Cloud API e Evolution Channel na mesma API, e tem página de documentação específica pra integração com a Cloud API

Seu n8n, seus fluxos, sua lógica de agente continuam ali

A migração é de CANAL, não de projeto 😀

Conclusão

Recapitulando o que importa na escolha entre Evolution API ou API oficial do WhatsApp:

Os dois canais moram dentro da mesma ferramenta, então a pergunta certa é sobre risco e custo, não sobre marca

O caminho não oficial roda por engenharia reversa do WhatsApp Web e esbarra nos Termos do WhatsApp, com risco de banimento do número que nenhuma configuração resolve

O caminho oficial cobra por mensagem entregue desde 1º de julho de 2025, hoje US$ 0,0625 em marketing e US$ 0,0068 em utilidade pro Brasil, com preço mudando no máximo quatro vezes por ano

Seu próximo passo, em três movimentos:

1. Definir se o número é descartável ou é número de negócio (essa resposta já decide metade)
2. Simular o custo mensal com os preços de marketing e utilidade do Brasil, separando o que é template do que é conversa dentro da janela
3. Planejar a troca de canal ANTES das datas de mudança de preço da Meta, e não no susto

Se tu ainda não tem o fluxo de pé, começa pelo conteúdo de automação de atendimento no WhatsApp aqui do blog e depois volta nessa decisão com dados da tua própria operação

Até o próximo post! =)