Build a Personal Zalo Chatbot
& Automate Customer Replies with AI
Turn your standard personal Zalo account into an intelligent 24/7 sales and customer support assistant. Powered by Gemini & DeepSeek AI, automatic contact phone extraction, personalized remarketing, and 3-layer immutable anti-ban protection.
git clone https://github.com/aizaloapp/zalo-flow.git
ZaloFlow-Setup-v1.5.0.exe for the first time, if the blue "Windows protected your PC" (Microsoft Defender SmartScreen) dialog appears, simply click More info ➔ then click Run anyway.* Reason: Non-commercial open-source community software does not purchase expensive Microsoft Code Signing certificates (~$300/year). The binary is 100% clean of malware (VirusTotal: 0/70 detections). Verifiable SHA-256 release checksums are published on GitHub Releases.
Everything You Need To Automate Personal Zalo
Zero coding knowledge required. 1-Click setup deploys a full-featured customer support engine running quietly in the background.
Multi-Provider AI Intelligence
Directly connect with Google Gemini, DeepSeek, and OpenAI. Responds with situational nuance, product awareness, and adapts to your personal brand voice.
Contact Card & Phone Parsing
Automatically detects shared contact cards (chat.contact), strips raw JSON artifacts, normalizes Vietnamese phone numbers into 0xxxxxxxxx, and stores them neatly.
3-Layer Anti-Ban Defense
Maximum account protection: Token Bucket Rate Limiter with >= 3s pacing (max 20 msgs/min), Self-Echo Shield preventing echo loops, and an Inbound Flood Detector.
Intuitive Web Dashboard
Control your workspace at localhost:3000. View threads, jump into live customer conversations, manage contacts, and organize leads with colored tags.
Targeted Remarketing & Spintax
Schedule automated follow-ups by tag. Built-in Spintax engine {Hello|Hi|Greetings} randomizes text phrasing to prevent pattern repetition.
Self-Healing Architecture
Intelligent memory watchdog (< 350MB ceiling). Automatically drains pending outbound messages and checkpoints the SQLite database before gracefully recycling.
Why Zalo-Flow Is The Ideal Choice
An objective comparison between Zalo-Flow, official Zalo Official Account (OA), and commercial proprietary alternatives.
| Comparison Factor | Zalo-Flow (Open Source) | Zalo OA Enterprise | Commercial Closed-Source Tools |
|---|---|---|---|
| License & Pricing | 100% Free Forever (MIT + Commons) | Monthly subscription + per-message fees | $15 - $45 / month recurring fee |
| Account Type | Personal Zalo Account (Anyone has one) | Requires business registration certificate | Personal Zalo Account |
| Data Privacy & Storage | Stored on your PC (SQLite AES-256) | Stored on Zalo cloud servers | Stored on unknown third-party servers |
| AI Engine Flexibility | Full Choice: Gemini, DeepSeek, OpenAI | Restricted by tier capabilities | Locked to fixed proprietary models |
| Multi-Agent Scalability | Native Chatwoot CRM integration | Requires paid seat upgrades | Closed proprietary UI |
| Code Transparency | 100% Public on GitHub | Closed proprietary | Closed proprietary (Black box) |
* Comparison accurate as of September 2026. All product names and registered trademarks are properties of their respective owners.
3 Simple Steps To Get Running
No complicated terminal configurations required. Anyone can be fully operational in under 3 minutes.
Download & Install
Download ZaloFlow-Setup-v1.5.0.exe from GitHub. Run the 1-click installer bundled with portable runtime — no Node.js installation required.
Scan Zalo QR Code
Your browser opens http://localhost:3000. Use your personal Zalo mobile app to scan the QR code for encrypted local login via AES-256.
Activate AI & Enjoy
Paste your free Gemini or DeepSeek API key into the AI Settings panel. Your bot immediately begins handling inquiries 24/7 according to your prompt.
Technical Insights & Tutorials
Deep-dive technical articles on Zalo automation, anti-ban protocols, and CRM integration strategies.
Learn how Token Bucket rate limiting, Self-Echo shields, and Spintax variation maintain natural human messaging dynamics.
Installation GuideStep-by-step walkthrough: 1-click Windows setup, bypassing Defender SmartScreen, and scanning QR codes securely.
Artificial IntelligenceAcquiring free Google AI Studio keys, tuning prompt templates, and extracting phone numbers automatically from contact cards.
Customer Care CRMWhy Zalo CRM adoption is surging: Color-coded lead tagging, Chatwoot sync, and zero-cost remarketing campaigns.
Frequently Asked Questions (FAQ)
Detailed answers about installation, operations, privacy, and account security.
What is Zalo-Flow and is it completely free?
Will my personal Zalo account get banned using this chatbot?
Does Zalo-Flow read or steal my passwords and private messages?
Does the bot stay active when my computer is shut down or sleeps?
Which AI models does Zalo-Flow support?
How can I install Zalo-Flow on macOS or Linux?
- Install Node.js ≥ 22.5.0 (recommended Node 22 LTS from
nodejs.orgor via Homebrew:brew install node@22). - Open Terminal and run:
git clone https://github.com/aizaloapp/zalo-flow.git && cd zalo-flow && npm install && npm run init && npm start - Open your browser at
http://localhost:3000and scan the Zalo QR code to start.
docker compose up -d.
Join Our Open Community & Discussions
Need onboarding assistance, want to share prompt templates, or propose new features? Connect with hundreds of community members today!
Engineering Transparency & E-E-A-T Verification: Zalo-Flow (v1.5.0) is continuously verified against 60 automated test suites running on Node.js 22.14 LTS and SQLite WAL mode. The complete codebase is publicly audited on GitHub under the MIT License with Commons Clause. Our official browser companion is reviewed and approved on the Google Chrome Web Store, and all user sessions are encrypted locally using AES-256-CBC with zero external telemetry.