Zalo Agent CLI

Automate Zalo messaging, groups, contacts, payments, and real-time events via zalo-agent CLI.

Scope

Handles: login, messaging (text/image/file/sticker/voice/video/link), reactions, mentions, recall, friends, groups, polls, reminders, auto-reply, labels, catalogs, listen (WebSocket), webhooks, bank cards, VietQR, multi-account with proxy, Official Account (OA) API v3.0 (OAuth login, OA messaging, followers, tags, webhook listener, store, articles). Does NOT handle: Zalo Mini App, Zalo Ads, ZNS templates, non-Zalo platforms.

Prerequisites

• Requires: zalo-agent CLI pre-installed by user (zalo-agent --version to verify)
• See installation guide for setup
• Update: zalo-agent update

Core Workflow

1. Check status: zalo-agent status
2. If not logged in → follow Login flow (references/login-flow.md)
3. Execute command (Quick Reference below or references/command-reference.md)
4. Append --json for machine-readable output
5. For continuous monitoring → listen --webhook (references/listen-mode-guide.md)