{"id":51026977,"url":"https://github.com/gitstq/wapi","last_synced_at":"2026-06-21T20:02:57.126Z","repository":{"id":351923735,"uuid":"1213002125","full_name":"gitstq/wapi","owner":"gitstq","description":"WhatsApp Business Automation CLI - YAML-driven WhatsApp messaging automation tool","archived":false,"fork":false,"pushed_at":"2026-04-17T03:09:55.000Z","size":77,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T05:15:06.265Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/gitstq/wapi","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-17T00:22:43.000Z","updated_at":"2026-04-17T03:09:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/wapi","commit_stats":null,"previous_names":["gitstq/wapi"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/wapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/wapi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-06-21T20:02:57.043Z","updated_at":"2026-06-21T20:02:57.110Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wapi - WhatsApp Business Automation CLI\n\n\u003cp align=\"center\"\u003e\n\n🌐 **Language / 语言**：[English](README.md) | [简体中文](README_zh-CN.md) | [繁体中文](README_zh-TW.md)\n\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-1.0.0-blue.svg\" alt=\"Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.8+-green.svg\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-orange.svg\" alt=\"License\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  🚀 | YAML-driven WhatsApp Business Automation | CLI-first | Zero Learning Curve\n\u003c/p\u003e\n\n---\n\n## 🎯 Introduction\n\n**wapi** is a powerful WhatsApp Business automation CLI tool designed for developers and businesses. Using YAML configuration files as the driving force, it enables command-line operations for message sending, contact management, mass broadcasting, scheduled tasks, and more.\n\n### 🔥 Core Value\n\n- **💬 YAML-configured Message Sending** - Say goodbye to repetitive work, batch send with one click\n- **👥 Smart Contact Management** - Groups, tags, and search - all you need\n- **⏰ Automated Scheduled Tasks** - Set it and forget it\n- **🛡️ Anti-ban Strategy** - Intelligent sending intervals to protect your account\n- **📊 Multiple Output Formats** - Terminal table/JSON/Markdown, flexible display\n\n### 💡 Inspiration\n\nInspired by WhatsApp CLI community innovations, focusing on providing developers with:\n- More powerful YAML configuration capabilities\n- More complete contact management system\n- Smarter anti-ban strategies\n- More flexible message template engine\n\n---\n\n## ✨ Features\n\n| Feature | Description |\n|---------|-------------|\n| 🔐 **WhatsApp Web Integration** | Selenium-based, no extra API required |\n| 📝 **YAML Message Config** | Template messages with variable substitution |\n| 👥 **Contact Management** | Groups, tags, import/export |\n| 📤 **Mass Broadcasting** | Large-scale sending with anti-ban strategy |\n| ⏰ **Scheduled Tasks** | Daily/interval/custom scheduling |\n| 📊 **Send Logs** | Complete message sending records |\n| 🎨 **Rich Beautified Output** | Colorful terminal, table display |\n\n---\n\n## 🚀 Quick Start\n\n### 📦 Installation\n\n```bash\n# Install from source\ngit clone https://github.com/gitstq/wapi.git\ncd wapi\npip install -e .\n\n# Or install directly\npip install wapi\n```\n\n### 🔧 Requirements\n\n- Python 3.8+\n- Chrome/Firefox browser\n- ChromeDriver/GeckoDriver (auto-installed)\n- Valid WhatsApp account\n\n### 📋 Initial Setup\n\n```bash\n# Initialize config directory\nwapi config --init\n```\n\n### 💬 Send a Single Message\n\n```bash\n# Send message to a contact\nwapi send single --to \"+8613812345678\" --message \"Hello from wapi!\"\n\n# Use message template\nwapi send single --to \"+8613812345678\" --template greeting\n```\n\n### 📤 Batch Sending\n\nCreate message config file `messages.yaml`:\n\n```yaml\nmessages:\n  - to: \"+8613812345678\"\n    message: \"Hello, this is a test message\"\n  - to: \"+8613898765432\"\n    message: \"Greetings from wapi!\"\n```\n\nExecute batch sending:\n\n```bash\n# Preview mode\nwapi send batch --file messages.yaml --dry-run\n\n# Actual sending\nwapi send batch --file messages.yaml\n```\n\n---\n\n## 📖 Detailed Usage Guide\n\n### 👥 Contact Management\n\n```bash\n# Add contact\nwapi contact add --name \"John\" --phone \"+8613812345678\" --group \"Friends\" --tags \"Important,Work\"\n\n# List contacts\nwapi contact list\n\n# Filter by group\nwapi contact list --group \"Friends\"\n\n# Filter by tag\nwapi contact list --tag \"Important\"\n\n# Delete contact\nwapi contact delete 12345678\n```\n\n### 📝 Message Templates\n\n```bash\n# Create template\nwapi template create --name \"greeting\" --template \"Hello {name}! {message}\" --description \"General greeting template\"\n\n# List all templates\nwapi template list\n\n# Send using template\nwapi send single --to \"+8613812345678\" --message \"Hello John! This is a template message\"\n```\n\n### ⏰ Scheduled Tasks\n\n```bash\n# List scheduled tasks\nwapi schedule list\n\n# Run task immediately\nwapi schedule run 12345678\n```\n\n### 🔐 WhatsApp Status Check\n\n```bash\n# Check connection status\nwapi status\n```\n\n---\n\n## 💡 Design Philosophy\n\n### 🎯 Core Principles\n\n1. **CLI-first** - All features operated via command line, no GUI required\n2. **YAML-driven** - Complex tasks defined in YAML files, simple and efficient\n3. **Zero external dependencies (optional)** - Core features only need standard library\n4. **Built-in anti-ban strategy** - Auto-handles sending intervals to reduce account risk\n\n### 🏗️ Technical Architecture\n\n```\nwapi/\n├── cli.py              # Click CLI entry point\n├── core/               # Core functionality modules\n│   ├── browser.py      # Browser driver management\n│   ├── sender.py       # Message sending core\n│   ├── contact.py      # Contact management\n│   └── scheduler.py    # Scheduled tasks\n├── config/             # Configuration module\n│   └── loader.py       # Config loader\n├── templates/          # Message template directory\n└── logs/               # Send log directory\n```\n\n### 🔮 Future Roadmap\n\n- [ ] Support more message types (images, files, videos)\n- [ ] Web interface management\n- [ ] Multi-account support\n- [ ] Cloud sync configuration\n- [ ] API service mode\n\n---\n\n## 📦 Packaging \u0026 Deployment\n\n### 🔨 Development Installation\n\n```bash\n# Clone project\ngit clone https://github.com/gitstq/wapi.git\ncd wapi\n\n# Install dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest tests/\n```\n\n### 🐳 Docker Deployment\n\n```dockerfile\nFROM python:3.11-slim\n\nWORKDIR /app\nRUN apt-get update \u0026\u0026 apt-get install -y chromium \u0026\u0026 rm -rf /var/lib/apt/lists/*\nRUN pip install wapi selenium webdriver-manager\n\nCMD [\"wapi\", \"status\"]\n```\n\n### 📱 Cross-platform Packaging\n\n```bash\n# Windows\npyinstaller --onefile --console wapi/cli.py\n\n# macOS/Linux\npyinstaller --onefile --console wapi/cli.py\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by \u003ca href=\"https://github.com/gitstq\"\u003egitstq\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fwapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fwapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fwapi/lists"}