Como Hospedar a Evolution API em VPS: Guia Completo

Atualizado em setembro 19, 2026

Ilustração: Como Hospedar a Evolution API em VPS: Guia Completo
Recomendamos a HostGator Somos parceiros afiliados oficiais — servidores Oracle Cloud no Brasil, com até 70% OFF e 30 dias de garantia.

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.

Foto de Rodrigo Mendes de Oliveira
Escrito por

Rodrigo Mendes de Oliveira — Fundador do Ecossistema MR

Mais de 14 anos de experiência em SEO, formado em Sistemas de Informação (UNINOVE) e especialista em IA pelo MIT. Fundador da MR Tecnologia e vencedor do Silicon Valley Startup Award 2023 (StartSE).

Ver planos de VPS para começar
Conteúdo recente