Variáveis de Ambiente
Referência rápida de variáveis de ambiente do Evolution GO.
Para documentação detalhada, consulte: Configuração
Obrigatórias
| Variável |
Descrição |
Exemplo |
GLOBAL_API_KEY |
Chave de autenticação da API |
df16caad-d0d2-41b2-bec5-75b90048a0db |
DATABASE_SAVE_MESSAGES |
Salvar mensagens no banco |
false |
Servidor
| Variável |
Padrão |
Descrição |
SERVER_PORT |
4000 |
Porta HTTP |
CLIENT_NAME |
evolution |
Nome identificador |
OS_NAME |
Linux |
Sistema operacional |
Banco de Dados
| Variável |
Descrição |
POSTGRES_AUTH_DB |
Connection string banco de autenticação |
POSTGRES_USERS_DB |
Connection string banco de usuários |
Formato:
POSTGRES_AUTH_DB=postgresql://user:pass@host:5432/evogo_auth?sslmode=disable
POSTGRES_USERS_DB=postgresql://user:pass@host:5432/evogo_users?sslmode=disable
Logs
| Variável |
Padrão |
Valores |
Descrição |
WADEBUG |
INFO |
DEBUG, INFO, WARN, ERROR |
Nível de log |
LOGTYPE |
console |
console, file |
Destino de saída |
LOG_DIRECTORY |
/app/logs |
- |
Diretório de arquivos de log |
LOG_MAX_SIZE |
100 |
- |
Tamanho máximo por arquivo (MB) |
LOG_MAX_BACKUPS |
5 |
- |
Arquivos de backup a manter |
LOG_MAX_AGE |
30 |
- |
Retenção em dias |
LOG_COMPRESS |
true |
true/false |
Compressão de logs antigos |
Conexão e Comportamento
| Variável |
Padrão |
Descrição |
CONNECT_ON_STARTUP |
false |
Conectar instâncias ao iniciar servidor |
WEBHOOK_FILES |
true |
Enviar URLs de mídia em webhooks |
QRCODE_MAX_COUNT |
5 |
Tentativas máximas de QR Code |
CHECK_USER_EXISTS |
true |
Validar destinatário antes de enviar |
Eventos
| Variável |
Padrão |
Descrição |
EVENT_IGNORE_GROUP |
false |
Ignorar eventos de grupos |
EVENT_IGNORE_STATUS |
true |
Ignorar eventos de status/stories |
WEBHOOK_URL |
- |
URL para callbacks HTTP |
RabbitMQ (AMQP)
| Variável |
Descrição |
AMQP_URL |
URL de conexão RabbitMQ |
AMQP_GLOBAL_ENABLED |
Habilitar filas globais |
AMQP_GLOBAL_EVENTS |
Eventos a publicar (separados por vírgula) |
AMQP_SPECIFIC_EVENTS |
Eventos específicos por instância |
Exemplo:
AMQP_URL=amqp://user:pass@rabbitmq:5672/vhost
AMQP_GLOBAL_ENABLED=true
AMQP_GLOBAL_EVENTS=messages.upsert,messages.update,connection.update
NATS
| Variável |
Descrição |
NATS_URL |
URL de conexão NATS |
NATS_GLOBAL_ENABLED |
Habilitar publicação global |
NATS_GLOBAL_EVENTS |
Eventos a publicar |
Exemplo:
NATS_URL=nats://nats:4222
NATS_GLOBAL_ENABLED=true
NATS_GLOBAL_EVENTS=messages.upsert,connection.update
MinIO/S3
| Variável |
Descrição |
MINIO_ENABLED |
Habilitar armazenamento S3-compatible |
MINIO_ENDPOINT |
Endpoint do servidor |
MINIO_ACCESS_KEY |
Access Key para autenticação |
MINIO_SECRET_KEY |
Secret Key para autenticação |
MINIO_BUCKET |
Nome do bucket |
MINIO_USE_SSL |
Utilizar HTTPS |
MINIO_REGION |
Região do bucket (AWS) |
Exemplo:
MINIO_ENABLED=true
MINIO_ENDPOINT=localhost:9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=evolution-media
MINIO_USE_SSL=false
MINIO_REGION=us-east-1
Proxy HTTP
| Variável |
Descrição |
PROXY_HOST |
Hostname do proxy |
PROXY_PORT |
Porta do proxy |
PROXY_USERNAME |
Usuário (opcional) |
PROXY_PASSWORD |
Senha (opcional) |
Exemplo:
PROXY_HOST=proxy.empresa.com
PROXY_PORT=8080
PROXY_USERNAME=usuario
PROXY_PASSWORD=senha
Recursos Adicionais
| Variável |
Descrição |
API_AUDIO_CONVERTER |
URL de serviço de conversão de áudio |
API_AUDIO_CONVERTER_KEY |
Chave de autenticação do conversor |
Versão WhatsApp (Avançado)
| Variável |
Descrição |
WHATSAPP_VERSION_MAJOR |
Versão major do WhatsApp Web |
WHATSAPP_VERSION_MINOR |
Versão minor do WhatsApp Web |
WHATSAPP_VERSION_PATCH |
Versão patch do WhatsApp Web |
⚠️ Atenção: Modificar versão do WhatsApp pode resultar em bloqueio. Deixar vazio para usar versão automática.
Exemplo Completo
# Obrigatórias
GLOBAL_API_KEY=df16caad-d0d2-41b2-bec5-75b90048a0db
DATABASE_SAVE_MESSAGES=false
# Servidor
SERVER_PORT=4000
CLIENT_NAME=evolution
OS_NAME=Linux
# Banco de Dados
POSTGRES_AUTH_DB=postgresql://postgres:senha@postgres:5432/evogo_auth?sslmode=disable
POSTGRES_USERS_DB=postgresql://postgres:senha@postgres:5432/evogo_users?sslmode=disable
# Logs
WADEBUG=INFO
LOGTYPE=console
# Comportamento
CONNECT_ON_STARTUP=false
WEBHOOK_FILES=true
CHECK_USER_EXISTS=true
EVENT_IGNORE_STATUS=true
# Webhook
WEBHOOK_URL=https://seu-servidor.com/webhook
# RabbitMQ (opcional)
AMQP_URL=amqp://admin:admin@rabbitmq:5672/default
AMQP_GLOBAL_ENABLED=true
AMQP_GLOBAL_EVENTS=messages.upsert,connection.update
# MinIO (opcional)
MINIO_ENABLED=true
MINIO_ENDPOINT=minio:9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=evolution-media
MINIO_USE_SSL=false
Recursos
Documentação Evolution GO v1.0