Como Hospedar Evolution API no Servidor: Passo a Passo — July 2026

Como Funciona a Hospedagem da Evolution API

Hospedar a Evolution API em um ambiente self-hosted exige entender a arquitetura baseada em containers que sustenta a ferramenta. A Evolution API é uma interface de comunicação robusta que transforma o WhatsApp em uma central programável para envio de mensagens e integração com sistemas externos, como um chatbot automatizado.

Na minha experiência com mais de 500 implantações de infraestrutura na Host You Secure, percebo que o erro mais comum é tentar rodar a API em servidores compartilhados ou sem os recursos mínimos de hardware. Como a ferramenta gerencia sessões ativas do WhatsApp via WebSockets e consome memória para manter o estado das conexões, uma infraestrutura dedicada é inegociável para evitar quedas repentinas.

Requisitos de Servidor para Produção

Para garantir que sua WhatsApp API funcione 24 horas por dia sem gargalos de performance, o planejamento de hardware é o primeiro passo crítico. Servidores abaixo do recomendado sofrem com travamentos no momento de escanear o QR Code ou durante disparos em massa.

• CPU: Mínimo de 2 vCPUs para processar requisições simultâneas da API e do banco de dados (Redis/PostgreSQL).
• Memória RAM: Pelo menos 2GB de RAM dedicado exclusivamente para o ambiente Docker da aplicação.
• Armazenamento: 20GB a 40GB SSD NVMe para logs rápidos e persistência de dados dos chats.

Comparativo de Infraestrutura para Evolution API

Passo a Passo: Como Instalar a Evolution API no VPS Ubuntu

A instalação da Evolution API utilizando o Docker Compose é o método mais seguro e limpo para ambientes de produção. Siga o procedimento abaixo diretamente no terminal do seu servidor VPS.

1. Atualize o sistema operacional: Acesse seu VPS via SSH e execute sudo apt update && sudo apt upgrade -y para garantir que todos os pacotes estejam atualizados.
2. Instale o Docker e Docker Compose: Execute o script oficial de instalação do Docker ou utilize os gerenciadores de pacotes padrão do Ubuntu para configurar o motor de containers.
3. Crie o diretório de trabalho: Digite mkdir evolution-api && cd evolution-api para organizar os arquivos de configuração do seu projeto de automação.
4. Configure o arquivo docker-compose.yml: Crie um arquivo de configuração apontando para a imagem oficial da Evolution API, definindo as portas de acesso externo e as variáveis de conexão com o banco de dados.
5. Inicie os containers: Execute o comando sudo docker compose up -d para baixar as imagens necessárias e colocar a API rodando em segundo plano no servidor.

Verificando se a API está Online

Após a execução do Docker Compose, utilize o comando sudo docker ps para confirmar se o container da Evolution API está com o status 'Up'. Caso ocorra algum erro de inicialização, analise os logs em tempo real utilizando sudo docker logs -f para identificar possíveis falhas nas variáveis de ambiente.

Erros Comuns na Configuração da Evolution API

Evitar armadilhas técnicas durante o deploy da sua WhatsApp API poupa horas de troubleshooting. O erro mais frequente é a falta de liberação de portas no firewall do servidor (UFW), bloqueando as requisições HTTP e Webhooks vindas do seu sistema de chatbot.

Problemas com Mutex e Redis

Outro ponto crítico é a configuração do banco de dados Redis. A Evolution API utiliza o Redis para gerenciar o cache e o estado das instâncias. Se o Redis cair ou não estiver acessível na mesma rede interna do Docker, as instâncias do WhatsApp desconectarão constantemente, exigindo um novo escaneamento de QR Code manual.

Falta de Monitoramento de Logs

Muitos administradores sobem o container e esquecem de configurar uma ferramenta de rotação de logs. Com o passar das semanas, os logs de requisições da API podem ocupar 100% do disco rígido do VPS, causando a parada total do serviço de atendimento automatizado.

Perguntas Relacionadas sobre Hospedagem

Preciso de conhecimento avançado em Linux para instalar a Evolution API?

Não necessariamente nível expert, mas é fundamental saber comandos básicos de terminal SSH, manipulação de arquivos de texto (como nano ou vim) e conceitos iniciais de redes e Docker para gerenciar o ambiente com autonomia.

Posso hospedar múltiplas instâncias do WhatsApp no mesmo servidor?

Sim! Uma única instalação da Evolution API em um VPS dimensionado corretamente suporta dezenas ou até centenas de instâncias de números de WhatsApp diferentes rodando simultaneamente.

Como garantir a segurança dos dados das mensagens?

Recomendamos fortemente o uso de chaves globais de autenticação (API Keys) fortes, além de configurar um proxy reverso (como Nginx Proxy Manager) com certificado SSL (HTTPS) ativo para criptografar todo o tráfego externo.

Conclusão e Próximos Passos

Hospedar a Evolution API por conta própria em uma infraestrutura dedicada oferece liberdade total e elimina custos abusivos de plataformas de terceiros. Com o procedimento de instalação via Docker e os devidos cuidados de segurança, seu negócio estará pronto para escalar o atendimento automatizado via chatbot com máxima performance.

Para garantir que sua aplicação rode sem travamentos e com excelente custo-benefício, nós da Host You Secure recomendamos o plano VPS Brasil Starter (R$ 49/mês, 2GB RAM, 2 vCPUs). Rodamos esse exato setup em uma VPS Brasil Starter para validar nossas integrações de automação com total estabilidade. Contrate agora sua VPS Brasil Starter e coloque sua API no ar hoje mesmo.

Leia também: Veja mais tutoriais de N8N