Como Instalar Evolution API na VPS: Tutorial Prático

5 min 2 Evolution Api

Introdução à Instalação da Evolution API na Infraestrutura Cloud

A Evolution API tornou-se o padrão da indústria para quem busca uma WhatsApp API aberta, robusta e sem as amarras de soluções engessadas. Na minha experiência de mais de 9 anos gerenciando ambientes de alta disponibilidade na Host You Secure, já ajudei centenas de clientes a migrarem seus fluxos de atendimento para estruturas próprias. Segundo dados recentes de mercado, empresas que utilizam soluções open-source para automação de mensagens reduzem seus custos operacionais em até 65% comparado a APIs oficiais restritivas.

Se você deseja escalar o atendimento da sua empresa, criar um chatbot inteligente e manter o controle total dos seus dados, este tutorial prático vai direto ao ponto. Vamos explorar desde a escolha correta do ambiente até a validação das suas instâncias, evitando os erros mais comuns que vejo desenvolvedores iniciantes cometerem no dia a dia.

1. Escolhendo e Preparando o Servidor VPS Ideal

Antes de rodar qualquer linha de comando, a escolha da infraestrutura é o fator crítico de sucesso para a estabilidade da sua API. Uma VPS (Virtual Private Server) inadequada resultará em quedas de conexão do WhatsApp Web e falhas no envio de disparos em massa ou respostas de robôs.

Especificações Técnicas Recomendadas

Para um ambiente de produção estável que suporte múltiplas instâncias conectadas simultaneamente, recomendo as seguintes especificações mínimas baseadas em benchmarks reais:

  • Processador (vCPU): Mínimo de 2 núcleos dedicados para processar requisições simultâneas sem gargalos.
  • Memória RAM: 2GB a 4GB. O Node.js e o ecossistema Docker demandam folga de RAM para gerenciar o consumo do Puppeteer/Baileys.
  • Armazenamento SSD NVMe: 30GB de espaço rápido para logs, mídias temporárias e banco de dados.
  • Sistema Operacional: Ubuntu Server 22.04 LTS ou 24.04 LTS (versões com suporte de longo prazo e maior estabilidade).

Se você precisa de uma infraestrutura robusta, conheça as opções de hospedagem VPS de alta performance otimizada para automações.

Configuração Inicial do Sistema Operacional

Com sua VPS contratada e acessada via SSH, o primeiro passo é atualizar os pacotes do sistema e preparar o ambiente para receber os containers. Execute os comandos abaixo no terminal:

sudo apt update && sudo apt upgrade -y
sudo apt install curl git ufw -y

Lembre-se de configurar o firewall básico (UFW) para liberar apenas as portas essenciais (como a porta 80, 443 e a porta específica da sua API, geralmente a 8080).

2. Instalando o Docker e o Docker Compose

A melhor forma de implantar a Evolution API de maneira limpa, isolada e fácil de atualizar é utilizando o ecossistema Docker. Na minha rotina de suporte técnico, cerca de 40% dos chamados resolvidos envolviam conflitos de dependências locais que poderiam ser evitados com o uso de containers.

Passo a Passo da Instalação do Docker

Para instalar a versão mais recente do Docker e do Docker Compose no seu Ubuntu Server, siga o procedimento padrão recomendando pelos desenvolvedores:

  1. Adicione a chave GPG oficial do Docker:
    sudo install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  2. Configure o repositório estável:
    echo "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  3. Atualize a lista e instale os pacotes:
    sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Verificando a Instalação

Após a conclusão do processo, valide se o serviço está rodando perfeitamente executando o comando de teste:

sudo docker compose version

Se a versão for exibida sem erros, seu ambiente está 100% pronto para receber a aplicação.

3. Configurando e Implantando a Evolution API

Com o Docker ativo, criar o ambiente para gerenciar sua WhatsApp API é simples, mas exige atenção aos detalhes de segurança, especialmente nas chaves de autenticação (Global API Key).

Criando a Estrutura de Arquivos

Crie um diretório dedicado para o projeto e acesse-o:

mkdir evolution-api && cd evolution-api

Em seguida, crie um arquivo docker-compose.yml utilizando seu editor favorito (como o nano ou vim). Insira a seguinte estrutura base:

version: '3.8'

services:
  evolution-api:
    container_name: evolution-api
    image: atendai/evolution-api:v2.1.1
    restart: always
    ports:
      - "8080:8080"
    environment:
      - AUTHENTICATION_TYPE=apikey
      - AUTHENTICATION_API_KEY=sua_chave_secreta_super_forte
      - SERVER_PORT=8080
    volumes:
      - evolution_instances:/evolution/instances

volumes:
  evolution_instances:
    driver: local

Dica de Insider: Segurança de Dados

Um erro crítico comum é deixar a AUTHENTICATION_API_KEY fraca ou em branco. Na minha experiência, bots expostos na internet sem chave global forte são rapidamente alvos de varreduras maliciosas que tentam disparar spam utilizando seu número conectado. Sempre utilize strings complexas com mais de 32 caracteres alfanuméricos.

4. Testando a API e Conectando seu Primeiro Chatbot

Com o arquivo configurado, suba o container em segundo plano utilizando o comando do Docker Compose:

sudo docker compose up -d

Para verificar se a aplicação subiu corretamente, verifique os logs com sudo docker compose logs -f. Você deverá ver mensagens indicando que o servidor HTTP está escutando na porta 8080.

Validando via Postman ou Insomnia

Abra sua ferramenta de testes de API favorita e envie uma requisição POST para o endpoint de criação de instância:

  • URL: http://IP_DA_SUA_VPS:8080/instance/create
  • Headers: apikey: sua_chave_secreta_super_forte
  • Body (JSON): {"instanceName": "bot-atendimento", "qrcode": true}

Se a resposta retornar o base64 do QR Code, parabéns! Sua infraestrutura está funcionando perfeitamente e pronta para integrar qualquer chatbot via N8N ou Typebot.

Conclusão

Instalar e configurar a Evolution API em uma VPS dedicada transforma a capacidade de comunicação da sua empresa, garantindo autonomia e alta performance para suas estratégias de WhatsApp API. Seguindo os passos de dimensionamento de hardware e segurança que detalhamos aqui, você evita quedas inesperadas e protege suas operações contra acessos indesejados.

Na Host You Secure, entendemos que manter um ecossistema de automação ativo é vital para o seu negócio. Se quiser continuar aprimorando seus conhecimentos técnicos, confira outros artigos em nosso blog especializado e descubra como extrair o máximo da sua infraestrutura cloud hoje mesmo.

Leia também: Veja mais tutoriais de N8N

Perguntas Frequentes

Recomendamos pelo menos 2 vCPUs e 2GB de RAM com armazenamento SSD NVMe rodando Ubuntu Server 22.04 LTS para garantir estabilidade contínua.

É fundamental configurar uma chave de API global forte (AUTHENTICATION_API_KEY), utilizar firewall ativo (UFW) e restringir o acesso às portas necessárias.

Não. Cada número de WhatsApp conectado exige a criação de uma instância separada e isolada dentro da Evolution API, gerenciando tokens e sessões individuais.

Geralmente isso ocorre por falta de memória RAM na VPS ou travamento do processo interno do Puppeteer. Reiniciar o container Docker costuma resolver o problema.

Você pode utilizar os nós de requisição HTTP (HTTP Request) do N8N para interagir diretamente com os endpoints da API, enviando e recebendo mensagens via Webhook.

Comentários (0)

Ainda não há comentários. Seja o primeiro!