WhatsApp

Evolution API

API open-source para integrar e automatizar o WhatsApp

4.1 Plano grátis disponível

A Evolution API vale a pena para quem tem equipe técnica e quer o WhatsApp como canal de um sistema próprio, sem pagar por usuário. É madura, integra com quase tudo que importa no ecossistema brasileiro de automação e não cobra licença. O que decide a favor ou contra não é a qualidade do software, e sim qual caminho de conexão você vai usar: pela API oficial do Meta ela é uma escolha sólida e sem risco regulatório, e pela via Baileys você troca custo por uma chance real de perder o número.

Prós

  • Sem cobrança por usuário ou por assento: o custo é o servidor
  • Integrações nativas com Typebot, Chatwoot, n8n, OpenAI e Dify
  • Suporta a API oficial do Meta, o que permite operar dentro dos termos
  • Apache 2.0: você pode auditar, adaptar e rodar onde quiser
  • Comunidade brasileira grande, com material e exemplos em português

Contras

  • A via Baileys fere os termos do WhatsApp e pode custar o número
  • Não tem editor visual: exige quem programe ou orquestre por outra ferramenta
  • Operação, atualização e backup do servidor são responsabilidade sua
  • A versão que escala mais (Go) exige licença e usa o caminho de risco
  • Sem suporte contratual: você conta com documentação e comunidade

Veredito

Excelente peça de infraestrutura para quem tem time técnico, e a melhor opção quando o custo por assento das plataformas prontas deixa de fazer sentido. Use pela API oficial do Meta. Se a atração for a via Baileys por ser gratuita e sem aprovação, entenda que você está apostando o número comercial da operação, e essa não é uma aposta que a economia justifica.

Existem dois jeitos de julgar a Evolution API, e eles levam a conclusões diferentes. Como software, ela é boa: madura, bem integrada, ativa, com licença permissiva. Como decisão de negócio, a resposta depende inteiramente de uma escolha que a ferramenta te oferece e não faz por você.

Vamos pelos critérios, e no fim eu digo o que a nota reflete.

Capacidade: forte, e o ecossistema é o diferencial

A Evolution faz o que promete. Envia e recebe mensagem, mídia e áudio, gerencia múltiplas instâncias, dispara webhook para cada evento. Nada disso é notável por si só.

O que é notável é o que já vem conectado. Typebot para fluxo conversacional, Chatwoot para atendimento humano, OpenAI e Dify para modelo de linguagem, fila de verdade com RabbitMQ, Kafka ou SQS, armazenamento de mídia em S3 ou MinIO. Cada um desses seria uma integração para construir e manter.

No contexto brasileiro isso pesa mais do que parece. A combinação de Evolution com n8n self-hosted virou praticamente um padrão de mercado para automação de WhatsApp, e a razão é essa: as peças se encaixam sem cola.

Conformidade: aqui está o problema, e ele é grande

Este é o critério que puxa a avaliação para baixo, e não por culpa do código.

A ferramenta oferece a via Baileys como caminho de conexão. É gratuita, dispensa aprovação do Meta e conecta por QR code em minutos. Para quem está começando, parece a escolha obviamente melhor.

Ela emula o cliente do WhatsApp Web, o que fere os termos de uso do WhatsApp. O Meta trata clientes não oficiais como violação e aprimora a detecção de comportamento automatizado de forma contínua. O resultado documentado é bloqueio do número, que pode ser permanente.

O peso disso não está na multa, porque não existe multa. Está no ativo. O número de WhatsApp de uma operação comercial carrega o histórico de conversa dos clientes, é o canal que eles têm salvo, e frequentemente está impresso em material e anúncio. Perder esse número não é um incidente técnico, é perder o canal.

A leitura honesta: a Evolution API pode ser usada em plena conformidade, pela API oficial. Mas a opção arriscada é a mais fácil, a mais barata e a mais divulgada em tutorial. Uma ferramenta que torna o caminho perigoso o caminho de menor atrito carrega parte dessa responsabilidade na avaliação.

Custo: o melhor argumento dela

Sem cobrança por assento, sem cobrança por usuário. Você paga o servidor e, na via oficial, a tarifa de conversa que o Meta cobra de qualquer um.

Isso muda a estrutura, não só o valor. Nas plataformas prontas, crescer a equipe de atendimento aumenta a fatura todo mês. Aqui, um atendente a mais custa zero. Para operação com muitos atendentes ou muitos números, a diferença deixa de ser desconto e passa a ser outro modelo. Os números estão em preços.

Maturidade e documentação: sólidas, com um porém

O projeto tem histórico, versões frequentes e uma comunidade brasileira grande, o que significa material em português e gente para perguntar. A documentação cobre bem instalação e endpoints.

O porém é o que não existe: suporte contratual. Quando algo quebra em produção às onze da noite, não há ninguém obrigado a te responder. Para muita operação isso é aceitável. Para quem tem cliente com SLA, é um risco que precisa estar precificado.

O que exige de você

Não tem interface. Isso não é uma falha, é a natureza da coisa, mas define quem consegue usar. Você precisa de alguém que programe contra a API, ou que orqueste por uma ferramenta como o n8n. Se ninguém no time faz isso, a Evolution vai virar um servidor parado.

E a operação é sua: atualizar, monitorar, garantir que o backup restaura. O custo escondido do self-hosted, que detalho em hospedagem, aparece inteiro aqui.

O que quebra na prática

