zalo-agent-cli 1.0.26 → 1.0.28

package/README.md

@@ -166,6 +166,7 @@ zalo-agent whoami
 | `msg send-card <threadId> <userId> [-t 0\|1] [--phone NUM]` | Send contact card |
 | `msg send-bank <threadId> <accountNum> -b BANK [-n name] [-t 0\|1]` | Send bank card |
 | `msg send-qr-transfer <threadId> <accountNum> -b BANK [-a amount] [-m content] [--template tpl]` | Send VietQR transfer image |
+| `msg send-link <threadId> <url> [-m caption] [-t 0\|1]` | Send link with auto-preview |
 | `msg send-video <threadId> <videoUrl> --thumb <thumbUrl> [-m caption] [-d ms] [-W px] [-H px]` | Send video from URL |
 | `msg sticker <threadId> <keyword> [-t 0\|1]` | Search and send sticker |
 | `msg react <msgId> <threadId> <emoji> [-t 0\|1]` | React to a message |
@@ -220,6 +221,7 @@ zalo-agent msg send <threadId> "Hello World" --style 0:5:bold 6:5:italic
 |---------|-------------|
 | `group list` | List all groups |
 | `group create <name> <memberIds...>` | Create group |
+| `group history <groupId> [-n count]` | Get chat history (normalized JSON) |
 | `group info <groupId>` | Group details |
 | `group members <groupId>` | List members |
 | `group add-member <groupId> <userIds...>` | Add members |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments",
   "type": "module",
   "bin": {

package/src/commands/group.js

@@ -46,6 +46,64 @@ export function registerGroupCommands(program) {
             }
         });
 
+    group
+        .command("history <groupId>")
+        .description("Get group chat history (recent messages)")
+        .option("-n, --count <n>", "Number of messages to fetch", "20")
+        .action(async (groupId, opts) => {
+            try {
+                const result = await getApi().getGroupChatHistory(groupId, Number(opts.count));
+                const msgs = result?.groupMsgs || [];
+
+                // Normalize messages into clean, storage-friendly JSON
+                const normalized = msgs.map((m) => {
+                    const d = m.data || m;
+                    const content = typeof d.content === "string" ? d.content : d.content;
+                    return {
+                        msgId: d.msgId,
+                        cliMsgId: d.cliMsgId,
+                        fromUid: d.uidFrom,
+                        groupId: d.idTo,
+                        msgType: d.msgType,
+                        content: typeof content === "string" ? content : content,
+                        timestamp: Number(d.ts),
+                        isoTime: new Date(Number(d.ts)).toISOString(),
+                        isSelf: m.isSelf ?? false,
+                        ...(d.mentions && { mentions: d.mentions }),
+                        ...(d.quote && {
+                            quote: {
+                                ownerId: d.quote.ownerId,
+                                msg: d.quote.msg,
+                                msgId: d.quote.globalMsgId,
+                            },
+                        }),
+                    };
+                });
+
+                const payload = {
+                    groupId,
+                    count: normalized.length,
+                    hasMore: result?.more === 1,
+                    messages: normalized,
+                };
+
+                output(payload, program.opts().json, () => {
+                    info(`${normalized.length} message(s) in group ${groupId}`);
+                    if (result?.more === 1) info("(more messages available)");
+                    console.log();
+                    for (const m of normalized) {
+                        const time = new Date(m.timestamp).toLocaleTimeString();
+                        const dir = m.isSelf ? "→" : "←";
+                        const text =
+                            typeof m.content === "string" ? m.content.slice(0, 80) : `[${m.msgType || "attachment"}]`;
+                        console.log(`  ${time} ${dir} ${m.fromUid}: ${text}`);
+                    }
+                });
+            } catch (e) {
+                error(`Get history failed: ${e.message}`);
+            }
+        });
+
     group
         .command("members <groupId>")
         .description("List group members")

package/src/commands/msg.js

@@ -319,6 +319,20 @@ export function registerMsgCommands(program) {
             }
         });
 
+    msg.command("send-link <threadId> <url>")
+        .description("Send a link with auto-preview (title, description, thumbnail)")
+        .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
+        .option("-m, --caption <text>", "Caption text")
+        .action(async (threadId, url, opts) => {
+            try {
+                info(`Sending link: ${url}`);
+                const result = await getApi().sendLink({ link: url, msg: opts.caption }, threadId, Number(opts.type));
+                output(result, program.opts().json, () => success(`Link sent to ${threadId}`));
+            } catch (e) {
+                error(`Send link failed: ${e.message}`);
+            }
+        });
+
     msg.command("send-video <threadId> <videoUrl>")
         .description("Send a video from URL")
         .requiredOption("--thumb <url>", "Thumbnail image URL")