evolution-foundation /evolution-go
Evolution API / Evolution Go is an open-source WhatsApp integration API
★ 997⑂ 604👁 16⑃ 150● 95▤ 4
+0
Daily
997
stars
604
forks
16
watchers
150
prs
95
issues
4
releases
README
Evolution Go High-performance WhatsApp API built in Go — part of the Evolution Foundation ecosystem. Website · Documentation · Community · Support --- About Evolution Go is a high-performance WhatsApp API built in Go. Part of the Evolution Foundation ecosystem, it provides a robust, lightweight solution for WhatsApp integration using the whatsmeow library. Part of the Evolution Foundation ecosystem Evolution Go is one of the messaging engines maintained by Evolution Foundation. It is used as a WhatsApp provider by the Evo CRM Community and other projects in the ecosystem. --- Features - High performance — built with Go for minimal resource usage - RESTful API — clean, well-documented REST endpoints with Swagger - Real-time events — WebSocket, Webhook, AMQP/RabbitMQ and NATS support - Media support — images, videos, audio, documents with MinIO/S3 storage - Message storage — optional PostgreSQL persistence - QR code pairing — built-in QR code generation for device linking - License management — built-in licensing with registration, activation, and heartbeat - Docker ready — production-ready Docker configuration --- Quick Start Docker (recommended) bash git clone https://github.com/evolution-foundation/evolution-go.git cd evolution-go make docker-build make docker-run Local development bash git clone https://github.com/evolution-foundation/evolution-go.git cd evolution-go Setup, configure and run make setup cp .env.example .env make dev Run make help to see all available commands. See COMMANDS.md for detailed workflows. --- Configuration Create a .env file: env Server SERVER_PORT=8080 CLIENT_NAME=evolution Security GLOBAL_API_KEY=your-secure-api-key-here Database POSTGRES_AUTH_DB=postgresql://postgres:password@localhost:5432/evogo_auth?sslmode=disable POSTGRES_USERS_DB=postgresql://postgres:password@localhost:5432/evogo_users?sslmode=disable DATABASE_SAVE_MESSAGES=false Logging WADEBUG=DEBUG LOGTYPE=console Optional AMQP_URL=amqp://guest:guest@localhost:5672/ NATS_URL=nats://localhost:4222 WEBHOOK_URL=https://your-webhook-url.com/webhook MINIO_ENABLED=true MINIO_ENDPOINT=localhost:9000 MINIO_ACCESS_KEY=minioadmin MINIO_SECRET_KEY=minioadmin | Variable | Description | Default | |---|---|---| | SERVER_PORT | Server port | 8080 | | CLIENT_NAME | Client identifier | evolution | | GLOBAL_API_KEY | API authentication key | Required | | DATABASE_SAVE_MESSAGES | Enable message storage | false | | WADEBUG | WhatsApp debug level | INFO | --- License Activation Evolution Go requires a license to operate. On first run: 1. Start the server — API endpoints return 503 until activated 2. Open the Manager at http://localhost:8080/manager/login 3. Enter your API URL and GLOBAL_API_KEY 4. Complete the license registration flow 5. Once activated, the API is fully operational The license status persists in the database (runtime_configs table). Heartbeats are se
Top issues
#70Não chega notificações no celular depois de conectado23 comments · 2026-05-28#85QRCode is not beign generated6 comments · 2026-06-17#25The uploaded image will only appear after clicking to download it.6 comments · 2026-04-17#109PostgreSQL connection leak: idle connections accumulate and exhaust max_connections (0.7.2)5 comments · 2026-07-10#106Postgres connection leak: each (re)connect on a logged-out instance leaks an unclosed sqlstore pool (evogo_auth/evogo_users)5 comments · 2026-07-07#71Testei todos os botões/listas, retorna 200 mas nenhum chega (exceto carrossel)4 comments · 2026-06-01#32erro ao enviar mensagem para numero fixo que tem whatsapp4 comments · 2026-04-20#228fix(whatsmeow): call store.SetWAVersion with dynamic webVersion to prevent 405 Client Outdated3 comments · 2026-11-03
Latest release
v0.7.3 0.7.3 2026-11-12v0.7.3 Docker: evoapicloud/evolution-go:0.7.3 🐛 Bug Fixes - Client outdated (405) on every connect. Since 2026-11-02 WhatsApp rejects the client version sent by 0.7.2 (2.3000.1042386815), so every instance dropped and could not reconnect. whatsmeow moves to 54038813c47f, which sends 2.3000.1052556849. Paired sessions reconnect without a new QR code. - Postgres connection leak on every connect and reconnect. StartClient called sqlstore.New on each run, so every connect, reconnect and client restart opened a new connection pool that was never closed: one more connection to POSTG