“Evolution API ou Baileys?” é uma pergunta com pegadinha embutida, porque compara uma coisa com a peça de dentro dela. O Baileys é a biblioteca; a Evolution API é o produto montado em volta dela. Quem pergunta isso geralmente quer saber outra coisa: “eu programo direto na biblioteca ou uso a API pronta?”. Essa pergunta tem resposta, e ela depende de quanto do problema você quer carregar nas costas.
TL;DR: Baileys é uma biblioteca de código (TypeScript) que implementa o protocolo do WhatsApp Web por engenharia reversa; usar direto significa programar cada comportamento. A Evolution API embala o Baileys numa API REST com instâncias, webhooks, painel e integrações prontas: a própria documentação do projeto (2026) descreve o modo como baseado na biblioteca Baileys. Para 9 em cada 10 casos, a Evolution API poupa semanas. O que ela não muda: o risco herdado, porque toda a pilha assenta sobre a mesma conexão não oficial.
O que é cada um, sem confusão de camadas
O Baileys é um projeto open source que fala o protocolo do WhatsApp Web sem precisar de navegador: sua aplicação se conecta como se fosse um dispositivo pareado. Ele entrega funções de baixo nível: conectar, ouvir eventos, enviar mensagem. O que ele não entrega: gestão de múltiplas instâncias, webhook padronizado, fila, painel, reconexão bem tratada, integração pronta com n8n ou Chatwoot. Tudo isso é trabalho seu, em código Node, para sempre.
A Evolution API é exatamente essa camada que falta: o repositório oficial (2026) a apresenta como API REST pronta para produção que usa o Baileys como um dos modos de conexão, ao lado do modo Cloud API oficial da Meta. Você troca “programar comportamento” por “chamar endpoint”.
Quando usar o Baileys puro faz sentido
Sobram dois cenários legítimos. O primeiro: produto próprio em que o WhatsApp é o núcleo e você precisa de controle fino que a camada REST não expõe (manipulação de eventos exóticos, otimização de memória por sessão, comportamento customizado de reconexão). O segundo: aprendizado, porque implementar na biblioteca ensina o protocolo de um jeito que nenhuma API pronta ensina.
Fora desses dois, usar Baileys puro é reinventar a Evolution API por hobby: cada recurso que você precisar (multi-instância, webhook, mídia) já existe lá, testado por uma comunidade grande.
O que a escolha não muda: a herança
Aqui está o ponto que a pergunta esconde. Evolution API sobre Baileys e Baileys puro compartilham o mesmo DNA: uma conexão que imita o WhatsApp Web, fora dos termos da plataforma. As consequências são idênticas nos dois: desconexões quando o protocolo muda, ausência de SLA e o risco de banimento descrito em bloqueio de número na Evolution API. A história da biblioteca, os bloqueios que ela já sofreu e por que a Meta age contra esse tipo de conexão estão em Baileys: como funciona e por que está sendo bloqueado.
Escolher entre os dois é escolher o tamanho do trabalho, não o tamanho do risco. Quem quer mudar o risco muda de camada de novo, para cima: a Evolution API também opera no modo Cloud API oficial, e plataformas prontas fazem isso com coexistência, mantendo o app do celular ativo conforme a documentação da Meta (2025). O panorama completo está no guia da Evolution API; a versão sem nenhuma peça para você manter é o WhatsApp oficial no Cubo Suite, que é o nosso produto, dito sem rodeio.
A Evolution API usa Baileys?
Sim, como um dos dois modos de conexão: o modo gratuito via WhatsApp Web usa a biblioteca Baileys, e o próprio repositório do projeto declara isso. O outro modo é a Cloud API oficial da Meta.
Baileys é ilegal?
Não é crime: é software open source. Mas conexões via engenharia reversa violam os termos de serviço do WhatsApp, o que autoriza a Meta a banir números que as utilizam. A consequência é contratual e operacional, não penal.
Programar com Baileys direto é mais estável que a Evolution API?
Não por si só. A estabilidade da sessão depende do protocolo e da Meta, igual nos dois. Código próprio bem feito pode tratar reconexão melhor que uma versão específica da Evolution API, mas isso é esforço contínuo seu contra atualizações do protocolo, para sempre.
Deixe um comentário