Instalação do Evolution Go

Este guia irá ajudá-lo a instalar e configurar o Evolution Go, nossa API WhatsApp de alta performance escrita em Go.

Pré-requisitos

Antes de iniciar, certifique-se de ter os seguintes requisitos atendidos:

Docker 20.10 ou superior
Docker Compose v2.x (opcional)
Mínimo de 512MB de RAM disponível

Instalação com Docker

A forma mais rápida de começar a usar o Evolution Go.

Passo 1: Clone o repositório

git clone https://git.evoai.app/Evolution/evolution-go.git
cd evolution-go

Passo 2: Configure as variáveis de ambiente

cp .env.example .env

Edite o arquivo .env com suas configurações:

# Porta do servidor
SERVER_PORT=8080

# Nome do cliente
CLIENT_NAME=evolution

# Chave de API global (altere para uma chave segura!)
GLOBAL_API_KEY=sua-chave-secura-aqui

# Banco de dados (PostgreSQL)
POSTGRES_AUTH_DB=postgresql://postgres:password@postgres:5432/evogo_auth?sslmode=disable
POSTGRES_USERS_DB=postgresql://postgres:password@postgres:5432/evogo_users?sslmode=disable
DATABASE_SAVE_MESSAGES=false

# Logs
WADEBUG=INFO
LOGTYPE=console

Nunca utilize a chave de API padrão do .env.example em produção. Gere uma chave segura e única.

Passo 3: Build e execução

# Build da imagem Docker
make docker-build

# Executar o container
make docker-run

O serviço estará disponível em http://localhost:8080.

Alternativa: Docker Compose

Você também pode usar um docker-compose.yml para subir o Evolution Go junto com o PostgreSQL:

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

  evolution-go:
    image: evoapicloud/evolution-go:latest
    ports:
      - "8080:8080"
    environment:
      SERVER_PORT: 8080
      CLIENT_NAME: evolution
      GLOBAL_API_KEY: sua-chave-segura-aqui
      POSTGRES_AUTH_DB: postgresql://postgres:password@postgres:5432/evogo_auth?sslmode=disable
      POSTGRES_USERS_DB: postgresql://postgres:password@postgres:5432/evogo_users?sslmode=disable
      DATABASE_SAVE_MESSAGES: "false"
      WADEBUG: INFO
      LOGTYPE: console
    depends_on:
      - postgres
    restart: unless-stopped

volumes:
  postgres_data:

Execute com:

docker compose up -d

Verificando a instalação

Após iniciar o serviço, verifique se está funcionando corretamente:

Teste de saúde

curl http://localhost:8080/

Acesse a documentação Swagger

Abra no navegador:

http://localhost:8080/swagger/index.html

Crie sua primeira instância WhatsApp

curl -X POST http://localhost:8080/instance/create \
  -H "Content-Type: application/json" \
  -H "apikey: sua-chave-segura-aqui" \
  -d '{
    "instanceName": "minha-instancia",
    "integration": "WHATSAPP-BAILEYS"
  }'

Obtenha o QR Code para conectar

curl http://localhost:8080/instance/minha-instancia/qrcode \
  -H "apikey: sua-chave-segura-aqui"

Escaneie o QR Code com o WhatsApp do seu celular para conectar a instância.

Variáveis de ambiente

Tabela completa das variáveis de configuração disponíveis:

Variável	Descrição	Padrão
`SERVER_PORT`	Porta do servidor HTTP	`8080`
`CLIENT_NAME`	Identificador do cliente	`evolution`
`GLOBAL_API_KEY`	Chave de autenticação da API	Obrigatório
`POSTGRES_AUTH_DB`	String de conexão do banco de autenticação	-
`POSTGRES_USERS_DB`	String de conexão do banco de usuários	-
`DATABASE_SAVE_MESSAGES`	Habilitar persistência de mensagens	`false`
`WADEBUG`	Nível de log do WhatsApp (`DEBUG`, `INFO`, `WARN`, `ERROR`)	`INFO`
`LOGTYPE`	Tipo de saída de log (`console`, `json`)	`console`
`CONNECT_ON_STARTUP`	Reconectar instâncias ao iniciar	`true`
`WEBHOOKFILES`	Incluir arquivos nos webhooks	`true`
`WEBHOOK_URL`	URL para receber webhooks	-
`AMQP_URL`	URL de conexão do RabbitMQ	-
`AMQP_GLOBAL_ENABLED`	Habilitar RabbitMQ globalmente	`false`
`MINIO_ENABLED`	Habilitar armazenamento MinIO/S3	`false`
`MINIO_ENDPOINT`	Endpoint do MinIO	-
`MINIO_ACCESS_KEY`	Chave de acesso do MinIO	-
`MINIO_SECRET_KEY`	Chave secreta do MinIO	-
`MINIO_BUCKET`	Nome do bucket do MinIO	`evolution-media`
`MINIO_USE_SSL`	Usar SSL na conexão MinIO	`false`

Comandos úteis (Docker)

# Build da imagem Docker
make docker-build

# Executar container Docker
make docker-run

Próximos passos

Após a instalação, você pode:

Consultar a Referência API para conhecer todos os endpoints disponíveis
Configurar webhooks para receber notificações em tempo real
Integrar com RabbitMQ para processamento assíncrono de mensagens

Primeiros Passos

Configuração

Integrações

Pré-requisitos

Instalação com Docker

Passo 1: Clone o repositório

Passo 2: Configure as variáveis de ambiente

Passo 3: Build e execução

Alternativa: Docker Compose

Verificando a instalação

Teste de saúde

Acesse a documentação Swagger

Crie sua primeira instância WhatsApp

Obtenha o QR Code para conectar

Variáveis de ambiente

Comandos úteis (Docker)

Próximos passos

​Pré-requisitos

​Instalação com Docker

​Passo 1: Clone o repositório

​Passo 2: Configure as variáveis de ambiente

​Passo 3: Build e execução

​Alternativa: Docker Compose

​Verificando a instalação

​Teste de saúde

​Acesse a documentação Swagger

​Crie sua primeira instância WhatsApp

​Obtenha o QR Code para conectar

​Variáveis de ambiente

​Comandos úteis (Docker)

​Próximos passos

Pré-requisitos

Instalação com Docker

Passo 1: Clone o repositório

Passo 2: Configure as variáveis de ambiente

Passo 3: Build e execução

Alternativa: Docker Compose

Verificando a instalação

Teste de saúde

Acesse a documentação Swagger

Crie sua primeira instância WhatsApp

Obtenha o QR Code para conectar

Variáveis de ambiente

Comandos úteis (Docker)

Próximos passos