Home

zalo-agent-cli

English version below

Công cụ CLI tự động hóa Zalo — đa tài khoản, proxy, chuyển khoản ngân hàng, thanh toán QR.

Bắt Đầu Nhanh

npm install -g zalo-agent-cli
zalo-agent login                           # 1. Đăng nhập qua QR
zalo-agent friend search "Tên"            # 2. Tìm bạn bè
zalo-agent listen                          # 3. Lắng nghe để lấy threadId
zalo-agent msg send <THREAD_ID> "Xin chào!"  # 4. Gửi tin nhắn

Danh Sách Lệnh

Nhóm	Số lệnh	Mô tả
Tin nhắn	16	Văn bản, hình ảnh, file, thoại, video, nhãn dán, link, thẻ chuyển khoản, QR
Bạn bè	22	Danh sách, tìm, thêm, xóa, chặn, biệt danh, gợi ý
Nhóm	27	Tạo, đổi tên, thành viên, cài đặt, link, ghi chú, lời mời
Hội thoại	15	Tắt thông báo, ghim, lưu trữ, ẩn, tự xóa
Hồ sơ	11	Xem/cập nhật hồ sơ, bộ sưu tập ảnh đại diện, quyền riêng tư
Khảo sát	7	Tạo, bỏ phiếu, đóng khảo sát
Nhắc nhở	6	Tạo, sửa, xóa nhắc nhở
Trả lời tự động	4	Quy tắc trả lời tự động
Tin nhắn nhanh	4	Tin nhắn nhanh đã lưu
Nhãn	2	Nhãn hội thoại
zBusiness	9	Danh mục sản phẩm & cửa hàng zBusiness
Lắng nghe	1	Lắng nghe real-time với webhook
Tài khoản	6	Đa tài khoản & proxy

Hướng Dẫn

• Đa tài khoản & Proxy
• Cài đặt VPS
• Thẻ chuyển khoản & QR
• Bảo mật

Flag toàn cục

Flag	Mô tả
--json	Xuất kết quả dạng JSON (máy đọc được)
-V, --version	Hiển thị phiên bản
-h, --help	Hiển thị trợ giúp

-t 0 = Cá nhân (mặc định), -t 1 = Nhóm — dùng cho tất cả lệnh liên quan đến thread.

---

English

CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments.

Quick Start

npm install -g zalo-agent-cli
zalo-agent login                           # 1. Login via QR
zalo-agent friend search "Name"            # 2. Find a friend
zalo-agent listen                          # 3. Listen for threadId
zalo-agent msg send <THREAD_ID> "Hello!"   # 4. Send a message

Command Reference

Group	Commands	Description
Messages	16	Text, images, files, voice, video, stickers, links, bank cards, QR
Friends	22	List, find, add, remove, block, alias, recommendations
Groups	27	Create, rename, members, settings, links, notes, invites
Conversations	15	Mute, pin, archive, hidden, auto-delete
Profile	11	View/update profile, avatar gallery, privacy
Polls	7	Create, vote, lock polls
Reminders	6	Create, edit, remove reminders
Auto-Reply	4	Auto-reply rules
Quick Messages	4	Saved quick messages
Labels	2	Conversation labels
Catalog	9	Zalo Shop catalogs & products
Listener	1	Real-time listener with webhook
Accounts	6	Multi-account & proxy

Guides

• Multi-Account & Proxy
• VPS / Headless Setup
• Bank Card & QR Payments
• Security

Global Flags

Flag	Description
--json	Output results as JSON (machine-readable)
-V, --version	Show version
-h, --help	Show help

-t 0 = User (default), -t 1 = Group — used across all thread-related commands.