@warriorteam/redai-zalo-sdk 1.22.0 → 1.24.0

package/examples/promotion-examples.ts

@@ -39,7 +39,7 @@ export async function sendStandardPromotion() {
           {
             title: "Tham khảo chương trình",
             imageIcon: "",
-            type: "oa.open.url",
+            type: "oa.open.url" as const,
             payload: {
               url: "https://oa.zalo.me/home"
             }
@@ -47,7 +47,7 @@ export async function sendStandardPromotion() {
           {
             title: "Liên hệ chăm sóc viên",
             imageIcon: "aeqg9SYn3nIUYYeWohGI1fYRF3V9f0GHceig8Ckq4WQVcpmWb-9SL8JLPt-6gX0QbTCfSuQv40UEst1imAm53CwFPsQ1jq9MsOnlQe6rIrZOYcrlWBTAKy_UQsV9vnfGozCuOvFfIbN5rcXddFKM4sSYVM0D50I9eWy3",
-            type: "oa.query.hide",
+            type: "oa.query.hide" as const,
             payload: "#tuvan" // String trực tiếp theo docs
           }
         ],
@@ -174,22 +174,22 @@ export async function sendAllButtonTypes() {
         buttons: [
           {
             title: "Mở URL",
-            type: "oa.open.url",
+            type: "oa.open.url" as const,
             payload: { url: "https://developers.zalo.me/" }
           },
           {
             title: "Query Show",
-            type: "oa.query.show",
+            type: "oa.query.show" as const,
             payload: "#callback_show"
           },
           {
             title: "Query Hide",
-            type: "oa.query.hide",
+            type: "oa.query.hide" as const,
             payload: "#callback_hide"
           },
           {
             title: "Gửi SMS",
-            type: "oa.open.sms",
+            type: "oa.open.sms" as const,
             payload: {
               content: "Xin chào từ Zalo OA",
               phone_code: "84919018791"
@@ -197,7 +197,7 @@ export async function sendAllButtonTypes() {
           },
           {
             title: "Gọi điện",
-            type: "oa.open.phone",
+            type: "oa.open.phone" as const,
             payload: { phone_code: "84919018791" }
           }
         ],
@@ -213,6 +213,155 @@ export async function sendAllButtonTypes() {
   }
 }
 
+/**
+ * Example 6: Gửi promotion đến nhiều users với tracking
+ */
+export async function sendPromotionToMultipleUsers() {
+  try {
+    const userIds = [
+      "4356639876691778517",
+      "1234567890123456789",
+      "9876543210987654321",
+      "5555666677778888999"
+    ];
+
+    console.log(`🚀 Bắt đầu gửi promotion đến ${userIds.length} users...`);
+
+    const result = await promotionService.sendCustomPromotionToMultipleUsers(
+      ACCESS_TOKEN,
+      userIds,
+      {
+        attachmentId: "your_attachment_id",
+        headerContent: "🎉 Khuyến mãi đặc biệt cho bạn!",
+        textContent: "Ưu đãi độc quyền dành riêng cho khách hàng VIP. Nhanh tay đặt hàng để nhận ngay voucher giảm giá!",
+        tableData: [
+          { key: "Mã giảm giá", value: "SAVE50" },
+          { key: "Giảm giá", value: "50%" },
+          { key: "Hạn sử dụng", value: "31/12/2024" },
+          { key: "Áp dụng", value: "Tất cả sản phẩm" }
+        ],
+        footerText: "⏰ Ưu đãi có thời hạn - Đặt hàng ngay!",
+        buttons: [
+          {
+            title: "Mua ngay",
+            type: "oa.open.url" as const,
+            payload: { url: "https://shop.example.com/sale" }
+          },
+          {
+            title: "Xem thêm ưu đãi",
+            type: "oa.query.hide" as const,
+            payload: "#xemthem"
+          }
+        ],
+        language: "VI"
+      },
+      {
+        mode: "sequential", // Gửi tuần tự để tránh rate limit
+        delayMs: 2000, // Delay 2 giây giữa các tin
+        continueOnError: true, // Tiếp tục khi có lỗi
+
+        // Callback tracking progress
+        onProgress: (progress) => {
+          const percent = Math.round((progress.completed / progress.total) * 100);
+          const eta = progress.estimatedTimeRemaining
+            ? Math.round(progress.estimatedTimeRemaining / 1000)
+            : 0;
+
+          console.log(`📊 Progress: ${percent}% (${progress.completed}/${progress.total})`);
+          console.log(`✅ Thành công: ${progress.successful} | ❌ Thất bại: ${progress.failed}`);
+
+          if (progress.currentUserId) {
+            console.log(`🔄 Đang gửi đến user: ${progress.currentUserId}`);
+          }
+
+          if (eta > 0) {
+            console.log(`⏱️ Thời gian còn lại: ~${eta}s`);
+          }
+
+          console.log("---");
+        },
+
+        // Callback cho từng user hoàn thành
+        onUserComplete: (userResult) => {
+          if (userResult.success) {
+            console.log(`✅ Gửi thành công đến user ${userResult.userId}`);
+            console.log(`   Message ID: ${userResult.result?.message_id}`);
+          } else {
+            console.log(`❌ Gửi thất bại đến user ${userResult.userId}`);
+            console.log(`   Lỗi: ${userResult.error?.message}`);
+          }
+        }
+      }
+    );
+
+    // Kết quả cuối cùng
+    console.log("\n🎯 KẾT QUẢ CUỐI CÙNG:");
+    console.log(`📊 Tổng số users: ${result.total}`);
+    console.log(`✅ Thành công: ${result.successful}`);
+    console.log(`❌ Thất bại: ${result.failed}`);
+    console.log(`📈 Tỷ lệ thành công: ${result.successRate.toFixed(1)}%`);
+    console.log(`⏱️ Thời gian thực hiện: ${(result.executionTime / 1000).toFixed(1)}s`);
+    console.log(`🔄 Chế độ gửi: ${result.mode}`);
+
+    // Chi tiết lỗi (nếu có)
+    const failedResults = result.results.filter(r => !r.success);
+    if (failedResults.length > 0) {
+      console.log("\n❌ CHI TIẾT LỖI:");
+      failedResults.forEach(failed => {
+        console.log(`- User ${failed.userId}: ${failed.error?.message}`);
+      });
+    }
+
+    return result;
+  } catch (error) {
+    console.error("Failed to send promotion to multiple users:", error);
+    throw error;
+  }
+}
+
+/**
+ * Example 7: Gửi promotion song song (parallel mode)
+ */
+export async function sendPromotionParallel() {
+  try {
+    const userIds = ["user1", "user2", "user3"];
+
+    const result = await promotionService.sendCustomPromotionToMultipleUsers(
+      ACCESS_TOKEN,
+      userIds,
+      {
+        attachmentId: "your_attachment_id",
+        headerContent: "⚡ Flash Sale - Chỉ 1 giờ!",
+        textContent: "Giảm giá sốc 70% cho 100 khách hàng đầu tiên!",
+        tableData: [
+          { key: "Giảm giá", value: "70%" },
+          { key: "Thời gian", value: "1 giờ" }
+        ],
+        buttons: [
+          {
+            title: "Mua ngay",
+            type: "oa.open.url" as const,
+            payload: { url: "https://flash-sale.example.com" }
+          }
+        ]
+      },
+      {
+        mode: "parallel", // Gửi song song để tối ưu tốc độ
+        continueOnError: true,
+        onProgress: (progress) => {
+          console.log(`⚡ Parallel sending: ${progress.completed}/${progress.total} completed`);
+        }
+      }
+    );
+
+    console.log(`⚡ Parallel sending completed in ${result.executionTime}ms`);
+    return result;
+  } catch (error) {
+    console.error("Failed to send parallel promotion:", error);
+    throw error;
+  }
+}
+
 /**
  * Chạy tất cả examples
  */
@@ -240,6 +389,14 @@ export async function runAllExamples() {
     await sendAllButtonTypes();
     console.log("✅ All button types demo sent\n");
 
+    console.log("6. Sending promotion to multiple users...");
+    await sendPromotionToMultipleUsers();
+    console.log("✅ Multiple users promotion sent\n");
+
+    console.log("7. Sending promotion in parallel mode...");
+    await sendPromotionParallel();
+    console.log("✅ Parallel promotion sent\n");
+
     console.log("🎉 All examples completed successfully!");
   } catch (error) {
     console.error("❌ Error running examples:", error);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warriorteam/redai-zalo-sdk",
-  "version": "1.22.0",
-  "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account v3.0, ZNS, Consultation Service, Broadcast Service, Group Messaging with List APIs, Social APIs, Enhanced Article Management, Promotion Service v3.0, and Message Sequence APIs with Real-time Tracking",
+  "version": "1.24.0",
+  "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account v3.0, ZNS, Consultation Service, Broadcast Service, Group Messaging with List APIs, Social APIs, Enhanced Article Management, Promotion Service v3.0 with Multiple Users Support, Complete Button Types System, and Message Sequence APIs with Real-time Tracking",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -55,7 +55,24 @@
     "banner-element",
     "table-element",
     "multi-language",
-    "button-actions"
+    "button-actions",
+    "multiple-users",
+    "bulk-promotion",
+    "real-time-tracking",
+    "progress-callback",
+    "sequential-sending",
+    "parallel-sending",
+    "campaign-management",
+    "error-isolation",
+    "button-types",
+    "typescript-support",
+    "type-safety",
+    "auto-conversion",
+    "payload-validation",
+    "query-buttons",
+    "url-buttons",
+    "sms-buttons",
+    "phone-buttons"
   ],
   "author": "RedAI Team",
   "license": "MIT",