Avaliar software por lista de recurso é fácil e engana. Vale registrar o que costuma dar problema numa operação real de Evolution, porque é isso que separa a ferramenta boa no papel da ferramenta boa em produção.

Sessão que cai, na via não oficial. Não é bug, é a natureza de emular o WhatsApp Web. Celular sem internet, dispositivo desconectado pelo app, atualização do WhatsApp. Sem alerta de instância desconectada, você descobre pelo cliente reclamando que ninguém respondeu.

Disco cheio por mídia. Áudio e imagem acumulam rápido, e disco cheio não degrada gradualmente: derruba a instância. É a falha mais boba e mais comum de operação de WhatsApp self-hosted.

Mudança de comportamento entre versões. O projeto é ativo, o que é bom, e endpoint muda. Uma atualização sem ler o changelog pode alterar o formato de um evento que o seu fluxo consumia, e o sintoma aparece como “o bot parou de responder”.

Duplicata de evento. A entrega de webhook repete quando o seu endpoint demora. Sem tratamento de idempotência, o cliente recebe a mesma resposta duas vezes, o que é pior do que não receber.

Nenhum desses é motivo para descartar a ferramenta. São o custo operacional real, e entram na avaliação porque quem contrata uma plataforma pronta está comprando exatamente a ausência disso.

O que a nota reflete

Avaliei seis critérios com base em fonte pública, sem testar a ferramenta em produção: licença e abertura, capacidade e integrações, conformidade e risco de termos de uso, custo, maturidade e documentação, e exigência técnica. É por isso que a nota vem acompanhada da contagem de critérios em vez de um número solto.

A Evolution API pontua alto em quase tudo. O que a impede de pontuar mais alto é o critério de conformidade, e vale repetir por quê: não é o software que é arriscado, é o caminho que ele deixa mais fácil.

Pela API oficial, é uma das melhores decisões que uma operação técnica pode tomar para WhatsApp. Via Baileys, é uma economia que pode custar o canal. A ferramenta é a mesma; a aposta, não.

Para quem ela não serve

Uma avaliação que só diz para quem serve é meia avaliação. Quatro perfis em que a Evolution API é a escolha errada, e vale dizer sem rodeio:

Quem não tem ninguém que programe. Sem interface, sem construtor de fluxo. Se a expectativa é abrir uma tela e montar o atendimento arrastando blocos, isso não existe aqui e não vai existir. O servidor vai ficar ligado sem servir a nada.

Quem precisa de SLA. Operação que vendeu disponibilidade para um cliente não deveria depender de projeto sem suporte contratual. Não é demérito do projeto: é que a conta do incidente às duas da manhã cai em você, e às vezes essa conta é uma cláusula de contrato.

Quem tem um número e dois atendentes. A economia não existe nessa escala, e o custo em horas é real. BotConversa entrega em dias, com suporte, o que aqui levaria semanas. Já detalhei os números em preços.

Quem não pode arriscar o número de jeito nenhum e vai pela via Baileys. Se a operação depende de um número que não pode cair, e a escolha for o caminho não oficial porque é grátis, a decisão está incoerente com a própria restrição. Ou vai pelo canal oficial, ou aceita conscientemente que o número é substituível.

Onde ir depois

O tutorial mostra a primeira mensagem saindo, e a página de hospedagem compara a versão Node com a Go, inclusive a exigência de licença. Se a conclusão for que você quer algo pronto, com suporte e sem servidor para cuidar, as alternativas comparam com as plataformas brasileiras. E se o que você procura é atendimento pronto da mesma fundação, veja o Evolution CRM.

Perguntas frequentes

A Evolution API é confiável?

O software é maduro e amplamente usado, com comunidade ativa e integrações estáveis. A confiabilidade da sua operação depende de duas coisas que não são o software: o caminho de conexão que você escolher e a qualidade da manutenção do seu servidor.

Vale a pena a Evolution API ou uma plataforma pronta?

Depende de quem vai operar. Com equipe técnica e vários números, a Evolution sai bem à frente no custo, porque não cobra por assento. Sem equipe técnica, uma plataforma pronta como BotConversa entrega em dias o que aqui levaria semanas, e o suporte tem alguém do outro lado.

Usar a Evolution API pode banir meu WhatsApp?

Pela API oficial do Meta, não: você está no canal autorizado. Pela via Baileys, sim, existe risco real, porque emular o WhatsApp Web fere os termos de uso e o Meta melhora a detecção continuamente. O bloqueio pode ser temporário ou permanente.

A Evolution API tem suporte?

Não tem suporte contratual. Você conta com a documentação oficial, o repositório e a comunidade, que é grande e ativa no Brasil. Para operação crítica que precisa de SLA, isso é uma limitação séria e deve entrar na decisão.

Qual a licença da Evolution API?

Apache 2.0, com cláusulas adicionais de proteção de marca, que pedem preservação de logo e copyright e notificação de uso. É permissiva para uso comercial. A Evolution Go tem exigência de licença para operar, o que é diferente.

A Evolution API funciona para agência que atende vários clientes?

É um dos melhores casos de uso dela, justamente porque o custo não cresce por cliente atendido. A ressalva é operacional: cada número conectado é uma instância para monitorar, e a conta de manutenção cresce mesmo quando a de licença não cresce.

Preciso de servidor forte para rodar a Evolution API?

Não para começar. Um VPS de entrada com 2 GB de RAM atende poucos números e volume moderado. O que puxa recurso é quantidade de instâncias conectadas e mídia trafegada, mais do que o número absoluto de mensagens.