# Zalo-Flow (AIzalo Community Edition)

> Open-source automation platform (MIT + Commons Clause) connecting personal Zalo accounts with Chatwoot CRM and AI models (Gemini, DeepSeek, OpenAI), supporting customer care automation on Windows and Docker.
> Nền tảng mã nguồn mở (giấy phép MIT + Commons Clause) kết nối Zalo cá nhân với Chatwoot CRM và các mô hình AI (Gemini, DeepSeek, OpenAI), hỗ trợ tự động hóa CSKH và quản lý hội thoại trên Windows và Docker.

## English Overview & Fast Facts
- **Project Name:** Zalo-Flow
- **Website (EN):** https://aizalo.com/en/
- **Website (VI):** https://aizalo.com/
- **Source Code Repository:** https://github.com/aizaloapp/zalo-flow
- **License:** MIT License with Commons Clause Condition v1.0 (100% Free for personal, research & non-commercial use).
- **Core Architecture:** Local-First Node.js with SQLite, AES-256-CBC local encryption, memory watchdog < 350MB.
- **Anti-Ban Protocol:** Token Bucket Rate Limiter (>= 3s pacing, max 20 msgs/min), Self-Echo Shield, Inbound Flood Detector.
- **Supported AI Providers:** Google Gemini (1.5 Flash, 2.5 Flash), DeepSeek (Chat, Reasoner), OpenAI (GPT-4o), Ollama.
- **CRM Integration:** Bidirectional adapter with Chatwoot CRM for multi-agent support.


## Thông Tin Cốt Lõi (Fast Facts)
- **Tên dự án:** Zalo-Flow
- **Trang chủ:** https://aizalo.com/
- **Kho mã nguồn:** https://github.com/aizaloapp/zalo-flow
- **Cộng đồng Zalo hỗ trợ:** https://zalo.me/g/mcihan713
- **Giấy phép:** MIT License with Commons Clause Condition v1.0 (Miễn phí 100% cho cá nhân, nghiên cứu, phi thương mại).
- **Môi trường chạy:** Windows 10/11 (1-Click Installer .exe), Linux/macOS qua Docker.
- **Tiêu thụ tài nguyên:** RAM < 100MB (Node.js trần 350MB, Docker 512MB).
- **Mã hóa:** AES-256-CBC lưu trữ cục bộ trong SQLite.

## Tính Năng Chính
1. **Khay Chờ Đính Kèm & Gộp Caption Ảnh:** Xem trước ảnh trên thanh staging, nhập nội dung văn bản và gửi đồng thời cả ảnh + chữ dính liền trong 1 tin nhắn duy nhất.
2. **Lên Lịch Hẹn Tin Nhắn 1-1:** Hẹn giờ gửi tin và tài liệu đính kèm cho từng khách hàng, thanh ghim đếm ngược thông minh và tự hủy an toàn khi khách trả lời.
3. **Mắt Thần Multimodal AI Vision:** Tự động đọc và phân tích hình ảnh (hóa đơn, biên lai, sản phẩm, tài liệu, ảnh chụp màn hình...) gửi qua Zalo, tư vấn thông minh theo đúng nhân cách thương hiệu.
4. **Universal Wiki URL Ingestion:** Nạp tài liệu Markdown trực tiếp từ URL bên ngoài (`aizalo.com/guide.md`) với Golden Template và SSRF Shield.
5. **Cơ Chế Anti-Ban 3 Lớp & Ground-Truth Group Reconciliation:**
   - Token Bucket Rate Limiter: Giãn cách tối thiểu 3 giây/tin, tối đa 20 tin/phút.
   - Self-Echo Shield: Bộ đệm 30s chống vòng lặp phản xạ bot tự nói chuyện với chính mình.
   - Flood Detector: Tự động ngắt tạm thời 60s khi bị dội tin dồn dập.
   - Ground-Truth Reconciliation: Đồng bộ phân loại nhóm chính xác 100% theo Zalo API.
6. **Web Dashboard Quản Trị & Tự Động Định Danh:** Giao diện Live Chat trực tiếp tại `localhost:3000`, phân loại khách hàng bằng thẻ tag màu sắc, tự động nhận diện tên và avatar thật của khách lạ.
7. **Chiến Dịch Remarketing & Spintax:** Gửi tin nhắn chăm sóc khách hàng định kỳ kèm hình ảnh/tài liệu và đảo ngẫu nhiên cú pháp.
8. **Mở Rộng Đội Ngũ:** Tích hợp 2 chiều với Chatwoot CRM khi cần nhiều nhân viên cùng trực 1 số Zalo.

## Hướng Dẫn Tải Về & Cài Đặt
- Tải gói cài đặt Windows: `https://github.com/aizaloapp/zalo-flow/releases/latest` (file `ZaloFlow-Setup-v1.2.0.exe`).
- Cài đặt qua dòng lệnh: `npx zalo-flow init`
- Lưu ý Windows SmartScreen: Khi xuất hiện màn hình "Windows protected your PC", bấm "More info" -> "Run anyway" (phần mềm cộng đồng chưa mua chứng chỉ thương mại Microsoft, sạch 0/70 trên VirusTotal).

## Cẩm Nang & Bài Viết Chuyên Sâu
- Cách huấn luyện AI bán hàng Zalo bằng bảng giá riêng: https://aizalo.com/blog/cach-huan-luyen-ai-ban-hang-zalo-bang-bang-gia-rieng.html
- Cách hẹn giờ gửi tin nhắn Zalo cá nhân tự động: https://aizalo.com/blog/cach-hen-gio-gui-tin-nhan-zalo-ca-nhan-tu-dong.html
- Bí quyết chống khóa nick Zalo: https://aizalo.com/blog/cach-gui-tin-nhan-tu-dong-tren-zalo-khong-bi-khoa.html
- Hướng dẫn cài đặt 3 phút: https://aizalo.com/blog/huong-dan-cach-tao-chatbot-zalo-ca-nhan.html
- Tích hợp Gemini & DeepSeek: https://aizalo.com/blog/tich-hop-ai-gemini-deepseek-vao-zalo-ca-nhan.html
- Giải pháp Zalo CRM 2026: https://aizalo.com/blog/zalo-crm-la-gi-giai-phap-quan-ly-tin-nhan-cskh.html

## Tài Liệu Toàn Văn & Tri Thức Bot AI
- Tri thức Mini Second Brain Wiki (Markdown): https://aizalo.com/guide.md
- Xem toàn văn chi tiết tại: https://aizalo.com/llms-full.txt