zalo-agent-cli 1.0.7 → 1.0.8

package/package.json

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

package/src/commands/msg.js

@@ -13,7 +13,10 @@ export function registerMsgCommands(program) {
     msg.command("send <threadId> <message>")
         .description("Send a text message")
         .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
-        .option("--react <icon>", "Auto-react to the sent message (e.g. :> for haha)")
+        .option(
+            "--react <icon>",
+            "Auto-react to sent message. Codes: :> (haha), /-heart (heart), /-strong (like), :o (wow), :-(( (cry), :-h (angry)",
+        )
         .action(async (threadId, message, opts) => {
             try {
                 // Capture clientId before send — zca-js uses Date.now() internally
@@ -204,9 +207,14 @@ export function registerMsgCommands(program) {
         });
 
     msg.command("react <msgId> <threadId> <reaction>")
-        .description("React to a message with an emoji")
+        .description(
+            "React to a message. Reaction codes: :> (haha), /-heart (heart), /-strong (like), :o (wow), :-(( (cry), :-h (angry)",
+        )
         .option("-t, --type <n>", "Thread type: 0=User, 1=Group", "0")
-        .option("-c, --cli-msg-id <id>", "Client message ID (defaults to msgId)")
+        .option(
+            "-c, --cli-msg-id <id>",
+            "Client message ID (required for reaction to appear, get from msg listen --json)",
+        )
         .action(async (msgId, threadId, reaction, opts) => {
             try {
                 // zca-js addReaction(icon, dest) — dest needs msgId + cliMsgId
@@ -223,14 +231,28 @@ export function registerMsgCommands(program) {
         });
 
     msg.command("listen")
-        .description("Listen for incoming messages (Ctrl+C to stop)")
-        .action(async () => {
+        .description(
+            "Listen for incoming messages in real-time via WebSocket. Outputs msgId + cliMsgId needed for react. Use --json for machine parsing.",
+        )
+        .option("-f, --filter <type>", "Filter messages: user (DM only), group (groups only), all (default)", "all")
+        .option("-w, --webhook <url>", "POST each message as JSON to this URL (for n8n, Make, etc.)")
+        .option("--no-self", "Exclude messages sent by this account")
+        .action(async (opts) => {
             try {
                 const api = getApi();
+                const jsonMode = program.opts().json;
                 info("Listening for messages... Press Ctrl+C to stop.");
                 info("Note: Only one web listener per account. Browser Zalo will disconnect.");
+                if (opts.filter !== "all") info(`Filter: ${opts.filter} messages only`);
+                if (opts.webhook) info(`Webhook: POST to ${opts.webhook}`);
+
+                api.listener.on("message", async (msg) => {
+                    // Filter by type: 0=User, 1=Group
+                    if (opts.filter === "user" && msg.type !== 0) return;
+                    if (opts.filter === "group" && msg.type !== 1) return;
+                    // Filter self messages
+                    if (!opts.self && msg.isSelf) return;
 
-                api.listener.on("message", (msg) => {
                     const content = typeof msg.data.content === "string" ? msg.data.content : "[non-text]";
                     const data = {
                         msgId: msg.data.msgId,
@@ -240,11 +262,27 @@ export function registerMsgCommands(program) {
                         isSelf: msg.isSelf,
                         content,
                     };
-                    if (program.opts().json) {
+
+                    // Output to stdout
+                    if (jsonMode) {
                         console.log(JSON.stringify(data));
                     } else {
                         const dir = msg.isSelf ? "→" : "←";
-                        console.log(`  ${dir} [${msg.threadId}] ${content}  (msgId: ${msg.data.msgId})`);
+                        const typeLabel = msg.type === 0 ? "DM" : "GR";
+                        console.log(`  ${dir} [${typeLabel}] [${msg.threadId}] ${content}  (msgId: ${msg.data.msgId})`);
+                    }
+
+                    // POST to webhook if configured
+                    if (opts.webhook) {
+                        try {
+                            await fetch(opts.webhook, {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify(data),
+                            });
+                        } catch {
+                            // Silent webhook failure — don't block listener
+                        }
                     }
                 });