Como Hospedar a Evolution API em VPS: Guia Completo
Se você trabalha com automação de WhatsApp — seja para atendimento, vendas ou conectar um agente de IA à conversa dos seus clientes — em algum momento vai esbarrar na Evolution API. É a solução open source mais usada no Brasil para isso, e a forma correta de rodá-la é num VPS próprio. Este guia mostra o caminho completo, do zero ao WhatsApp conectado.
O que é a Evolution API? Uma API open source que conecta o WhatsApp a qualquer sistema — CRM, n8n, chatbot de IA — via webhooks e endpoints REST. Ela “engana” o WhatsApp Web para permitir múltiplas integrações programáticas.
Por que hospedar em VPS
A Evolution API precisa ficar online 24 horas para manter a sessão do WhatsApp ativa — se cair, a conexão se perde e o QR Code precisa ser escaneado de novo. Serviços gratuitos ou hospedagem compartilhada não sustentam isso. Um VPS garante o processo rodando continuamente, com IP fixo e estabilidade.
O que você precisa
- VPS com pelo menos 2 vCPU e 4 GB de RAM (mais, se for rodar várias instâncias/números)
- Docker e Docker Compose instalados
- Um domínio ou subdomínio para acessar o painel/API
- Um número de WhatsApp dedicado para conectar (recomendado não usar seu número pessoal principal)
Passo 1: Preparar o servidor
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | sh Passo 2: Subir a Evolution API com Docker Compose
A Evolution API precisa de dois serviços de apoio: Redis (cache de sessão) e PostgreSQL (armazenamento de dados). Um arquivo docker-compose.yml básico sobe os três juntos: a API, o Redis e o Postgres, cada um em seu container, conectados na mesma rede.
Defina a variável AUTHENTICATION_API_KEY com uma chave forte e aleatória — ela protege todos os endpoints da sua API.
Passo 3: Domínio e SSL
Aponte um subdomínio (ex: evolution.seudominio.com.br) para o IP do VPS, e configure Nginx + Certbot para o certificado SSL. A Evolution API expõe um painel de gerenciamento (Manager) que também roda por HTTPS.
sudo apt install -y nginx certbot python3-certbot-nginx
sudo certbot --nginx -d evolution.seudominio.com.br Passo 4: Criar a instância e ler o QR Code
Com a API no ar, acesse o Manager pelo domínio configurado, crie uma nova instância e escaneie o QR Code exibido com o WhatsApp do número que vai automatizar. A partir daí, a instância fica conectada e pronta para receber/enviar mensagens via API.
Dica: configure o webhook da instância apontando para o seu n8n ou sistema de automação assim que conectar — assim toda mensagem recebida já dispara o fluxo automaticamente, sem precisar configurar nada depois.
Quanto de VPS a Evolution API precisa?
Para uma ou duas instâncias (números) com volume moderado de mensagens, 2 vCPU e 4 GB de RAM atendem bem. Se você pretende rodar várias instâncias simultâneas — por exemplo, para vários clientes ou departamentos —, o consumo de RAM cresce por instância, e vale considerar um plano com mais memória desde o início.
Perguntas frequentes
A Evolution API é gratuita?
Sim, é open source e gratuita para uso próprio. Você paga apenas pelo VPS onde ela roda.
Corro risco de ter o número banido pelo WhatsApp?
Existe risco, como em qualquer automação não-oficial de WhatsApp. Reduza o risco enviando mensagens em ritmo humano, evitando spam em massa, e usando um número já aquecido (com uso normal) antes de automatizar.