{"id":48830561,"url":"https://github.com/evolutionapi/evolution-manager-v2","last_synced_at":"2026-04-14T20:03:06.685Z","repository":{"id":315682686,"uuid":"831146116","full_name":"EvolutionAPI/evolution-manager-v2","owner":"EvolutionAPI","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-07T17:21:58.000Z","size":30496,"stargazers_count":14,"open_issues_count":2,"forks_count":37,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-01T22:24:23.475Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-07-19T19:14:12.000Z","updated_at":"2025-11-18T11:43:59.000Z","dependencies_parsed_at":"2025-09-20T03:52:29.817Z","dependency_job_id":"2ed42681-6d44-44c5-a7d7-57af5a236ac8","html_url":"https://github.com/EvolutionAPI/evolution-manager-v2","commit_stats":null,"previous_names":["evolutionapi/evolution-manager-v2"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/EvolutionAPI/evolution-manager-v2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-manager-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-manager-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-manager-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-manager-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EvolutionAPI","download_url":"https://codeload.github.com/EvolutionAPI/evolution-manager-v2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvolutionAPI%2Fevolution-manager-v2/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":[],"created_at":"2026-04-14T20:02:56.374Z","updated_at":"2026-04-14T20:03:06.669Z","avatar_url":"https://github.com/EvolutionAPI.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Evolution Manager v2\n\n\u003cdiv align=\"center\"\u003e\n\n![Evolution Manager Logo](public/assets/images/evolution-logo.png)\n\n**Modern Web Interface for Evolution API Management**\n\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)\n[![React](https://img.shields.io/badge/React-18.3.1-blue.svg)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.2.2-blue.svg)](https://www.typescriptlang.org/)\n[![Vite](https://img.shields.io/badge/Vite-5.3.4-646CFF.svg)](https://vitejs.dev/)\n\n[🌐 Demo](https://manager.evolution-api.com) • [📖 Documentation](https://doc.evolution-api.com) • [💬 Community](https://evolution-api.com/discord)\n\n\u003c/div\u003e\n\n## 📋 Table of Contents\n\n- [About](#about)\n- [Features](#features)\n- [Screenshots](#screenshots)\n- [Quick Start](#quick-start)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Development](#development)\n- [Docker](#docker)\n- [API Integration](#api-integration)\n- [Internationalization](#internationalization)\n- [Contributing](#contributing)\n- [License](#license)\n- [Support](#support)\n\n## 🚀 About\n\nEvolution Manager v2 is a modern, responsive web interface built with React and TypeScript for managing [Evolution API](https://github.com/EvolutionAPI/evolution-api) instances. It provides a comprehensive dashboard for WhatsApp API management, chatbot integrations, and real-time monitoring.\n\n### Key Highlights\n\n- 🎨 **Modern UI/UX** - Built with Radix UI and Tailwind CSS\n- 🌍 **Multi-language** - Support for PT-BR, EN-US, ES-ES, FR-FR\n- 📱 **Responsive Design** - Works perfectly on desktop and mobile\n- ⚡ **Real-time Updates** - WebSocket integration for live data\n- 🔧 **Easy Configuration** - Environment-based configuration\n- 🐳 **Docker Ready** - Containerized deployment\n\n## ✨ Features\n\n### 📊 **Dashboard \u0026 Monitoring**\n- Instance overview and status monitoring\n- Real-time connection status\n- Performance metrics and analytics\n- Multi-instance management\n\n### 💬 **Chat Management**\n- WhatsApp chat interface\n- Message history and search\n- Media file handling\n- Contact management\n\n### 🤖 **Chatbot Integrations**\n- **OpenAI** - GPT-powered conversations\n- **Dify** - AI workflow automation\n- **Typebot** - Visual flow builder\n- **Chatwoot** - Customer support platform\n- **Flowise** - Low-code AI apps\n- **N8N** - Workflow automation\n- **Evolution Bot** - Built-in chatbot\n\n### 🔗 **Event Integrations**\n- **Webhook** - HTTP event delivery\n- **WebSocket** - Real-time events\n- **RabbitMQ** - Message queue integration\n- **SQS** - Amazon Simple Queue Service\n- **Apache Kafka** - Event streaming platform\n\n### ⚙️ **Configuration Management**\n- Instance settings and behavior\n- Proxy configuration\n- Authentication management\n- Environment variables\n\n### 🎨 **User Experience**\n- Dark/Light theme support\n- Multi-language interface\n- Responsive design\n- Keyboard shortcuts\n- Accessibility features\n\n## 📸 Screenshots\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to view screenshots\u003c/summary\u003e\n\n### Dashboard\n![Dashboard](docs/images/dashboard.png)\n\n### Chat Interface\n![Chat](docs/images/chat.png)\n\n### Chatbot Configuration\n![Chatbot](docs/images/chatbot.png)\n\n### Settings\n![Settings](docs/images/settings.png)\n\n\u003c/details\u003e\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 18+ and npm\n- Evolution API instance running\n- Modern web browser\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/EvolutionAPI/evolution-manager-v2.git\ncd evolution-manager-v2\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n```\n\nOpen [http://localhost:5173](http://localhost:5173) in your browser.\n\n## 📦 Installation\n\n### Method 1: NPM (Recommended)\n\n```bash\n# Install globally\nnpm install -g evolution-manager\n\n# Or run directly\nnpx evolution-manager\n```\n\n### Method 2: Docker\n\n```bash\n# Pull and run\ndocker run -p 3000:80 evolutionapi/evolution-manager:latest\n\n# Or use docker-compose\ndocker-compose up -d\n```\n\n### Method 3: Build from Source\n\n```bash\n# Clone repository\ngit clone https://github.com/EvolutionAPI/evolution-manager-v2.git\ncd evolution-manager-v2\n\n# Install dependencies\nnpm install\n\n# Build for production\nnpm run build\n\n# Serve built files\nnpm run preview\n```\n\n## ⚙️ Configuration\n\n### Environment Variables\n\nCreate a `.env` file in the root directory:\n\n```env\n# Evolution API Configuration\nVITE_EVOLUTION_API_URL=http://localhost:8080\nVITE_EVOLUTION_API_KEY=your-api-key\n\n# Application Configuration\nVITE_APP_NAME=\"Evolution Manager\"\nVITE_APP_VERSION=\"2.0.0\"\n\n# Optional: Custom Branding\nVITE_LOGO_URL=\"/assets/images/custom-logo.png\"\nVITE_FAVICON_URL=\"/assets/images/custom-favicon.ico\"\n\n# Optional: Analytics\nVITE_GOOGLE_ANALYTICS_ID=GA_MEASUREMENT_ID\n```\n\n### API Connection\n\nThe manager connects to your Evolution API instance. Configure the connection in the login screen or via environment variables.\n\n### Customization\n\n- **Themes**: Modify `src/index.css` for custom styling\n- **Languages**: Add translations in `src/translate/languages/`\n- **Components**: Extend UI components in `src/components/ui/`\n\n## 🛠️ Development\n\n### Development Setup\n\n```bash\n# Install dependencies\nnpm install\n\n# Start development server with hot reload\nnpm run dev\n\n# Run linting\nnpm run lint\n\n# Type checking\nnpm run type-check\n```\n\n### Project Structure\n\n```\nsrc/\n├── components/          # Reusable UI components\n│   ├── ui/             # Base UI components (Radix + Tailwind)\n│   └── providers/      # Context providers\n├── pages/              # Application pages/routes\n├── lib/                # Utilities and API clients\n│   ├── queries/        # React Query hooks\n│   └── utils.ts        # Helper functions\n├── contexts/           # React contexts\n├── translate/          # Internationalization\n├── types/              # TypeScript type definitions\n└── services/           # External service integrations\n```\n\n### Tech Stack\n\n- **Frontend**: React 18, TypeScript, Vite\n- **UI Library**: Radix UI, Tailwind CSS\n- **State Management**: React Query, Context API\n- **Routing**: React Router DOM\n- **Forms**: React Hook Form + Zod\n- **Icons**: Lucide React\n- **Charts**: Recharts\n- **Real-time**: Socket.io Client\n\n## 🐳 Docker\n\n### Using Docker Compose\n\n```yaml\nversion: '3.8'\nservices:\n  evolution-manager:\n    image: evolutionapi/evolution-manager:latest\n    ports:\n      - \"3000:80\"\n    environment:\n      - VITE_EVOLUTION_API_URL=http://evolution-api:8080\n    depends_on:\n      - evolution-api\n```\n\n### Building Custom Image\n\n```bash\n# Build image\ndocker build -t my-evolution-manager .\n\n# Run container\ndocker run -p 3000:80 my-evolution-manager\n```\n\n## 🔌 API Integration\n\n### Connecting to Evolution API\n\n1. **Login Screen**: Enter your Evolution API URL and credentials\n2. **Environment**: Set `VITE_EVOLUTION_API_URL` and `VITE_EVOLUTION_API_KEY`\n3. **Runtime**: Configure via the settings page\n\n### API Endpoints\n\nThe manager uses the following Evolution API endpoints:\n\n- `GET /instance` - List instances\n- `POST /instance` - Create instance\n- `GET /instance/:name` - Get instance details\n- `POST /message/sendText` - Send messages\n- `GET /chat` - List chats\n- And many more...\n\n### Authentication\n\nSupports multiple authentication methods:\n- API Key authentication\n- JWT tokens\n- Instance-specific tokens\n\n## 🌍 Internationalization\n\n### Supported Languages\n\n- 🇧🇷 **Portuguese (Brazil)** - `pt-BR`\n- 🇺🇸 **English (US)** - `en-US`\n- 🇪🇸 **Spanish** - `es-ES`\n- 🇫🇷 **French** - `fr-FR`\n\n### Adding New Languages\n\n1. Create translation file in `src/translate/languages/`\n2. Add language option in `src/components/language-toggle.tsx`\n3. Update `src/translate/i18n.ts`\n\nExample translation file structure:\n\n```json\n{\n  \"dashboard\": {\n    \"title\": \"Dashboard\",\n    \"instances\": \"Instances\"\n  },\n  \"chat\": {\n    \"send\": \"Send\",\n    \"message\": \"Message\"\n  }\n}\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n### Development Process\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Make your changes\n4. Run tests: `npm run test`\n5. Commit changes: `npm run commit`\n6. Push to branch: `git push origin feature/amazing-feature`\n7. Open a Pull Request\n\n### Code Style\n\n- Use TypeScript for all new code\n- Follow the existing code style\n- Run `npm run lint` before committing\n- Write meaningful commit messages\n\n### Reporting Issues\n\nPlease use our [Issue Templates](.github/ISSUE_TEMPLATE/) when reporting bugs or requesting features.\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 with additional conditions - see the [LICENSE](LICENSE) file for details.\n\n### Commercial Usage\n\nEvolution Manager can be used commercially, but please review the license conditions regarding:\n- Logo and copyright information\n- Usage notification requirements\n\nFor commercial licensing inquiries, contact: contato@evolution-api.com\n\n## 🆘 Support\n\n### Community Support\n\n- 💬 **Discord**: [Join our community](https://evolution-api.com/discord)\n- 📖 **Documentation**: [Official docs](https://doc.evolution-api.com)\n- 🐛 **Issues**: [GitHub Issues](https://github.com/EvolutionAPI/evolution-manager-v2/issues)\n\n### Professional Support\n\n- 📧 **Email**: contato@evolution-api.com\n- 🌐 **Website**: [evolution-api.com](https://evolution-api.com)\n- 💼 **Enterprise**: Custom solutions available\n\n### FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003eHow do I connect to my Evolution API instance?\u003c/summary\u003e\n\nUse the login screen to enter your API URL and credentials, or set the `VITE_EVOLUTION_API_URL` environment variable.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eCan I customize the interface?\u003c/summary\u003e\n\nYes! You can modify themes, add languages, and customize components. See the [Configuration](#configuration) section.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eIs this compatible with Evolution API v1?\u003c/summary\u003e\n\nEvolution Manager v2 is designed for Evolution API v2+. For v1 compatibility, use Evolution Manager v1.\n\u003c/details\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the Evolution API Team**\n\n[⭐ Star us on GitHub](https://github.com/EvolutionAPI/evolution-manager-v2) • [🐛 Report Issues](https://github.com/EvolutionAPI/evolution-manager-v2/issues) • [💬 Join Discord](https://evolution-api.com/discord)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolutionapi%2Fevolution-manager-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevolutionapi%2Fevolution-manager-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolutionapi%2Fevolution-manager-v2/lists"}