@ardennguyen/zalo-agent-cli 2.5.1 → 2.5.4

package/README.md

@@ -28,7 +28,7 @@ Xây dựng trên [zca-js](https://github.com/RFS-ADRENO/zca-js).
 > clawhub install zalo-agent          # OpenClaw (từ ClawHub registry)
 > cp -r skill/ ~/.claude/skills/zalo-agent/   # Claude Code
 > ```
-> 16 nhóm lệnh · 190 lệnh · listen mode + webhook · 55+ ngân hàng VN · đa tài khoản + proxy
+> 17 nhóm lệnh · 212 lệnh · listen mode + webhook · 55+ ngân hàng VN · đa tài khoản + proxy
 > Xem [skill/SKILL.md](skill/SKILL.md) · [Tham chiếu lệnh đầy đủ](skill/references/command-reference.md) · [Eval scenarios](skill/evals/)
 
 > [!NOTE]
@@ -41,7 +41,7 @@ Xây dựng trên [zca-js](https://github.com/RFS-ADRENO/zca-js).
 > zalo-agent oa listen -p 3000                           # Webhook listener
 > ```
 > OAuth login · gửi tin nhắn · follower · tag · bài viết · cửa hàng · webhook listener · multi-OA · VPS support
-> Xem [docs/official-account.md](docs/official-account.md)
+> Xem [docs/official-account.vi.md](docs/official-account.vi.md) · [English](docs/official-account.md)
 
 > [!TIP]
 > **MCP Server (AI Agent Integration)** — Model Context Protocol cho Claude Code và các MCP client:
@@ -49,12 +49,14 @@ Xây dựng trên [zca-js](https://github.com/RFS-ADRENO/zca-js).
 > zalo-agent mcp start                                  # stdio (local Claude Code)
 > zalo-agent mcp start --account <ID>                   # Ghim tài khoản (chạy nhiều tài khoản live cùng lúc)
 > zalo-agent mcp start --http 3847 --auth your-secret   # HTTP (VPS)
+> zalo-agent mcp wait -c my-bot --timeout 55 --json     # Zero-polling chờ tin nhắn mới qua CLI
+> zalo-agent mcp mark-read <cursor> -c my-bot --json    # Đánh dấu đã đọc tới cursor qua CLI
 > ```
-> 23 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll` · `zalo_wait_for_message` · `zalo_label`
+> 25 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll` · `zalo_wait_for_message` · `zalo_label` · `zalo_friend` · `zalo_group`
 
-[Sync qua MCP](docs/mcp-sync.vi.md) · [Ghim đa tài khoản live](docs/account-pinning.vi.md).
+[Sync qua MCP](docs/mcp-sync.vi.md) · [Ghim đa tài khoản live](docs/account-pinning.vi.md) · [Triển khai Production](docs/deployment.vi.md).
 > Auto-reconnect · thread filter · noise reduction · tự tải media · thông báo qua nhóm Zalo · chạy song song nhiều tài khoản (`--account <ID>`)
-> Xem [MCP Guide](skill/references/mcp-guide.md) · [INSTALLATION.md](INSTALLATION.md)
+> Xem [MCP Guide](skill/references/mcp-guide.md) · [INSTALLATION.vi.md](INSTALLATION.vi.md)
 
 ---
 
@@ -66,7 +68,7 @@ Yêu cầu **Node.js 22+**.
 npm install -g @ardennguyen/zalo-agent-cli
 ```
 
-Muốn cài kèm MCP server dạng sandbox (khuyến nghị cho AI client) → xem [INSTALLATION.md](INSTALLATION.md).
+Muốn cài kèm MCP server dạng sandbox (khuyến nghị cho AI client) → xem [INSTALLATION.vi.md](INSTALLATION.vi.md) ([English](INSTALLATION.md)).
 
 ## Bắt đầu nhanh
 
@@ -111,20 +113,21 @@ Tất cả lệnh hỗ trợ `--json`. Tài liệu đầy đủ: **[Wiki](https:
 | Nhóm lệnh | Số lệnh | Mô tả | Docs |
 |------------|:---:|--------|------|
 | *(top-level)* | 11 | `login`, `logout`, `status`, `whoami`, `update`, `sync`, `sync-mobile`, `sync-media`, `sync-reactions`, `sync-boards`, `sync-cloud` | [Đăng nhập & Đăng xuất](https://github.com/ardennguyen/zalo-agent-cli/wiki/%C4%90%C4%83ng-Nh%E1%BA%ADp-&-%C4%90%C4%83ng-Xu%E1%BA%A5t) |
-| `msg` | 20 | Gửi tin nhắn, hình, file, voice, video, sticker, link, thẻ chuyển khoản, QR, thu hồi, lịch sử | [Tin nhắn](https://github.com/ardennguyen/zalo-agent-cli/wiki/Tin-Nh%E1%BA%AFn) |
-| `friend` | 22 | Danh sách, tìm, thêm, xóa, chặn, biệt danh, gợi ý | [Bạn bè](https://github.com/ardennguyen/zalo-agent-cli/wiki/B%E1%BA%A1n-B%C3%A8) |
-| `group` | 33 | Tạo, đổi tên, thành viên, cài đặt, link, ghi chú, lời mời | [Nhóm & Cộng đồng](https://github.com/ardennguyen/zalo-agent-cli/wiki/Nh%C3%B3m) |
-| `conv` | 20 | Tắt thông báo, ghim, lưu trữ, ẩn hội thoại, tự xóa, xoá bộ nhớ đệm cục bộ (`forget`) | [Hội thoại](https://github.com/ardennguyen/zalo-agent-cli/wiki/H%E1%BB%99i-Tho%E1%BA%A1i) |
+| `msg` | 24 | Gửi tin nhắn, hình, file, voice, video, sticker, link, thẻ chuyển khoản, QR, thu hồi, lịch sử | [Tin nhắn](https://github.com/ardennguyen/zalo-agent-cli/wiki/Tin-Nh%E1%BA%AFn) |
+| `friend` | 26 | Danh sách, tìm, thêm, xóa, chặn, biệt danh, gợi ý | [Bạn bè](https://github.com/ardennguyen/zalo-agent-cli/wiki/B%E1%BA%A1n-B%C3%A8) |
+| `group` | 35 | Tạo, đổi tên, thành viên, cài đặt, link, ghi chú, lời mời | [Nhóm & Cộng đồng](https://github.com/ardennguyen/zalo-agent-cli/wiki/Nh%C3%B3m) |
+| `conv` | 21 | Tắt thông báo, ghim, lưu trữ, ẩn hội thoại, tự xóa, xoá bộ nhớ đệm cục bộ (`forget`) | [Hội thoại](https://github.com/ardennguyen/zalo-agent-cli/wiki/H%E1%BB%99i-Tho%E1%BA%A1i) |
 | `account` | 7 | Đa tài khoản & proxy, thiết bị đã liên kết, xóa tài khoản | [Tài khoản](https://github.com/ardennguyen/zalo-agent-cli/wiki/T%C3%A0i-Kho%E1%BA%A3n) |
-| `profile` | 11 | Xem/cập nhật hồ sơ, ảnh đại diện, quyền riêng tư | [Hồ sơ](https://github.com/ardennguyen/zalo-agent-cli/wiki/H%E1%BB%93-S%C6%A1) |
+| `profile` | 14 | Xem/cập nhật hồ sơ, ảnh đại diện, quyền riêng tư | [Hồ sơ](https://github.com/ardennguyen/zalo-agent-cli/wiki/H%E1%BB%93-S%C6%A1) |
 | `poll` | 7 | Tạo, bỏ phiếu, đóng khảo sát | [Khảo sát](https://github.com/ardennguyen/zalo-agent-cli/wiki/Kh%E1%BA%A3o-S%C3%A1t) |
 | `reminder` | 6 | Tạo, sửa, xóa nhắc nhở | [Nhắc nhở](https://github.com/ardennguyen/zalo-agent-cli/wiki/Nh%E1%BA%AFc-Nh%E1%BB%9F) |
 | `auto-reply` | 4 | Quản lý trả lời tự động | [Trả lời tự động](https://github.com/ardennguyen/zalo-agent-cli/wiki/Tr%E1%BA%A3-L%E1%BB%9Di-T%E1%BB%B1-%C4%90%E1%BB%99ng) |
 | `quick-msg` | 4 | Tin nhắn nhanh đã lưu | [Tin nhắn nhanh](https://github.com/ardennguyen/zalo-agent-cli/wiki/Tin-Nh%E1%BA%AFn-Nhanh) |
 | `label` | 2 | Nhãn hội thoại | [Nhãn](https://github.com/ardennguyen/zalo-agent-cli/wiki/Nh%C3%A3n) |
-| `catalog` | 9 | zBusiness — danh mục sản phẩm | [zBusiness](https://github.com/ardennguyen/zalo-agent-cli/wiki/zBusiness) |
+| `catalog` | 10 | zBusiness — danh mục sản phẩm | [zBusiness](https://github.com/ardennguyen/zalo-agent-cli/wiki/zBusiness) |
+| `bank` | 5 | Tài khoản ngân hàng đã lưu, danh sách ngân hàng được hỗ trợ | [Ngân hàng](https://github.com/ardennguyen/zalo-agent-cli/wiki/Ng%C3%A2n-H%C3%A0ng) |
 | `listen` | 1 | Lắng nghe real-time, webhook, JSONL, ghi vào cache cục bộ | [Lắng nghe](https://github.com/ardennguyen/zalo-agent-cli/wiki/L%E1%BA%AFng-Nghe) |
-| `mcp` | 1 | MCP server (stdio/HTTP/HTTPS) — 23 tools cho AI agent | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server-(VN)) |
+| `mcp` | 3 | MCP server (`start`, `wait`, `mark-read`) — 25 tools cho AI agent + zero-polling CLI | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server-(VN)) |
 | **`oa`** | **32** | **Zalo Official Account API v3.0 — OAuth, tin nhắn, follower, tag, bài viết, cửa hàng, webhook** | **[Official Account](https://github.com/ardennguyen/zalo-agent-cli/wiki/Official-Account-(VN))** |
 
 Xem thêm: [Đa tài khoản & Proxy](https://github.com/ardennguyen/zalo-agent-cli/wiki/%C4%90a-T%C3%A0i-Kho%E1%BA%A3n-&-Proxy) · [Cài đặt VPS](https://github.com/ardennguyen/zalo-agent-cli/wiki/C%C3%A0i-%C4%90%E1%BA%B7t-VPS) · [Thẻ chuyển khoản & QR](https://github.com/ardennguyen/zalo-agent-cli/wiki/Th%E1%BA%BB-Chuy%E1%BB%83n-Kho%E1%BA%A3n-&-QR) · [Bộ nhớ đệm & Đồng bộ](https://github.com/ardennguyen/zalo-agent-cli/wiki/B%E1%BB%99-Nh%E1%BB%9B-%C4%90%E1%BB%87m-&-%C4%90%E1%BB%93ng-B%E1%BB%99) · [Bảo mật](https://github.com/ardennguyen/zalo-agent-cli/wiki/B%E1%BA%A3o-M%E1%BA%ADt)
@@ -135,9 +138,9 @@ Xem thêm: [Đa tài khoản & Proxy](https://github.com/ardennguyen/zalo-agent-
 
 - Đăng nhập QR qua HTTP server tự động (browser + terminal), báo ngay khi bị **từ chối trên điện thoại** thay vì treo tới hết 60s
 - Đa tài khoản với proxy riêng biệt (1:1), device fingerprint riêng cho từng tài khoản; chạy **nhiều tài khoản live đồng thời** (mỗi tài khoản một tiến trình `mcp start` hoặc `listen` kèm `--account <ID>`, và truyền `--account <ID>` / `ZALO_ACCOUNT` trên mọi lệnh CLI mà không ghi đè `accounts.json`)
-- **190 lệnh** phủ hết tính năng Zalo cá nhân
+- **212 lệnh** phủ hết tính năng Zalo cá nhân
 - **Zalo Official Account (OA) API v3.0** — OAuth login, gửi tin nhắn, follower, tag, bài viết, cửa hàng, webhook listener, multi-OA
-- **MCP server** (stdio + HTTP/HTTPS + OAuth 2.0) — 23 tools cho Claude Code, Gemini và các MCP client: đọc, chờ tin nhắn đến (`zalo_wait_for_message`), gửi (văn bản, link preview, danh thiếp, vào My Documents, đánh dấu Quan trọng/Khẩn cấp), tìm kiếm tin nhắn trong cache, tra cứu người dùng, gắn/gỡ nhãn hội thoại (`zalo_label`), thả cảm xúc, thu hồi, chuyển tiếp, xóa tin, nhắc hẹn, ghi chú/ghim tin, bình chọn, xem thành viên nhóm, liệt kê hội thoại gần đây và kiểm tra độ đầy đủ của cache
+- **MCP server** (stdio + HTTP/HTTPS + OAuth 2.0) — 25 tools cho Claude Code, Gemini và các MCP client: đọc, chờ tin nhắn đến (`zalo_wait_for_message`), gửi (văn bản, link preview, danh thiếp, vào My Documents, đánh dấu Quan trọng/Khẩn cấp), tìm kiếm tin nhắn trong cache, tra cứu người dùng, gắn/gỡ nhãn hội thoại (`zalo_label`), xem bạn bè và xử lý lời mời kết bạn (`zalo_friend`), xem thông tin nhóm, tạo nhóm, thêm/xóa thành viên và rời nhóm (`zalo_group`), thả cảm xúc, thu hồi, chuyển tiếp, xóa tin, nhắc hẹn, ghi chú/ghim tin, bình chọn, xem thành viên nhóm, liệt kê hội thoại gần đây và kiểm tra độ đầy đủ của cache
 - **Bộ nhớ đệm cục bộ (SQLite)** — `listen` ghi mọi tin nhắn vào `zalo.db`, `msg history` đọc từ cache, `sync` (hoặc `sync-mobile`) khôi phục toàn bộ lịch sử từ điện thoại vào `zalo.db` (giải mã transfer-sync-v2; xác nhận một lần trên điện thoại), mặc định lấy **toàn bộ** lịch sử (không còn mốc chặn 2024-01-01); thêm `--days <n>` hoặc `--from <YYYY-MM-DD>` nếu chỉ cần một khoảng. Dọn dẹp: `sync-media --prune <days|all>` giải phóng dung lượng nhưng giữ nguyên nội dung tin nhắn, `--prune-orphans` nhắm vào hội thoại tài khoản không còn, và `conv forget` xoá hẳn bản sao cục bộ của một hội thoại — không cái nào gửi gì tới Zalo. Luồng đồng bộ chỉ mang **liên kết** media chứ không mang file, nên sau khi lưu tin nhắn, `sync-mobile` **tự động tải media về** (thêm `--messages-only` nếu chỉ muốn tin nhắn); `sync-media` chạy lại/tiếp tục bước tải này, không cần xác nhận trên điện thoại. Ghi chú, tin ghim, bình chọn và nhắc hẹn nằm ngoài luồng tin nhắn — dùng `sync-boards`
 - Tự động tải media (ảnh/audio/video) — một downloader duy nhất cho `listen`, `msg history`, `mcp start` và các lệnh sync, lưu vào `~/.zalo-agent-cli/accounts/<id>/media/<threadId>/` (hoặc tách riêng credentials, database `zalo.db`, media và OA sang các ổ đĩa/mount khác nhau qua `--credentials-dir`, `--data-dir`, `--media-dir`, `--oa-dir` / biến môi trường `ZALO_*_DIR` trong `~/.zalo-agent-cli/.env`; nếu dùng kèm `zalo-mcp`, chỉ nên giữ cấu hình PORT trong `zalo-mcp/.env` và đặt toàn bộ đường dẫn lưu trữ vào `<CONFIG_DIR>/.env`)
 - Thẻ chuyển khoản (55+ ngân hàng VN) & QR VietQR
@@ -151,8 +154,9 @@ Xem thêm: [Đa tài khoản & Proxy](https://github.com/ardennguyen/zalo-agent-
 
 | Tài liệu | Nội dung |
 |----------|----------|
-| [INSTALLATION.md](INSTALLATION.md) | Cài đặt `zalo-mcp` wrapper, cấu hình MCP client, thiết lập OA |
-| [docs/official-account.md](docs/official-account.md) | Tham chiếu đầy đủ lệnh OA (tiếng Việt) |
+| [INSTALLATION.vi.md](INSTALLATION.vi.md) ([EN](INSTALLATION.md)) | Cài đặt `zalo-mcp` wrapper, cấu hình MCP client, thiết lập OA |
+| [docs/official-account.vi.md](docs/official-account.vi.md) ([EN](docs/official-account.md)) | Tham chiếu đầy đủ lệnh OA (song ngữ VN / EN) |
+| [docs/deployment.vi.md](docs/deployment.vi.md) ([EN](docs/deployment.md)) | Hướng dẫn triển khai production (một socket, nhiều bot, HTTPS, OAuth 2.0, systemd/Docker) |
 | [skill/SKILL.md](skill/SKILL.md) | Skill cho AI agent |
 | [skill/references/command-reference.md](skill/references/command-reference.md) | Tham chiếu lệnh đầy đủ (nguồn chuẩn) |
 | [skill/references/mcp-guide.md](skill/references/mcp-guide.md) | Hướng dẫn MCP server (tiếng Việt) |
@@ -193,7 +197,7 @@ CLI tool for Zalo automation — multi-account, proxy support, bank transfers, Q
 > clawhub install zalo-agent                    # OpenClaw (from ClawHub registry)
 > cp -r skill/ ~/.claude/skills/zalo-agent/     # Claude Code
 > ```
-> 16 command groups · 190 commands · listen mode + webhook · 55+ VN banks · multi-account + proxy
+> 17 command groups · 212 commands · listen mode + webhook · 55+ VN banks · multi-account + proxy
 > See [skill/SKILL.md](skill/SKILL.md) · [Full command reference](skill/references/command-reference.md) · [Eval scenarios](skill/evals/)
 
 > [!NOTE]
@@ -206,7 +210,7 @@ CLI tool for Zalo automation — multi-account, proxy support, bank transfers, Q
 > zalo-agent oa listen -p 3000                           # Webhook listener
 > ```
 > OAuth login · messaging · followers · tags · articles · store · webhook listener · multi-OA · VPS support
-> See [docs/official-account.md](docs/official-account.md)
+> See [docs/official-account.md](docs/official-account.md) · [Tiếng Việt](docs/official-account.vi.md)
 
 > [!TIP]
 > **MCP Server (AI Agent Integration)** — Model Context Protocol support for Claude Code and MCP clients:
@@ -214,10 +218,12 @@ CLI tool for Zalo automation — multi-account, proxy support, bank transfers, Q
 > zalo-agent mcp start                                  # stdio (local Claude Code)
 > zalo-agent mcp start --account <ID>                   # Pin account (run multiple live accounts at once)
 > zalo-agent mcp start --http 3847 --auth your-secret   # HTTP (VPS)
+> zalo-agent mcp wait -c my-bot --timeout 55 --json     # Zero-polling wait for next message via CLI
+> zalo-agent mcp mark-read <cursor> -c my-bot --json    # Advance consumer read cursor via CLI
 > ```
-> 23 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll` · `zalo_wait_for_message` · `zalo_label`
+> 25 tools: `zalo_get_messages` · `zalo_send_message` · `zalo_list_threads` · `zalo_search_threads` · `zalo_mark_read` · `zalo_get_history` · `zalo_view_media` · `zalo_react` · `zalo_undo` · `zalo_get_group_members` · `zalo_list_conversations` · `zalo_coverage` · `zalo_sync` · `zalo_sync_status` · `zalo_search_messages` · `zalo_lookup_user` · `zalo_forward_message` · `zalo_delete_message` · `zalo_reminder` · `zalo_note` · `zalo_poll` · `zalo_wait_for_message` · `zalo_label` · `zalo_friend` · `zalo_group`
 
-[MCP sync](docs/mcp-sync.md) · [Multi-account pinning](docs/account-pinning.md).
+[MCP sync](docs/mcp-sync.md) · [Multi-account pinning](docs/account-pinning.md) · [Production deployment](docs/deployment.md).
 > Auto-reconnect · thread filter · noise reduction · media auto-download · Zalo-group notifications · concurrent multi-account (`--account <ID>`)
 > See [MCP Guide](skill/references/mcp-guide.md) · [INSTALLATION.md](INSTALLATION.md)
 
@@ -233,7 +239,7 @@ zalo-agent listen                          # 3. Listen for threadId
 zalo-agent msg send <THREAD_ID> "Hello!"   # 4. Send a message
 ```
 
-For the sandboxed MCP-server install (recommended for AI clients), see [INSTALLATION.md](INSTALLATION.md).
+For the sandboxed MCP-server install (recommended for AI clients), see [INSTALLATION.md](INSTALLATION.md) ([Tiếng Việt](INSTALLATION.vi.md)).
 
 ### Commands
 
@@ -242,20 +248,21 @@ Full docs: **[Wiki](https://github.com/ardennguyen/zalo-agent-cli/wiki)** · [Fu
 | Group | Commands | Description | Docs |
 |-------|:---:|-------------|------|
 | *(top-level)* | 11 | `login`, `logout`, `status`, `whoami`, `update`, `sync`, `sync-mobile`, `sync-media`, `sync-reactions`, `sync-boards`, `sync-cloud` | [Login & Logout](https://github.com/ardennguyen/zalo-agent-cli/wiki/Login-&-Logout) |
-| `msg` | 20 | Text, images, files, voice, video, stickers, links, bank cards, QR, recall, history | [Messages](https://github.com/ardennguyen/zalo-agent-cli/wiki/Messages) |
-| `friend` | 22 | List, find, add, remove, block, alias, recommendations | [Friends](https://github.com/ardennguyen/zalo-agent-cli/wiki/Friends) |
-| `group` | 33 | Create, rename, members, settings, links, notes, invites | [Groups](https://github.com/ardennguyen/zalo-agent-cli/wiki/Groups) |
-| `conv` | 20 | Mute, pin, archive, hidden, auto-delete, forget local cache | [Conversations](https://github.com/ardennguyen/zalo-agent-cli/wiki/Conversations) |
+| `msg` | 24 | Text, images, files, voice, video, stickers, links, bank cards, QR, recall, history | [Messages](https://github.com/ardennguyen/zalo-agent-cli/wiki/Messages) |
+| `friend` | 26 | List, find, add, remove, block, alias, recommendations | [Friends](https://github.com/ardennguyen/zalo-agent-cli/wiki/Friends) |
+| `group` | 35 | Create, rename, members, settings, links, notes, invites | [Groups](https://github.com/ardennguyen/zalo-agent-cli/wiki/Groups) |
+| `conv` | 21 | Mute, pin, archive, hidden, auto-delete, forget local cache | [Conversations](https://github.com/ardennguyen/zalo-agent-cli/wiki/Conversations) |
 | `account` | 7 | Multi-account & proxy, linked devices, account removal | [Accounts](https://github.com/ardennguyen/zalo-agent-cli/wiki/Accounts) |
-| `profile` | 11 | Profile, avatar gallery, privacy | [Profile](https://github.com/ardennguyen/zalo-agent-cli/wiki/Profile) |
+| `profile` | 14 | Profile, avatar gallery, privacy | [Profile](https://github.com/ardennguyen/zalo-agent-cli/wiki/Profile) |
 | `poll` | 7 | Create, vote, lock polls | [Polls](https://github.com/ardennguyen/zalo-agent-cli/wiki/Polls) |
 | `reminder` | 6 | Create, edit, remove reminders | [Reminders](https://github.com/ardennguyen/zalo-agent-cli/wiki/Reminders) |
 | `auto-reply` | 4 | Auto-reply rules | [Auto-Reply](https://github.com/ardennguyen/zalo-agent-cli/wiki/Auto-Reply) |
 | `quick-msg` | 4 | Saved quick messages | [Quick Messages](https://github.com/ardennguyen/zalo-agent-cli/wiki/Quick-Messages) |
 | `label` | 2 | Conversation labels | [Labels](https://github.com/ardennguyen/zalo-agent-cli/wiki/Labels) |
-| `catalog` | 9 | zBusiness catalogs & products | [Catalog](https://github.com/ardennguyen/zalo-agent-cli/wiki/Catalog) |
+| `catalog` | 10 | zBusiness catalogs & products | [Catalog](https://github.com/ardennguyen/zalo-agent-cli/wiki/Catalog) |
+| `bank` | 5 | Saved bank accounts, supported banks | [Bank](https://github.com/ardennguyen/zalo-agent-cli/wiki/Bank) |
 | `listen` | 1 | Real-time listener, webhook, JSONL, local cache writes | [Listener](https://github.com/ardennguyen/zalo-agent-cli/wiki/Listener) |
-| `mcp` | 1 | MCP server (stdio/HTTP/HTTPS) — 23 tools for AI agents | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server) |
+| `mcp` | 3 | MCP server (`start`, `wait`, `mark-read`) — 25 tools for AI agents + zero-polling CLI | [MCP Server](https://github.com/ardennguyen/zalo-agent-cli/wiki/MCP-Server) |
 | **`oa`** | **32** | **Zalo Official Account API v3.0 — OAuth, messaging, followers, tags, articles, store, webhook** | **[Official Account](https://github.com/ardennguyen/zalo-agent-cli/wiki/Official-Account)** |
 
 See also: [Multi-Account & Proxy](https://github.com/ardennguyen/zalo-agent-cli/wiki/Multi-Account-&-Proxy) · [VPS Setup](https://github.com/ardennguyen/zalo-agent-cli/wiki/VPS-Setup) · [Bank Card & QR Payments](https://github.com/ardennguyen/zalo-agent-cli/wiki/Bank-Card-&-QR-Payments) · [Local Cache & Sync](https://github.com/ardennguyen/zalo-agent-cli/wiki/Local-Cache-&-Sync) · [Security](https://github.com/ardennguyen/zalo-agent-cli/wiki/Security)
@@ -264,9 +271,9 @@ See also: [Multi-Account & Proxy](https://github.com/ardennguyen/zalo-agent-cli/
 
 - QR login over an auto-started HTTP server (browser + terminal), reporting a **decline on the phone** immediately instead of hanging until the 60s timeout
 - Multi-account with a dedicated proxy (1:1) and a per-account device fingerprint; run **multiple live accounts simultaneously** (one `mcp start` or `listen` process per account with `--account <ID>`, plus `--account <ID>` / `ZALO_ACCOUNT` on any CLI command without mutating `accounts.json`)
-- **190 commands** covering the personal-account Zalo surface
+- **212 commands** covering the personal-account Zalo surface
 - **Zalo Official Account (OA) API v3.0** — OAuth login, messaging, followers, tags, articles, store, webhook listener, multi-OA
-- **MCP server** (stdio + HTTP/HTTPS + OAuth 2.0) — 23 tools for Claude Code, Gemini and other MCP clients: read, wait for incoming messages (`zalo_wait_for_message`), send (text, link previews, contact cards, to My Documents too, marked Important/Urgent), search cached messages, look up users, manage conversation labels (`zalo_label`), react, recall, forward, delete, reminders, group notes/pins, group polls, list a group's members, list recent conversations, and check how complete the cache is
+- **MCP server** (stdio + HTTP/HTTPS + OAuth 2.0) — 25 tools for Claude Code, Gemini and other MCP clients: read, wait for incoming messages (`zalo_wait_for_message`), send (text, local file/image attachments, link previews, contact cards, to My Documents too, marked Important/Urgent), search cached messages, look up users, manage conversation labels (`zalo_label`), list friends and handle friend requests (`zalo_friend`), inspect, create and manage groups and leave them (`zalo_group`), react, recall, forward, delete, reminders, group notes/pins, group polls, list a group's members, list recent conversations, and check how complete the cache is
 - **Local SQLite cache** — `listen` writes every message to `zalo.db`, `msg history` reads from it, and `sync` (or `sync-mobile`) restores full history from the phone into `zalo.db` (transfer-sync-v2 decrypt; one confirmation on the phone), defaulting to **all** history (the old 2024-01-01 floor is gone), with `--days <n>` or `--from <YYYY-MM-DD>` to narrow it. Housekeeping: `sync-media --prune <days|all>` reclaims disk while keeping message text, `--prune-orphans` targets conversations the account no longer has, and `conv forget` removes a conversation's local copy entirely — none of which contact Zalo. The sync stream carries media **links**, not files, so a `sync-mobile` run **downloads its attachments automatically** once the messages are stored (`--messages-only` skips it); `sync-media` re-runs or resumes that fetch on its own, with no phone confirmation. Notes, pinned messages, polls and reminders live outside the message stream — `sync-boards` fetches those
 - Automatic media download — one downloader shared by `listen`, `msg history`, `mcp start` and the sync commands, saving to `~/.zalo-agent-cli/accounts/<id>/media/<threadId>/` (or separate credentials, `zalo.db`, media, and OA credentials onto independent volumes/mounts via `--credentials-dir`, `--data-dir`, `--media-dir`, `--oa-dir` / `ZALO_*_DIR` in `~/.zalo-agent-cli/.env`; when using `zalo-mcp`, keep `zalo-mcp/.env` for PORT settings only and place all storage/engine settings in `<CONFIG_DIR>/.env`)
 - Bank cards (55+ VN banks) and VietQR payment images
@@ -280,8 +287,9 @@ See also: [Multi-Account & Proxy](https://github.com/ardennguyen/zalo-agent-cli/
 
 | Document | Contents |
 |----------|----------|
-| [INSTALLATION.md](INSTALLATION.md) | `zalo-mcp` wrapper install, MCP client config, OA setup |
-| [docs/official-account.md](docs/official-account.md) | Full OA command reference (Vietnamese) |
+| [INSTALLATION.md](INSTALLATION.md) ([VI](INSTALLATION.vi.md)) | `zalo-mcp` wrapper install, MCP client config, OA setup |
+| [docs/official-account.md](docs/official-account.md) ([VI](docs/official-account.vi.md)) | Full OA command reference (bilingual EN / VN) |
+| [docs/deployment.md](docs/deployment.md) ([VI](docs/deployment.vi.md)) | Production deployment guide (one socket, many bots, HTTPS, OAuth 2.0, systemd/Docker) |
 | [skill/SKILL.md](skill/SKILL.md) | AI agent skill |
 | [skill/references/command-reference.md](skill/references/command-reference.md) | Exhaustive command reference (source of truth) |
 | [skill/references/mcp-guide.md](skill/references/mcp-guide.md) | MCP server guide (Vietnamese) |

package/node_modules/zca-js/dist/apis.js

@@ -154,10 +154,6 @@ import { uploadAttachmentFactory } from "./apis/uploadAttachment.js";
 import { uploadProductPhotoFactory } from "./apis/uploadProductPhoto.js";
 import { votePollFactory } from "./apis/votePoll.js";
 import { customFactory } from "./apis/custom.js";
-import { requestSyncMessageFactory } from "./apis/requestSyncMessage.js";
-import { pullMobileMsgFactory } from "./apis/pullMobileMsg.js";
-import { getCrossDBFactory } from "./apis/getCrossDB.js";
-import { deleteSnapshotMobileMsgFactory } from "./apis/deleteSnapshotMobileMsg.js";
 import { logoutV2Factory } from "./apis/logoutV2.js";
 export class API {
     constructor(ctx, zpwServiceMap, wsUrls) {
@@ -318,10 +314,6 @@ export class API {
         this.uploadProductPhoto = uploadProductPhotoFactory(ctx, this);
         this.votePoll = votePollFactory(ctx, this);
         this.custom = customFactory(ctx, this);
-        this.requestSyncMessage = requestSyncMessageFactory(ctx, this);
-        this.pullMobileMsg = pullMobileMsgFactory(ctx, this);
-        this.getCrossDB = getCrossDBFactory(ctx, this);
-        this.deleteSnapshotMobileMsg = deleteSnapshotMobileMsgFactory(ctx, this);
         this.logoutV2 = logoutV2Factory(ctx, this);
     }
 }

package/node_modules/zca-js/dist/cjs/apis.cjs

@@ -156,10 +156,6 @@ var uploadAttachment = require('./apis/uploadAttachment.cjs');
 var uploadProductPhoto = require('./apis/uploadProductPhoto.cjs');
 var votePoll = require('./apis/votePoll.cjs');
 var custom = require('./apis/custom.cjs');
-var requestSyncMessage = require('./apis/requestSyncMessage.cjs');
-var pullMobileMsg = require('./apis/pullMobileMsg.cjs');
-var getCrossDB = require('./apis/getCrossDB.cjs');
-var deleteSnapshotMobileMsg = require('./apis/deleteSnapshotMobileMsg.cjs');
 var logoutV2 = require('./apis/logoutV2.cjs');
 
 class API {
@@ -321,10 +317,6 @@ class API {
         this.uploadProductPhoto = uploadProductPhoto.uploadProductPhotoFactory(ctx, this);
         this.votePoll = votePoll.votePollFactory(ctx, this);
         this.custom = custom.customFactory(ctx, this);
-        this.requestSyncMessage = requestSyncMessage.requestSyncMessageFactory(ctx, this);
-        this.pullMobileMsg = pullMobileMsg.pullMobileMsgFactory(ctx, this);
-        this.getCrossDB = getCrossDB.getCrossDBFactory(ctx, this);
-        this.deleteSnapshotMobileMsg = deleteSnapshotMobileMsg.deleteSnapshotMobileMsgFactory(ctx, this);
         this.logoutV2 = logoutV2.logoutV2Factory(ctx, this);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ardennguyen/zalo-agent-cli",
-    "version": "2.5.1",
+    "version": "2.5.4",
     "description": "CLI tool for Zalo automation — multi-account, proxy, bank transfers, QR payments, Official Account API v3.0",
     "type": "module",
     "bin": {
@@ -55,7 +55,7 @@
         "node": ">=22"
     },
     "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.29.0",
+        "@modelcontextprotocol/sdk": "^1.32.1",
         "better-sqlite3": "^13.0.3",
         "chalk": "^5.6.2",
         "commander": "^15.0.0",
@@ -77,6 +77,6 @@
     },
     "allowScripts": {
         "better-sqlite3@13.0.3": true,
-        "@ardennguyen/zalo-agent-cli@2.2.2": true
+        "@ardennguyen/zalo-agent-cli@2.5.4": true
     }
 }

package/patches/zca-js+2.2.0.patch

@@ -2,53 +2,21 @@ diff --git a/node_modules/zca-js/dist/apis.js b/node_modules/zca-js/dist/apis.js
 index c8b38fb..ebcf8f9 100644
 --- a/node_modules/zca-js/dist/apis.js
 +++ b/node_modules/zca-js/dist/apis.js
-@@ -154,6 +154,11 @@ import { uploadAttachmentFactory } from "./apis/uploadAttachment.js";
+@@ -154,6 +154,7 @@ import { uploadAttachmentFactory } from "./apis/uploadAttachment.js";
  import { uploadProductPhotoFactory } from "./apis/uploadProductPhoto.js";
  import { votePollFactory } from "./apis/votePoll.js";
  import { customFactory } from "./apis/custom.js";
-+import { requestSyncMessageFactory } from "./apis/requestSyncMessage.js";
-+import { pullMobileMsgFactory } from "./apis/pullMobileMsg.js";
-+import { getCrossDBFactory } from "./apis/getCrossDB.js";
-+import { deleteSnapshotMobileMsgFactory } from "./apis/deleteSnapshotMobileMsg.js";
 +import { logoutV2Factory } from "./apis/logoutV2.js";
  export class API {
      constructor(ctx, zpwServiceMap, wsUrls) {
          this.zpwServiceMap = zpwServiceMap;
-@@ -313,5 +318,10 @@ export class API {
+@@ -313,5 +314,6 @@ export class API {
          this.uploadProductPhoto = uploadProductPhotoFactory(ctx, this);
          this.votePoll = votePollFactory(ctx, this);
          this.custom = customFactory(ctx, this);
-+        this.requestSyncMessage = requestSyncMessageFactory(ctx, this);
-+        this.pullMobileMsg = pullMobileMsgFactory(ctx, this);
-+        this.getCrossDB = getCrossDBFactory(ctx, this);
-+        this.deleteSnapshotMobileMsg = deleteSnapshotMobileMsgFactory(ctx, this);
 +        this.logoutV2 = logoutV2Factory(ctx, this);
      }
  }
-diff --git a/node_modules/zca-js/dist/apis/deleteSnapshotMobileMsg.js b/node_modules/zca-js/dist/apis/deleteSnapshotMobileMsg.js
-new file mode 100644
-index 0000000..ec513e6
---- /dev/null
-+++ b/node_modules/zca-js/dist/apis/deleteSnapshotMobileMsg.js
-@@ -0,0 +1,18 @@
-+import { ZaloApiError } from "../Errors/ZaloApiError.js";
-+import { apiFactory } from "../utils.js";
-+
-+export const deleteSnapshotMobileMsgFactory = apiFactory()((api, ctx, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/delete_snapshot_mobile_msg`);
-+    return async function deleteSnapshotMobileMsg(publicKey) {
-+        const params = {
-+            public_key: publicKey,
-+            imei: ctx.imei
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
 diff --git a/node_modules/zca-js/dist/apis/forwardMessage.js b/node_modules/zca-js/dist/apis/forwardMessage.js
 index ff4f6c6..499fbcf 100644
 --- a/node_modules/zca-js/dist/apis/forwardMessage.js
@@ -83,30 +51,6 @@ index ff4f6c6..499fbcf 100644
 +        return resolved;
      };
  });
-diff --git a/node_modules/zca-js/dist/apis/getCrossDB.js b/node_modules/zca-js/dist/apis/getCrossDB.js
-new file mode 100644
-index 0000000..3bf97b9
---- /dev/null
-+++ b/node_modules/zca-js/dist/apis/getCrossDB.js
-@@ -0,0 +1,18 @@
-+import { ZaloApiError } from "../Errors/ZaloApiError.js";
-+import { apiFactory } from "../utils.js";
-+
-+export const getCrossDBFactory = apiFactory()((api, _, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/get_crossdb`);
-+    return async function getCrossDB(syncSession) {
-+        const params = {
-+            pc_name: "Web",
-+            sync_session: syncSession
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
 diff --git a/node_modules/zca-js/dist/apis/loginQR.js b/node_modules/zca-js/dist/apis/loginQR.js
 index 7405811..309c23c 100644
 --- a/node_modules/zca-js/dist/apis/loginQR.js
@@ -493,58 +437,6 @@ index 0000000..e250100
 +        return await utils.resolve(response, undefined, false);
 +    };
 +});
-diff --git a/node_modules/zca-js/dist/apis/pullMobileMsg.js b/node_modules/zca-js/dist/apis/pullMobileMsg.js
-new file mode 100644
-index 0000000..ef850ea
---- /dev/null
-+++ b/node_modules/zca-js/dist/apis/pullMobileMsg.js
-@@ -0,0 +1,22 @@
-+import { ZaloApiError } from "../Errors/ZaloApiError.js";
-+import { apiFactory } from "../utils.js";
-+
-+export const pullMobileMsgFactory = apiFactory()((api, _, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/pull_mobile_msg`);
-+    return async function pullMobileMsg(publicKey, fromSeqId = 0, isRetry = 0, tempKey = "") {
-+        const params = {
-+            pc_name: "Web",
-+            public_key: publicKey,
-+            from_seq_id: fromSeqId,
-+            is_retry: isRetry,
-+            min_seq_id: 0,
-+            temp_key: tempKey
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
-diff --git a/node_modules/zca-js/dist/apis/requestSyncMessage.js b/node_modules/zca-js/dist/apis/requestSyncMessage.js
-new file mode 100644
-index 0000000..d459340
---- /dev/null
-+++ b/node_modules/zca-js/dist/apis/requestSyncMessage.js
-@@ -0,0 +1,18 @@
-+import { ZaloApiError } from "../Errors/ZaloApiError.js";
-+import { apiFactory } from "../utils.js";
-+
-+export const requestSyncMessageFactory = apiFactory()((api, _, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/transfer-sync-v2/request-sync`);
-+    return async function requestSyncMessage(reqId, data) {
-+        const params = {
-+            reqId: String(reqId),
-+            data: JSON.stringify(data)
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
 diff --git a/node_modules/zca-js/dist/apis/sendBankCard.js b/node_modules/zca-js/dist/apis/sendBankCard.js
 index f1fbae0..5841159 100644
 --- a/node_modules/zca-js/dist/apis/sendBankCard.js
@@ -928,58 +820,22 @@ diff --git a/node_modules/zca-js/dist/cjs/apis.cjs b/node_modules/zca-js/dist/cj
 index c151de0..e49f3d6 100644
 --- a/node_modules/zca-js/dist/cjs/apis.cjs
 +++ b/node_modules/zca-js/dist/cjs/apis.cjs
-@@ -156,6 +156,11 @@ var uploadAttachment = require('./apis/uploadAttachment.cjs');
+@@ -156,6 +156,7 @@ var uploadAttachment = require('./apis/uploadAttachment.cjs');
  var uploadProductPhoto = require('./apis/uploadProductPhoto.cjs');
  var votePoll = require('./apis/votePoll.cjs');
  var custom = require('./apis/custom.cjs');
-+var requestSyncMessage = require('./apis/requestSyncMessage.cjs');
-+var pullMobileMsg = require('./apis/pullMobileMsg.cjs');
-+var getCrossDB = require('./apis/getCrossDB.cjs');
-+var deleteSnapshotMobileMsg = require('./apis/deleteSnapshotMobileMsg.cjs');
 +var logoutV2 = require('./apis/logoutV2.cjs');
  
  class API {
      constructor(ctx, zpwServiceMap, wsUrls) {
-@@ -316,6 +321,11 @@ class API {
+@@ -316,6 +317,7 @@ class API {
          this.uploadProductPhoto = uploadProductPhoto.uploadProductPhotoFactory(ctx, this);
          this.votePoll = votePoll.votePollFactory(ctx, this);
          this.custom = custom.customFactory(ctx, this);
-+        this.requestSyncMessage = requestSyncMessage.requestSyncMessageFactory(ctx, this);
-+        this.pullMobileMsg = pullMobileMsg.pullMobileMsgFactory(ctx, this);
-+        this.getCrossDB = getCrossDB.getCrossDBFactory(ctx, this);
-+        this.deleteSnapshotMobileMsg = deleteSnapshotMobileMsg.deleteSnapshotMobileMsgFactory(ctx, this);
 +        this.logoutV2 = logoutV2.logoutV2Factory(ctx, this);
      }
  }
  
-diff --git a/node_modules/zca-js/dist/cjs/apis/deleteSnapshotMobileMsg.cjs b/node_modules/zca-js/dist/cjs/apis/deleteSnapshotMobileMsg.cjs
-new file mode 100644
-index 0000000..d5b3f5c
---- /dev/null
-+++ b/node_modules/zca-js/dist/cjs/apis/deleteSnapshotMobileMsg.cjs
-@@ -0,0 +1,22 @@
-+'use strict';
-+
-+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
-+var utils = require('../utils.cjs');
-+
-+const deleteSnapshotMobileMsgFactory = utils.apiFactory()((api, ctx, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/delete_snapshot_mobile_msg`);
-+    return async function deleteSnapshotMobileMsg(publicKey) {
-+        const params = {
-+            public_key: publicKey,
-+            imei: ctx.imei
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError.ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
-+
-+exports.deleteSnapshotMobileMsgFactory = deleteSnapshotMobileMsgFactory;
 diff --git a/node_modules/zca-js/dist/cjs/apis/forwardMessage.cjs b/node_modules/zca-js/dist/cjs/apis/forwardMessage.cjs
 index f9c670b..4dfa11c 100644
 --- a/node_modules/zca-js/dist/cjs/apis/forwardMessage.cjs
@@ -1016,34 +872,6 @@ index f9c670b..4dfa11c 100644
      };
  });
  
-diff --git a/node_modules/zca-js/dist/cjs/apis/getCrossDB.cjs b/node_modules/zca-js/dist/cjs/apis/getCrossDB.cjs
-new file mode 100644
-index 0000000..da5f16d
---- /dev/null
-+++ b/node_modules/zca-js/dist/cjs/apis/getCrossDB.cjs
-@@ -0,0 +1,22 @@
-+'use strict';
-+
-+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
-+var utils = require('../utils.cjs');
-+
-+const getCrossDBFactory = utils.apiFactory()((api, _, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/get_crossdb`);
-+    return async function getCrossDB(syncSession) {
-+        const params = {
-+            pc_name: "Web",
-+            sync_session: syncSession
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError.ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
-+
-+exports.getCrossDBFactory = getCrossDBFactory;
 diff --git a/node_modules/zca-js/dist/cjs/apis/loginQR.cjs b/node_modules/zca-js/dist/cjs/apis/loginQR.cjs
 index dbd08ed..8abfdab 100644
 --- a/node_modules/zca-js/dist/cjs/apis/loginQR.cjs
@@ -1246,66 +1074,6 @@ index 0000000..53cedb4
 +});
 +
 +exports.logoutV2Factory = logoutV2Factory;
-diff --git a/node_modules/zca-js/dist/cjs/apis/pullMobileMsg.cjs b/node_modules/zca-js/dist/cjs/apis/pullMobileMsg.cjs
-new file mode 100644
-index 0000000..579bc2e
---- /dev/null
-+++ b/node_modules/zca-js/dist/cjs/apis/pullMobileMsg.cjs
-@@ -0,0 +1,26 @@
-+'use strict';
-+
-+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
-+var utils = require('../utils.cjs');
-+
-+const pullMobileMsgFactory = utils.apiFactory()((api, _, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/message/pull_mobile_msg`);
-+    return async function pullMobileMsg(publicKey, fromSeqId = 0, isRetry = 0, tempKey = "") {
-+        const params = {
-+            pc_name: "Web",
-+            public_key: publicKey,
-+            from_seq_id: fromSeqId,
-+            is_retry: isRetry,
-+            min_seq_id: 0,
-+            temp_key: tempKey
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError.ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
-+
-+exports.pullMobileMsgFactory = pullMobileMsgFactory;
-diff --git a/node_modules/zca-js/dist/cjs/apis/requestSyncMessage.cjs b/node_modules/zca-js/dist/cjs/apis/requestSyncMessage.cjs
-new file mode 100644
-index 0000000..324995e
---- /dev/null
-+++ b/node_modules/zca-js/dist/cjs/apis/requestSyncMessage.cjs
-@@ -0,0 +1,22 @@
-+'use strict';
-+
-+var ZaloApiError = require('../Errors/ZaloApiError.cjs');
-+var utils = require('../utils.cjs');
-+
-+const requestSyncMessageFactory = utils.apiFactory()((api, _, utils) => {
-+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.file[0]}/api/transfer-sync-v2/request-sync`);
-+    return async function requestSyncMessage(reqId, data) {
-+        const params = {
-+            reqId: String(reqId),
-+            data: JSON.stringify(data)
-+        };
-+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
-+        if (!encryptedParams) throw new ZaloApiError.ZaloApiError("Failed to encrypt message");
-+        const response = await utils.request(`${serviceURL}&params=${encodeURIComponent(encryptedParams)}`, {
-+            method: "GET"
-+        });
-+        return utils.resolve(response);
-+    };
-+});
-+
-+exports.requestSyncMessageFactory = requestSyncMessageFactory;
 diff --git a/node_modules/zca-js/dist/cjs/apis/sendBankCard.cjs b/node_modules/zca-js/dist/cjs/apis/sendBankCard.cjs
 index a2ad818..3726a37 100644
 --- a/node_modules/zca-js/dist/cjs/apis/sendBankCard.cjs