{"id":48830576,"url":"https://github.com/evolutionapi/evolution-go","last_synced_at":"2026-04-17T20:03:56.438Z","repository":{"id":346677664,"uuid":"1191742482","full_name":"EvolutionAPI/evolution-go","owner":"EvolutionAPI","description":"Evolution API / Evolution Go is an open-source WhatsApp integration API","archived":false,"fork":false,"pushed_at":"2026-03-25T22:27:31.000Z","size":75932,"stargazers_count":37,"open_issues_count":0,"forks_count":10,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-26T05:01:55.709Z","etag":null,"topics":["baileys","cloud-api","evo-api","evo-go","evolution","evolution-api","evolution-go","golang","whatsapp","whatsapp-bot","whatsmeow"],"latest_commit_sha":null,"homepage":"https://evolutionfoundation.com.br","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EvolutionAPI.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-25T14:43:56.000Z","updated_at":"2026-03-26T03:30:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/EvolutionAPI/evolution-go","commit_stats":null,"previous_names":["evolutionapi/evolution-go"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/EvolutionAPI/evolution-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EvolutionAPI","download_url":"https://codeload.github.com/EvolutionAPI/evolution-go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31812977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["baileys","cloud-api","evo-api","evo-go","evolution","evolution-api","evolution-go","golang","whatsapp","whatsapp-bot","whatsmeow"],"created_at":"2026-04-14T20:02:56.801Z","updated_at":"2026-04-17T20:03:56.425Z","avatar_url":"https://github.com/EvolutionAPI.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eEvolution Go\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Docker Image](https://img.shields.io/badge/Docker-image-blue)](https://hub.docker.com/r/evoapicloud/evolution-go)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](./LICENSE)\n[![Go Version](https://img.shields.io/badge/Go-1.24+-00ADD8?logo=go)](https://golang.org/)\n[![GitHub Stars](https://img.shields.io/github/stars/EvolutionAPI/evolution-go)](https://github.com/EvolutionAPI/evolution-go/stargazers)\n[![Documentation](https://img.shields.io/badge/Documentation-Official-green)](https://docs.evolutionfoundation.com.br)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\u003cimg src=\"./public/images/cover.png\" width=\"400\"\u003e\u003c/div\u003e\n\n## About\n\nEvolution Go is a high-performance WhatsApp API built in Go, part of the [Evolution](https://evolutionfoundation.com.br/) ecosystem. It provides a robust, lightweight solution for WhatsApp integration using the [whatsmeow](https://github.com/tulir/whatsmeow) library.\n\n## Features\n\n- **High Performance** — Built with Go for minimal resource usage\n- **RESTful API** — Clean, well-documented REST endpoints with Swagger\n- **Real-time Events** — WebSocket, Webhook, AMQP/RabbitMQ and NATS support\n- **Media Support** — Images, videos, audio, documents with MinIO/S3 storage\n- **Message Storage** — Optional PostgreSQL persistence\n- **QR Code Pairing** — Built-in QR code generation for device linking\n- **License Management** — Built-in licensing with registration, activation, and heartbeat\n- **Docker Ready** — Production-ready Docker configuration\n\n## Quick Start\n\n### Docker (Recommended)\n\n```bash\ngit clone https://github.com/EvolutionAPI/evolution-go.git\ncd evolution-go\nmake docker-build\nmake docker-run\n```\n\n### Local Development\n\n```bash\ngit clone https://github.com/EvolutionAPI/evolution-go.git\ncd evolution-go\n\n# Clone whatsmeow dependency\ngit clone git@github.com:EvolutionAPI/whatsmeow.git whatsmeow-lib\n\n# Setup, configure and run\nmake setup\ncp .env.example .env\nmake dev\n```\n\n\u003e Run `make help` to see all available commands. See [COMMANDS.md](./COMMANDS.md) for detailed workflows.\n\n## Configuration\n\nCreate a `.env` file:\n\n```env\n# Server\nSERVER_PORT=8080\nCLIENT_NAME=evolution\n\n# Security\nGLOBAL_API_KEY=your-secure-api-key-here\n\n# Database\nPOSTGRES_AUTH_DB=postgresql://postgres:password@localhost:5432/evogo_auth?sslmode=disable\nPOSTGRES_USERS_DB=postgresql://postgres:password@localhost:5432/evogo_users?sslmode=disable\nDATABASE_SAVE_MESSAGES=false\n\n# Logging\nWADEBUG=DEBUG\nLOGTYPE=console\n\n# Optional\n# AMQP_URL=amqp://guest:guest@localhost:5672/\n# NATS_URL=nats://localhost:4222\n# WEBHOOK_URL=https://your-webhook-url.com/webhook\n# MINIO_ENABLED=true\n# MINIO_ENDPOINT=localhost:9000\n# MINIO_ACCESS_KEY=minioadmin\n# MINIO_SECRET_KEY=minioadmin\n```\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `SERVER_PORT` | Server port | `8080` |\n| `CLIENT_NAME` | Client identifier | `evolution` |\n| `GLOBAL_API_KEY` | API authentication key | **Required** |\n| `DATABASE_SAVE_MESSAGES` | Enable message storage | `false` |\n| `WADEBUG` | WhatsApp debug level | `INFO` |\n\n## License Activation\n\nEvolution Go requires a license to operate. On first run:\n\n1. Start the server — API endpoints return `503` until activated\n2. Open the **Manager** at `http://localhost:8080/manager/login`\n3. Enter your API URL and `GLOBAL_API_KEY`\n4. Complete the license registration flow\n5. Once activated, the API is fully operational\n\nThe license status persists in the database (`runtime_configs` table). Heartbeats are sent periodically to maintain activation.\n\n## API Documentation\n\nSwagger UI available at:\n\n```\nhttp://localhost:8080/swagger/index.html\n```\n\n### Key Endpoints\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| `POST` | `/instance/create` | Create WhatsApp instance |\n| `GET` | `/instance/{name}/qrcode` | Get QR code for pairing |\n| `POST` | `/message/sendText` | Send text message |\n| `POST` | `/message/sendMedia` | Send media message |\n| `GET` | `/instance/{name}/status` | Get instance status |\n| `DELETE` | `/instance/{name}` | Delete instance |\n\n## Project Structure\n\n```\nevolution-go/\n├── cmd/evolution-go/     # Application entry point\n├── pkg/\n│   ├── core/            # License management \u0026 middleware\n│   ├── instance/        # Instance management\n│   ├── message/         # Message handling\n│   ├── sendMessage/     # Message sending\n│   ├── routes/          # HTTP routes\n│   ├── middleware/       # Auth \u0026 validation middleware\n│   ├── config/          # Configuration\n│   ├── events/          # Event producers (AMQP, NATS, Webhook, WS)\n│   └── storage/         # Media storage (MinIO)\n├── whatsmeow-lib/       # WhatsApp protocol library\n├── docs/                # Swagger documentation\n├── Dockerfile\n├── Makefile\n└── VERSION\n```\n\n## Technology Stack\n\n| Component | Technology |\n|-----------|-----------|\n| Language | Go 1.24+ |\n| HTTP Framework | Gin |\n| WhatsApp | [whatsmeow](https://github.com/tulir/whatsmeow) |\n| Database | PostgreSQL |\n| ORM | GORM |\n| Message Queue | RabbitMQ, NATS |\n| Object Storage | MinIO/S3 |\n| Documentation | Swagger/OpenAPI |\n| Container | Docker |\n\n## Documentation \u0026 Support\n\n| Resource | Link |\n|----------|------|\n| Website | [evolutionfoundation.com.br](https://evolutionfoundation.com.br/) |\n| Documentation | [docs.evolutionfoundation.com.br](https://docs.evolutionfoundation.com.br/) |\n| Community | [evolutionfoundation.com.br/community](https://evolutionfoundation.com.br/community) |\n| WhatsApp Support | [+55 31 9621-9989](https://wa.me/553196219989) |\n| GitHub Issues | [evolution-go/issues](https://github.com/EvolutionAPI/evolution-go/issues) |\n\n## Hosting\n\nDeploy Evolution Go with optimized infrastructure:\n\n| Product | Link |\n|---------|------|\n| Evolution Go VPS | [Hostgator - Evo Go](https://www.hostgator.com.br/52579-144-3-55.html) |\n| Evolution API VPS | [Hostgator - Evo API](https://www.hostgator.com.br/servidor-vps/hospedagem-evo-api/lp-afiliado) |\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## Security\n\nFor security concerns, please email: contato@evolution-api.com\n\n## License\n\nEvolution Go is licensed under the Apache License 2.0, with the following additional conditions:\n\n1. **Logo and copyright**: You may not remove or modify the logo or copyright information in the Evolution console or applications when using frontend components.\n\n2. **Usage notification**: If Evolution Go is used as part of any project (including closed-source), a clear notification that Evolution Go is being utilized must be visible to system administrators.\n\nPlease contact contato@evolution-api.com for licensing inquiries. Full license details at [apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0).\n\n## Acknowledgments\n\n- [whatsmeow](https://github.com/tulir/whatsmeow) by [tulir](https://github.com/tulir)\n- [Evolution API](https://github.com/EvolutionAPI/evolution-api)\n\n## Telemetry\n\nEvolution Go collects anonymous telemetry data (routes used, API version) to improve the service. No sensitive or personal data is collected.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Evolution Go** — High-Performance WhatsApp API\n\nMade with ❤️ by the [Evolution Team](https://evolutionfoundation.com.br/)\n\n© 2025 Evolution Foundation\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolutionapi%2Fevolution-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevolutionapi%2Fevolution-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolutionapi%2Fevolution-go/lists"}