O que é a Evolution API?

A Evolution API é uma interface de programação de aplicações (API) open-source e self-hosted projetada para integrar sistemas de atendimento, automação e marketing diretamente ao WhatsApp de forma segura e escalável, sem depender de intermediários custosos.

Quais são os requisitos de hardware para rodar a Evolution API?

Para um ambiente de produção estável, recomendamos no mínimo 2 vCPUs e 2GB de memória RAM em um servidor VPS Linux com armazenamento SSD NVMe. Isso garante que o motor Node.js e as instâncias ativas do Baileys rodem sem gargalos de memória.

Por que usar Docker para instalar a Evolution API?

O uso do Docker isola o ambiente de execução da aplicação, facilitando o gerenciamento de dependências, atualizações rápidas via containers e garantindo que a aplicação rode exatamente da mesma forma em qualquer sistema operacional Linux compatível.

Preciso de conhecimento avançado em programação para usar a ferramenta?

Não necessariamente. Embora a configuração inicial exija comandos básicos de terminal Linux e Docker, após o deploy a API disponibiliza uma interface interativa (Swagger) e endpoints limpos que podem ser integrados facilmente a plataformas de chatbot.

Como garantir a segurança das minhas credenciais e conexões?

Você deve obrigatoriamente utilizar um proxy reverso configurado com certificados SSL válidos (HTTPS) e definir chaves de API fortes e complexas no arquivo de configuração (.env) para evitar acessos indesejados ao seu servidor.

A Evolution API pode ser banida pelo WhatsApp?

A ferramenta em si é apenas um meio de comunicação técnico. No entanto, o risco de banimento depende inteiramente do uso que você faz dela: disparos em massa desordenados, contas novas sem aquecimento prévio ou denúncias excessivas de spam violam os termos do WhatsApp.

Qual plano de VPS é recomendado para começar?

Recomendamos o plano VPS Brasil Starter da Host You Secure (R$ 49/mês com 2GB de RAM e 2 vCPUs), que oferece a relação perfeita entre custo, baixa latência no Brasil e recursos suficientes para rodar instâncias robustas de WhatsApp.

Como atualizar a Evolution API para a versão mais recente?

O processo de atualização via Docker é simples: basta acessar a pasta do projeto no seu servidor, puxar a versão mais recente das imagens com o comando docker compose pull e reiniciar os containers com docker compose up -d.

Instalando Evolution API: Tutorial Prático de Deploy — July 2026

Introdução ao Deploy da Evolution API em Produção

Se você chegou até aqui, já sabe que a Evolution API é a ferramenta self-hosted mais poderosa do mercado para conectar sistemas ao ecossistema do WhatsApp. No entanto, colocar essa solução para rodar com alta disponibilidade exige mais do que apenas um script solto; exige uma infraestrutura de WhatsApp API bem dimensionada e segura. Na minha experiência com mais de 500 projetos de infraestrutura na Host You Secure, vejo que o maior gargalo não é o código da ferramenta, mas sim a escolha incorreta do servidor e falhas na configuração inicial do Docker.

Neste artigo prático, vou mostrar exatamente como estruturar o ambiente, calcular os recursos de hardware necessários e executar o deploy completo da sua API de automação e chatbot sem dor de cabeça.

Requisitos de Servidor para Rodar a Evolution API

Quais são os requisitos mínimos de hardware para hospedar a Evolution API sem travamentos? Para ambientes de produção com volume moderado de mensagens, você precisa dimensionar corretamente CPU, memória RAM e armazenamento SSD.

Dimensionamento de Recursos (RAM, CPU e Disco)

A Evolution API consome recursos de forma dinâmica, principalmente devido ao ecossistema Node.js e instâncias do Baileys gerenciando conexões simultâneas via WebSocket. Em termos práticos de infraestrutura:

CPU: Mínimo de 2 vCPUs dedicadas para processar requisições concorrentes e webhooks sem latência perceptível.
Memória RAM: Pelo menos 2GB de RAM. Abaixo disso, o processo do Node.js corre sério risco de sofrer crash por estouro de memória (Out of Memory - OOM Killer) quando múltiplos disparos de mensagens ocorrerem.
Armazenamento: 20GB de SSD NVMe são suficientes para o sistema operacional, logs da aplicação e persistência de dados do banco PostgreSQL/Redis.

