evolution-foundation /evolution-go

Evolution API / Evolution Go is an open-source WhatsApp integration API

★ 997⑂ 604👁 16⑃ 150● 95▤ 4
GoNOASSERTIONCreated 2026-03-25evolutionfoundation.com.br
下载:v0.7.3v0.7.3 ↓0.7.32026-11-12
+0
日增长
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

Latest release

v0.7.3 0.7.3 2026-11-12
v0.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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON