Home

zalo-agent-cli Wiki

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.