Como instalar a API Evolution em um droplet da DigitalOcean (Português)

Passo a Passo:

Instalando a Evolution API na DigitalOcean para usar com o Bluguezap, módulo para o Perfex CRM.

Vamos fazer isso juntos. Vou te dar os comandos exatos.

Estes passos foram testados em uma droplet na DigitalOcean mas você pode replicar os passos em um servidor da AWS, Hetzner ou outro do seu interesse.

1. Criando o Servidor (Droplet)

1. Crie uma conta na DigitalOcean, AWS, Hetzner (4GB RAM recomendado). - Recomendado: DigitalOcean - Receba $200.00 em crédito por 60 dias.
   

2. Clique em Create -> Droplets.

3. Region: New York ou San Francisco (geralmente mais estáveis/baratos), ou escolha  uma região de sua preferência. Recomendo NY. 

4. OS: Ubuntu 24.04 (LTS) x64 or later. 

5. Size: Escolha -> (4GB RAM / 50GB SSD). Não pegue o de $6 (1GB RAM) para não passar raiva.

6. Authentication: SSH Key (mais seguro) ou Password (mais fácil para começar).

7. Clique em Create Droplet.

2. Preparando o Ambiente (Terminal)

Acesse seu servidor via terminal (PuTTY ou Terminal do VS Code ou use o próprio recurso de acesso da DigitalOcean, caso tenha decidido usar a DigitalOcean.)

ssh root@SEU_IP_DO_DROPLET

Rode os comandos abaixo para instalar o Docker (copie e cole): 

# Atualiza o sistema

apt update && apt upgrade -y

# Instala o Docker

curl -fsSL https://get.docker.com -o get-docker.sh

sh get-docker.sh 

# Instala o Docker Compose (Plugin)

apt install docker-compose-plugin -y 

3. Configurando a Evolution API (O Arquivo Mágico)

IMPORTANTE. Configurando a chave de segurança

Você precisa gerar uma chave de API forte para proteger seu servidor. Execute este comando no terminal do seu VPS:

openssl rand -hex 32

Saída gerada (Exemplo): a1b2c3d4e5f67890123456789abcdef0123456789abcdef0123456789abcdef

Copie o resultado e cole-o no seu arquivo docker-compose.yml no campo AUTHENTICATION_API_KEY.

Agora, vamos criar a pasta e o arquivo de configuração.

1. Crie a pasta:

mkdir evolution-api && cd evolution-api

Crie o arquivo docker-compose.yml (exatamente com esse nome): 

nano docker-compose.yml

Cole o conteúdo do arquivo docker-compose.yml (Este é um setup completo que preparamos para você, já com Banco de Dados e Redis integrados, por favor, atente-se para alterar a senha do banco de dados, e a API Global Key. Caso queira, altere o nome do banco dedados, mas recomendamos manter como está): 

file: docker-compose.yml (Presente no arquivo "Main_file -> server_setup")

Atenção: Mude onde diz SEU_IP_DO_DROPLET para o IP real da máquina. Mude as senhas se desejar. 

Salve o arquivo (Ctrl+O, Enter) e saia (Ctrl+X). 

Os passos a seguir são necessários caso você queira usar um um subdominio do seu próprio site para usar na API. Ex. api.seudominio.com.

Passo 4: Preparação do Domínio 

