zalo-agent-cli 1.0.30 → 1.1.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.30",
-  "description": "CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments",
+  "version": "1.1.0",
+  "description": "CLI tool for Zalo automation — multi-account, proxy, bank transfers, QR payments, Official Account API v3.0",
   "type": "module",
   "bin": {
     "zalo-agent": "src/index.js"
@@ -28,7 +28,10 @@
     "vietnam",
     "proxy",
     "vietqr",
-    "zca-js"
+    "zca-js",
+    "official-account",
+    "zalo-oa",
+    "webhook"
   ],
   "repository": {
     "type": "git",

package/src/commands/auto-reply.js

@@ -0,0 +1,83 @@
+/**
+ * Auto-reply commands — list, create, update, delete auto-reply messages.
+ */
+
+import { getApi } from "../core/zalo-client.js";
+import { success, error, output } from "../utils/output.js";
+
+export function registerAutoReplyCommands(program) {
+    const ar = program.command("auto-reply").description("Manage auto-reply messages");
+
+    ar.command("list")
+        .description("List all auto-reply rules")
+        .action(async () => {
+            try {
+                const result = await getApi().getAutoReplyList();
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Get auto-reply list failed: ${e.message}`);
+            }
+        });
+
+    ar.command("create <content>")
+        .description("Create an auto-reply rule")
+        .option("--enable", "Enable the rule (default: true)", true)
+        .option("--no-enable", "Create disabled")
+        .option("--start <ms>", "Start time (epoch ms)", parseInt, 0)
+        .option("--end <ms>", "End time (epoch ms)", parseInt, 0)
+        .option("--scope <n>", "Scope: 0=all, 1=friends, 2=strangers", parseInt, 0)
+        .option("--uids <ids...>", "Specific user IDs to auto-reply to")
+        .action(async (content, opts) => {
+            try {
+                const payload = {
+                    content,
+                    isEnable: opts.enable,
+                    startTime: opts.start,
+                    endTime: opts.end,
+                    scope: opts.scope,
+                };
+                if (opts.uids) payload.uids = opts.uids;
+                const result = await getApi().createAutoReply(payload);
+                output(result, program.opts().json, () => success("Auto-reply created"));
+            } catch (e) {
+                error(`Create auto-reply failed: ${e.message}`);
+            }
+        });
+
+    ar.command("update <id> <content>")
+        .description("Update an auto-reply rule")
+        .option("--enable", "Enable the rule")
+        .option("--no-enable", "Disable the rule")
+        .option("--start <ms>", "Start time (epoch ms)", parseInt, 0)
+        .option("--end <ms>", "End time (epoch ms)", parseInt, 0)
+        .option("--scope <n>", "Scope: 0=all, 1=friends, 2=strangers", parseInt, 0)
+        .option("--uids <ids...>", "Specific user IDs")
+        .action(async (id, content, opts) => {
+            try {
+                const payload = {
+                    id: Number(id),
+                    content,
+                    isEnable: opts.enable ?? true,
+                    startTime: opts.start,
+                    endTime: opts.end,
+                    scope: opts.scope,
+                };
+                if (opts.uids) payload.uids = opts.uids;
+                const result = await getApi().updateAutoReply(payload);
+                output(result, program.opts().json, () => success(`Auto-reply ${id} updated`));
+            } catch (e) {
+                error(`Update auto-reply failed: ${e.message}`);
+            }
+        });
+
+    ar.command("delete <id>")
+        .description("Delete an auto-reply rule")
+        .action(async (id) => {
+            try {
+                const result = await getApi().deleteAutoReply(Number(id));
+                output(result, program.opts().json, () => success(`Auto-reply ${id} deleted`));
+            } catch (e) {
+                error(`Delete auto-reply failed: ${e.message}`);
+            }
+        });
+}

package/src/commands/catalog.js

@@ -0,0 +1,143 @@
+/**
+ * Catalog commands — manage Zalo Shop catalogs and products.
+ */
+
+import { resolve } from "path";
+import { getApi } from "../core/zalo-client.js";
+import { success, error, info, output } from "../utils/output.js";
+
+export function registerCatalogCommands(program) {
+    const catalog = program.command("catalog").description("Manage Zalo Shop catalogs and products");
+
+    catalog
+        .command("list")
+        .description("List all catalogs")
+        .option("-l, --limit <n>", "Items per page", parseInt, 20)
+        .option("-p, --page <n>", "Page number", parseInt, 0)
+        .action(async (opts) => {
+            try {
+                const result = await getApi().getCatalogList({ limit: opts.limit, page: opts.page });
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Get catalogs failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("create <name>")
+        .description("Create a new catalog")
+        .action(async (name) => {
+            try {
+                const result = await getApi().createCatalog(name);
+                output(result, program.opts().json, () => success(`Catalog "${name}" created`));
+            } catch (e) {
+                error(`Create catalog failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("rename <catalogId> <name>")
+        .description("Rename a catalog")
+        .action(async (catalogId, name) => {
+            try {
+                const result = await getApi().updateCatalog({ catalogId, catalogName: name });
+                output(result, program.opts().json, () => success(`Catalog renamed to "${name}"`));
+            } catch (e) {
+                error(`Rename catalog failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("delete <catalogId>")
+        .description("Delete a catalog")
+        .action(async (catalogId) => {
+            try {
+                const result = await getApi().deleteCatalog(catalogId);
+                output(result, program.opts().json, () => success(`Catalog ${catalogId} deleted`));
+            } catch (e) {
+                error(`Delete catalog failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("products <catalogId>")
+        .description("List products in a catalog")
+        .option("-l, --limit <n>", "Items per page", parseInt, 100)
+        .option("-p, --page <n>", "Page number", parseInt, 0)
+        .action(async (catalogId, opts) => {
+            try {
+                const result = await getApi().getProductCatalogList({
+                    catalogId,
+                    limit: opts.limit,
+                    page: opts.page,
+                });
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Get products failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("add-product <catalogId> <name> <price> <description>")
+        .description("Add a product to a catalog")
+        .option("--photos <urls...>", "Product photo URLs (up to 5)")
+        .action(async (catalogId, name, price, description, opts) => {
+            try {
+                const payload = { catalogId, productName: name, price, description };
+                if (opts.photos) payload.product_photos = opts.photos;
+                const result = await getApi().createProductCatalog(payload);
+                output(result, program.opts().json, () => success(`Product "${name}" added to catalog`));
+            } catch (e) {
+                error(`Add product failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("update-product <catalogId> <productId> <name> <price> <description>")
+        .description("Update a product in a catalog")
+        .option("--photos <urls...>", "Product photo URLs (up to 5)")
+        .action(async (catalogId, productId, name, price, description, opts) => {
+            try {
+                const payload = {
+                    catalogId,
+                    productId,
+                    productName: name,
+                    price,
+                    description,
+                    createTime: Date.now(),
+                };
+                if (opts.photos) payload.product_photos = opts.photos;
+                const result = await getApi().updateProductCatalog(payload);
+                output(result, program.opts().json, () => success(`Product ${productId} updated`));
+            } catch (e) {
+                error(`Update product failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("delete-product <catalogId> <productIds...>")
+        .description("Delete product(s) from a catalog")
+        .action(async (catalogId, productIds) => {
+            try {
+                const result = await getApi().deleteProductCatalog({ catalogId, productIds });
+                output(result, program.opts().json, () => success(`Deleted ${productIds.length} product(s)`));
+            } catch (e) {
+                error(`Delete product failed: ${e.message}`);
+            }
+        });
+
+    catalog
+        .command("upload-photo <filePath>")
+        .description("Upload a product photo (returns URL for use with add-product --photos)")
+        .action(async (filePath) => {
+            try {
+                const absPath = resolve(filePath);
+                const result = await getApi().uploadProductPhoto({ file: absPath });
+                output(result, program.opts().json, () => {
+                    info("Photo uploaded. Use the URL with: catalog add-product --photos <url>");
+                });
+            } catch (e) {
+                error(`Upload photo failed: ${e.message}`);
+            }
+        });
+}

package/src/commands/conv.js

@@ -163,6 +163,92 @@ export function registerConvCommands(program) {
             }
         });
 
+    conv.command("hidden")
+        .description("List hidden conversations")
+        .action(async () => {
+            try {
+                const result = await getApi().getHiddenConversations();
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Get hidden conversations failed: ${e.message}`);
+            }
+        });
+
+    conv.command("hide <threadIds...>")
+        .description("Hide conversation(s)")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .action(async (threadIds, opts) => {
+            try {
+                const result = await getApi().setHiddenConversations(true, threadIds, Number(opts.type));
+                output(result, program.opts().json, () => success(`Hidden ${threadIds.length} conversation(s)`));
+            } catch (e) {
+                error(`Hide failed: ${e.message}`);
+            }
+        });
+
+    conv.command("unhide <threadIds...>")
+        .description("Unhide conversation(s)")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .action(async (threadIds, opts) => {
+            try {
+                const result = await getApi().setHiddenConversations(false, threadIds, Number(opts.type));
+                output(result, program.opts().json, () => success(`Unhidden ${threadIds.length} conversation(s)`));
+            } catch (e) {
+                error(`Unhide failed: ${e.message}`);
+            }
+        });
+
+    conv.command("hidden-pin <pin>")
+        .description("Set or update PIN for hidden conversations (4 digits)")
+        .action(async (pin) => {
+            try {
+                const result = await getApi().updateHiddenConversPin(pin);
+                output(result, program.opts().json, () => success("Hidden conversation PIN updated"));
+            } catch (e) {
+                error(`Update PIN failed: ${e.message}`);
+            }
+        });
+
+    conv.command("hidden-pin-reset")
+        .description("Reset hidden conversations PIN")
+        .action(async () => {
+            try {
+                const result = await getApi().resetHiddenConversPin();
+                output(result, program.opts().json, () => success("Hidden conversation PIN reset"));
+            } catch (e) {
+                error(`Reset PIN failed: ${e.message}`);
+            }
+        });
+
+    conv.command("auto-delete-status")
+        .description("View auto-delete chat settings")
+        .action(async () => {
+            try {
+                const result = await getApi().getAutoDeleteChat();
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Get auto-delete status failed: ${e.message}`);
+            }
+        });
+
+    conv.command("auto-delete <threadId> <ttl>")
+        .description("Set auto-delete for a conversation (off, 1d, 7d, 14d)")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .action(async (threadId, ttl, opts) => {
+            try {
+                const ttlMap = { off: 0, "1d": 86400000, "7d": 604800000, "14d": 1209600000 };
+                const ttlValue = ttlMap[ttl];
+                if (ttlValue === undefined) {
+                    error(`Invalid TTL "${ttl}". Valid: off, 1d, 7d, 14d`);
+                    return;
+                }
+                const result = await getApi().updateAutoDeleteChat(ttlValue, threadId, Number(opts.type));
+                output(result, program.opts().json, () => success(`Auto-delete set to ${ttl} for ${threadId}`));
+            } catch (e) {
+                error(`Set auto-delete failed: ${e.message}`);
+            }
+        });
+
     conv.command("delete <threadId>")
         .description("Delete conversation history")
         .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")

package/src/commands/label.js

@@ -0,0 +1,39 @@
+/**
+ * Label commands — list and update conversation/contact labels.
+ */
+
+import { getApi } from "../core/zalo-client.js";
+import { success, error, output } from "../utils/output.js";
+
+export function registerLabelCommands(program) {
+    const label = program.command("label").description("Manage conversation labels");
+
+    label
+        .command("list")
+        .description("List all labels")
+        .action(async () => {
+            try {
+                const result = await getApi().getLabels();
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Get labels failed: ${e.message}`);
+            }
+        });
+
+    label
+        .command("update <json>")
+        .description('Update labels (JSON payload: {"labelData":[...],"version":N})')
+        .action(async (json) => {
+            try {
+                const payload = JSON.parse(json);
+                const result = await getApi().updateLabels(payload);
+                output(result, program.opts().json, () => success("Labels updated"));
+            } catch (e) {
+                if (e instanceof SyntaxError) {
+                    error(`Invalid JSON: ${e.message}`);
+                } else {
+                    error(`Update labels failed: ${e.message}`);
+                }
+            }
+        });
+}

package/src/commands/msg.js

@@ -307,12 +307,18 @@ export function registerMsgCommands(program) {
             try {
                 const api = getApi();
                 const search = await api.searchSticker(keyword);
-                const stickerId = search?.[0]?.stickerId || "";
-                if (!stickerId) {
+                const first = search?.[0];
+                if (!first) {
                     error("No sticker found");
                     return;
                 }
-                const result = await api.sendSticker(stickerId, threadId, Number(opts.type));
+                // sendSticker expects {id, cateId, type} object
+                const stickerObj = {
+                    id: first.sticker_id || first.stickerId || first.id,
+                    cateId: first.cate_id || first.cateId,
+                    type: first.type || 7,
+                };
+                const result = await api.sendSticker(stickerObj, threadId, Number(opts.type));
                 output(result, program.opts().json, () => success("Sticker sent"));
             } catch (e) {
                 error(e.message);
@@ -376,6 +382,44 @@ export function registerMsgCommands(program) {
             }
         });
 
+    msg.command("sticker-list <keyword>")
+        .description("Search stickers by keyword (returns sticker IDs)")
+        .action(async (keyword) => {
+            try {
+                const result = await getApi().getStickers(keyword);
+                output(result, program.opts().json, () => {
+                    const ids = Array.isArray(result) ? result : [];
+                    info(`${ids.length} sticker(s) found for "${keyword}"`);
+                    for (const id of ids) console.log(`  ${id}`);
+                });
+            } catch (e) {
+                error(`Sticker search failed: ${e.message}`);
+            }
+        });
+
+    msg.command("sticker-detail <stickerIds...>")
+        .description("Get sticker details by IDs")
+        .action(async (stickerIds) => {
+            try {
+                const ids = stickerIds.map(Number);
+                const result = await getApi().getStickersDetail(ids);
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Sticker detail failed: ${e.message}`);
+            }
+        });
+
+    msg.command("sticker-category <categoryId>")
+        .description("Get sticker category details")
+        .action(async (categoryId) => {
+            try {
+                const result = await getApi().getStickerCategoryDetail(Number(categoryId));
+                output(result, program.opts().json);
+            } catch (e) {
+                error(`Sticker category failed: ${e.message}`);
+            }
+        });
+
     msg.command("react <msgId> <threadId> <reaction>")
         .description(
             "React to a message. Reaction codes: :> (haha), /-heart (heart), /-strong (like), :o (wow), :-(( (cry), :-h (angry)",