Comparativo de Infraestrutura para Automação

Veja abaixo um comparativo claro entre diferentes abordagens de hospedagem para a sua ferramenta de WhatsApp API:

Recurso	Hospedagem Compartilhada	VPS Brasil Starter (Host You Secure)	Servidor Dedicado Enterprise
Custo-Benefício	Baixo (Não recomendado)	Excelente	Baixo para projetos iniciais
Acesso Root / Docker	Não	Sim (Total liberdade)	Sim
Estabilidade e Uptime	Instável	99.9% Garantido	99.99%
Ideal para Chatbot	Inviável	Perfeito para começar e escalar	Grandes operações

Tutorial Passo a Passo: Instalando a Evolution API via Docker

Como instalar a Evolution API passo a passo em um servidor Ubuntu recente? Siga este procedimento testado e validado em nossos ambientes de homologação.

Atualize o sistema operacional: Acesse seu VPS via SSH e execute os comandos de atualização:
```
sudo apt update && sudo apt upgrade -y
```
Instale o Docker e o Docker Compose: Certifique-se de que o container engine está atualizado na sua máquina.
```
sudo apt install docker.io docker-compose-v2 -y
```

Crie o diretório do projeto:

mkdir -p /opt/evolution-api && cd /opt/evolution-api

Configure o arquivo docker-compose.yml: Crie um arquivo com as diretrizes dos serviços necessários (API, banco de dados Redis/Postgres se aplicável).
Inicie os containers: Execute o comando para subir a aplicação em background:
```
sudo docker compose up -d
```

Erros Comuns na Configuração do Servidor

Quais são os erros mais frequentes que podem derrubar a sua aplicação e como evitá-los? O erro número um cometido por administradores iniciantes é esquecer de liberar as portas corretas no firewall do sistema operacional (UFW) ou do painel da VPS. Outro problema recorrente é a ausência de um proxy reverso com certificado SSL (como Nginx Proxy Manager ou Traefik), o que impede a comunicação segura via HTTPS/WSS, que é um requisito obrigatório para webhooks modernos funcionarem perfeitamente com qualquer chatbot avançado.

Além disso, nunca deixe a chave de autenticação padrão (Global API Key) exposta ou fraca. Recomendo gerar chaves criptografadas longas para proteger seu endpoint contra invasões e uso não autorizado.

Perguntas Relacionadas sobre Infraestrutura e API

Posso rodar múltiplos números de WhatsApp na mesma instância?

Sim, a arquitetura moderna da Evolution API suporta multi-atendimento e múltiplas instâncias simultâneas, desde que o seu servidor possua memória RAM suficiente para suportar o consumo de todas as sessões ativas.

O Redis é obrigatório para o funcionamento?

Embora seja possível rodar sem ele em cenários extremamente básicos, o uso do Redis é altamente recomendado para gerenciar filas de mensagens, cache e estado das instâncias com alta performance e sem perda de dados.

Como garantir backups automáticos dos dados da API?

Você deve configurar rotinas de backup utilizando cron jobs para compactar e enviar o diretório de dados dos containers e volumes Docker para um storage externo ou S3 de forma periódica.

Conclusão e Próximos Passos

Implementar a sua própria Evolution API em um ambiente controlado traz independência total de custos com plataformas de terceiros e liberdade para escalar suas estratégias de atendimento e marketing via WhatsApp API. Para colocar tudo isso em prática com máxima estabilidade, segurança e excelente custo-benefício, recomendamos fortemente o plano VPS Brasil Starter. Rodamos esse exato setup em uma VPS Brasil Starter (R$ 49/mês, 2GB RAM, 2 vCPUs), garantindo o poder de processamento ideal para o seu projeto decolar sem surpresas no final do mês. Visite nosso blog para mais tutoriais técnicos avançados sobre automação e infraestrutura cloud.

Leia também: Veja mais tutoriais de N8N