Para ter  HTTPS (https://api.seudominio.com), é necessário que você vá no painel de onde você comprou seu domínio (seudominio.com) e crie um apontamento DNS:

• Tipo: A

• Nome (Host): api (ou o que preferir)

• Valor (Destino): O IP da sua Droplet DigitalOcean (Ex. 64.225.01.04). 

Passo 5: Instalação da V2 com Proxy Reverso (HTTPS) 

Agora vamos instalar a stack profissional. Não vamos usar apenas o docker-compose.yml simples. Vamos usar um que inclui o Nginx Proxy Manager. Isso vai gerenciar o certificado SSL (Let's Encrypt) para nós de graça.

4. Rodando tudo

Agora execute: 

docker compose up -d

O Docker vai baixar as imagens e subir tudo. Espere uns 30 segundos.

O que fizemos até aqui: 

1. Criamos o DNS A (api.seudominio.com -> IP).

2. Rode o comando acima para subir a V2 e o Proxy.

3. Acesse o Painel do Proxy: Abra http://SEU_IP:81 no navegador.

   • Login padrão (geralmente): admin@example.com 

   • Senha padrão: changeme

O sistema pode solicitar a criação de uma conta de admin no primeiro acesso. Fique atento e guarde os dados de acesso de forma segura.

Certifique-se de configurar corretamente o NGINX em seu servidor, caso não o tenha instalado em outra ocasião! O Nginx Proxy Manager (NPM) é uma ferramenta poderosa e visual que facilita muito a gestão de certificados e segurança.

Estes passos levam em consideração que este processo esteja sendo feito em uma instalação limpa.

Agora vamos conectar o seu domínio (api.seudominio.com) ao container da Evolution API e ativar o cadeado de segurança (SSL) automaticamente.

Siga estes passos dentro do painel do Proxy Manager:

Passo 1: Criar o Proxy Host

1. No painel, clique em Hosts no menu superior e depois em Proxy Hosts.

2. Clique no botão Add Proxy Host (canto superior direito).

Passo 2: Configurar a Aba "Details"

Preencha exatamente assim:

• Domain Names: Digite api.seudominio.com (ou o subdomínio exato que você criou no DNS) e aperte Enter para ele fixar a tag.

• Scheme: Deixe em http.

• Forward Hostname / IP: Digite evolution_api

  • Nota: Esse é o container_name que definimos no docker-compose.yml. Como estão na mesma rede Docker, o Proxy encontra a API por esse nome.

• Forward Port: 8080

• Cache Assets: Desativado.

• Block Common Exploits: Ative (Segurança extra).

• Websockets Support: Ative (Essencial para o QR Code e eventos em tempo real).

Passo 3: Configurar a Aba "SSL" (O Cadeado)

1. Clique na aba SSL.

2. Em SSL Certificate, selecione: "Request a new SSL Certificate".

3. Ative a opção Force SSL (Obriga o uso de HTTPS).

4. Ative HTTP/2 Support (Melhora performance).

5. Em Email Address, coloque seu email (para avisos do Let's Encrypt).

6. Marque a caixa "I Agree to the Let's Encrypt Terms of Service".

Passo 4: Salvar e Testar

1. Clique em Save.

   • O sistema vai demorar uns 10 a 20 segundos enquanto conversa com a Let's Encrypt para gerar o certificado.

2. Se der "Success", você verá o domínio na lista com o status "Online".

Agora, o teste de fogo:

Abra uma nova aba no seu navegador e acesse:

https://api.seudominio.com

O que deve aparecer:

Você deve ver o JSON de boas-vindas da Evolution API (v2):

{ "status": 200, "message": "Welcome to the Evolution API...", ... }

Próximo Passo: Configurar o Bluguezap em seu CRM

Se o link acima abriu com o cadeado seguro 🔒, sua infraestrutura está perfeita.

Agora precisamos dizer ao seu Bluguezap em sua instalação do Perfex CRM para usar esse domínio seguro. 

1. Vá no Perfex CRM -> Blugue Zap -> Configurações.

2. URL da Evolution API e digite: https://api.beseudominiolmitec.com (sem porta, sem barra no final).

3. API Key: Verifique e insira a mesma chave (B840626F...) que está no docker-compose.yml. 

4. Salve.

Teste Final de Conexão:

1. Vá em Gerenciar Zaps.

2. Crie uma nova instância (ex: "Teste HTTPS").

3. Clique em Ler QR Code.

Após estes passos a sua API está pronta.

Se a resposta for {"status":200... "version":"..."} vinda de https://api.seudominio.com confirma que sua infraestrutura "Enterprise" (V2 + HTTPS) está 100% pronta. O cadeado SSL está ativo e a API respondeu.