@warriorteam/redai-zalo-sdk 1.17.5 → 1.19.0

package/examples/group-message-list.ts

@@ -0,0 +1,288 @@
+import { 
+  GroupMessageService, 
+  GroupMessageItem, 
+  SendMessageListToGroupRequest,
+  SendMessageListToMultipleGroupsRequest,
+  GroupMessageProgressInfo,
+  MultipleGroupsProgressInfo 
+} from "../src/services/group-message.service";
+import { ZaloClient } from "../src/clients/zalo-client";
+
+/**
+ * Ví dụ sử dụng API gửi danh sách tin nhắn tới 1 group với callback tracking
+ */
+async function sendMessageListToGroupExample() {
+  // Khởi tạo Zalo client và group message service
+  const zaloClient = new ZaloClient();
+  const groupMessageService = new GroupMessageService(zaloClient);
+
+  // Thông tin cấu hình
+  const accessToken = "YOUR_ACCESS_TOKEN";
+  const groupId = "GROUP_ID_TO_SEND_TO";
+
+  // Định nghĩa danh sách tin nhắn thông báo
+  const messages: GroupMessageItem[] = [
+    {
+      type: "text",
+      text: "📢 THÔNG BÁO QUAN TRỌNG",
+      delay: 2000,
+    },
+    {
+      type: "text",
+      text: "🔧 Hệ thống sẽ bảo trì từ 2:00 - 4:00 sáng ngày mai (15/09/2024)",
+      delay: 1500,
+    },
+    {
+      type: "image",
+      imageUrl: "https://example.com/maintenance-schedule.jpg",
+      caption: "Lịch trình bảo trì chi tiết",
+      delay: 2000,
+    },
+    {
+      type: "text",
+      text: "⚠️ Trong thời gian bảo trì, các dịch vụ sau sẽ tạm ngưng:\n• Website chính\n• Mobile App\n• API Services",
+      delay: 1500,
+    },
+    {
+      type: "sticker",
+      stickerId: "MAINTENANCE_STICKER_ID",
+      delay: 1000,
+    },
+    {
+      type: "text",
+      text: "📞 Hotline hỗ trợ khẩn cấp: 1900-xxxx\n📧 Email: support@company.com",
+    },
+  ];
+
+  // Callback function để tracking tiến trình
+  const onProgress = (progress: GroupMessageProgressInfo) => {
+    const percentage = Math.round(((progress.messageIndex + 1) / progress.totalMessages) * 100);
+    
+    switch (progress.status) {
+      case 'started':
+        console.log(`🚀 [${percentage}%] Bắt đầu gửi tin nhắn ${progress.messageIndex + 1}/${progress.totalMessages} (${progress.messageType})`);
+        break;
+        
+      case 'completed':
+        const duration = progress.endTime ? progress.endTime - progress.startTime : 0;
+        console.log(`✅ [${percentage}%] Hoàn thành tin nhắn ${progress.messageIndex + 1}/${progress.totalMessages} - ${duration}ms`);
+        break;
+        
+      case 'failed':
+        const failDuration = progress.endTime ? progress.endTime - progress.startTime : 0;
+        console.log(`❌ [${percentage}%] Thất bại tin nhắn ${progress.messageIndex + 1}/${progress.totalMessages} - ${failDuration}ms - Lỗi: ${progress.error}`);
+        break;
+    }
+  };
+
+  // Tạo request
+  const request: SendMessageListToGroupRequest = {
+    accessToken,
+    groupId,
+    messages,
+    defaultDelay: 1000, // Delay mặc định 1 giây giữa các tin nhắn
+    onProgress, // Callback tracking
+  };
+
+  try {
+    console.log("📢 Bắt đầu gửi danh sách tin nhắn thông báo tới group...");
+    console.log(`👥 Group ID: ${groupId}`);
+    console.log(`📝 Tổng số tin nhắn: ${messages.length}`);
+    console.log("─".repeat(60));
+    
+    // Gửi danh sách tin nhắn tới group
+    const result = await groupMessageService.sendMessageListToGroup(request);
+
+    console.log("─".repeat(60));
+    console.log("🎊 KẾT QUẢ:");
+    console.log(`📝 Tổng tin nhắn: ${result.totalMessages}`);
+    console.log(`✅ Thành công: ${result.successfulMessages} (${Math.round((result.successfulMessages / result.totalMessages) * 100)}%)`);
+    console.log(`❌ Thất bại: ${result.failedMessages} (${Math.round((result.failedMessages / result.totalMessages) * 100)}%)`);
+    console.log(`⏱️ Tổng thời gian: ${result.totalDuration}ms (${Math.round(result.totalDuration / 1000)}s)`);
+
+    // In chi tiết từng tin nhắn
+    console.log("\n📋 CHI TIẾT TỪNG TIN NHẮN:");
+    result.messageResults.forEach((messageResult, index) => {
+      const status = messageResult.success ? "✅" : "❌";
+      console.log(`${status} [${index + 1}] ${messageResult.messageType} - ${messageResult.duration}ms`);
+      
+      if (!messageResult.success && messageResult.error) {
+        console.log(`   ❌ Lỗi: ${messageResult.error}`);
+      }
+    });
+
+  } catch (error) {
+    console.error("❌ Lỗi khi gửi danh sách tin nhắn tới group:", error);
+  }
+}
+
+/**
+ * Ví dụ gửi danh sách tin nhắn tới nhiều groups
+ */
+async function sendMessageListToMultipleGroupsExample() {
+  const zaloClient = new ZaloClient();
+  const groupMessageService = new GroupMessageService(zaloClient);
+
+  const accessToken = "YOUR_ACCESS_TOKEN";
+  const groupIds = [
+    "GROUP_ID_1",
+    "GROUP_ID_2", 
+    "GROUP_ID_3",
+    "GROUP_ID_4"
+  ];
+
+  // Danh sách tin nhắn marketing
+  const messages: GroupMessageItem[] = [
+    {
+      type: "text",
+      text: "🎉 FLASH SALE 24H - GIẢM GIÁ SỐC!",
+      delay: 2000,
+    },
+    {
+      type: "image",
+      imageUrl: "https://example.com/flash-sale-banner.jpg",
+      caption: "🔥 Giảm tới 70% + Freeship toàn quốc",
+      delay: 3000,
+    },
+    {
+      type: "text",
+      text: "⏰ Chỉ còn 12 giờ! Số lượng có hạn!\n🛒 Mua ngay: https://shop.example.com/flash-sale",
+      delay: 1500,
+    },
+    {
+      type: "sticker",
+      stickerId: "SALE_STICKER_ID",
+    },
+  ];
+
+  // Callback tracking cho multiple groups
+  let completedGroups = 0;
+  const onProgress = (progress: MultipleGroupsProgressInfo) => {
+    switch (progress.status) {
+      case 'started':
+        console.log(`🎯 Bắt đầu gửi tới Group ${progress.groupIndex + 1}/${progress.totalGroups} (${progress.groupId})`);
+        break;
+        
+      case 'completed':
+        completedGroups++;
+        const successRate = progress.result ? 
+          Math.round((progress.result.successfulMessages / progress.result.totalMessages) * 100) : 0;
+        console.log(`✅ Hoàn thành Group ${completedGroups}/${progress.totalGroups} - Thành công: ${successRate}%`);
+        break;
+        
+      case 'failed':
+        console.log(`❌ Thất bại Group ${progress.groupIndex + 1}/${progress.totalGroups} - Lỗi: ${progress.error}`);
+        break;
+    }
+  };
+
+  const request: SendMessageListToMultipleGroupsRequest = {
+    accessToken,
+    groupIds,
+    messages,
+    defaultDelay: 1000, // Delay giữa tin nhắn
+    delayBetweenGroups: 3000, // Delay 3 giây giữa các groups
+    onProgress,
+  };
+
+  try {
+    console.log("🎯 Bắt đầu chiến dịch marketing tới nhiều groups...");
+    console.log(`👥 Tổng số groups: ${groupIds.length}`);
+    console.log(`📝 Tổng số tin nhắn mỗi group: ${messages.length}`);
+    console.log(`📊 Tổng số tin nhắn sẽ gửi: ${groupIds.length * messages.length}`);
+    console.log("─".repeat(60));
+    
+    const result = await groupMessageService.sendMessageListToMultipleGroups(request);
+
+    console.log("─".repeat(60));
+    console.log("🎊 KẾT QUẢ TỔNG QUAN:");
+    console.log(`👥 Tổng groups: ${result.totalGroups}`);
+    console.log(`✅ Groups thành công: ${result.successfulGroups} (${Math.round((result.successfulGroups / result.totalGroups) * 100)}%)`);
+    console.log(`❌ Groups thất bại: ${result.failedGroups} (${Math.round((result.failedGroups / result.totalGroups) * 100)}%)`);
+    console.log(`⏱️ Tổng thời gian: ${result.totalDuration}ms (${Math.round(result.totalDuration / 1000)}s)`);
+    
+    console.log("\n📊 THỐNG KÊ TIN NHẮN:");
+    console.log(`✅ Tin nhắn thành công: ${result.messageStats.totalSuccessfulMessages}`);
+    console.log(`❌ Tin nhắn thất bại: ${result.messageStats.totalFailedMessages}`);
+    console.log(`📝 Tổng tin nhắn: ${result.messageStats.totalMessages}`);
+    console.log(`📈 Tỷ lệ thành công: ${Math.round((result.messageStats.totalSuccessfulMessages / result.messageStats.totalMessages) * 100)}%`);
+
+    // In chi tiết từng group
+    console.log("\n📋 CHI TIẾT TỪNG GROUP:");
+    result.groupResults.forEach((groupResult, index) => {
+      const status = groupResult.success ? "✅" : "❌";
+      const successRate = groupResult.messageListResult ? 
+        Math.round((groupResult.messageListResult.successfulMessages / groupResult.messageListResult.totalMessages) * 100) : 0;
+      
+      console.log(`${status} Group ${index + 1}: ${groupResult.groupId} - ${groupResult.duration}ms - Thành công: ${successRate}%`);
+      
+      if (!groupResult.success && groupResult.error) {
+        console.log(`   ❌ Lỗi: ${groupResult.error}`);
+      }
+    });
+
+  } catch (error) {
+    console.error("❌ Lỗi khi gửi danh sách tin nhắn tới nhiều groups:", error);
+  }
+}
+
+/**
+ * Ví dụ gửi tin nhắn mention tới group
+ */
+async function sendMentionMessageListExample() {
+  const zaloClient = new ZaloClient();
+  const groupMessageService = new GroupMessageService(zaloClient);
+
+  const accessToken = "YOUR_ACCESS_TOKEN";
+  const groupId = "GROUP_ID";
+
+  const messages: GroupMessageItem[] = [
+    {
+      type: "text",
+      text: "🎯 Cuộc họp quan trọng sắp diễn ra!",
+      delay: 1000,
+    },
+    {
+      type: "mention",
+      text: "@Admin @Manager Vui lòng chuẩn bị tài liệu cho cuộc họp lúc 14:00",
+      mentions: [
+        { user_id: "ADMIN_USER_ID", offset: 0, length: 6 },
+        { user_id: "MANAGER_USER_ID", offset: 7, length: 8 }
+      ],
+      delay: 2000,
+    },
+    {
+      type: "text",
+      text: "📋 Agenda:\n1. Báo cáo tháng\n2. Kế hoạch quý mới\n3. Q&A",
+    },
+  ];
+
+  const onProgress = (progress: GroupMessageProgressInfo) => {
+    if (progress.status === 'completed') {
+      console.log(`✅ Đã gửi tin nhắn ${progress.messageIndex + 1}: ${progress.messageType}`);
+    } else if (progress.status === 'failed') {
+      console.log(`❌ Gửi thất bại tin nhắn ${progress.messageIndex + 1}: ${progress.error}`);
+    }
+  };
+
+  try {
+    const result = await groupMessageService.sendMessageListToGroup({
+      accessToken,
+      groupId,
+      messages,
+      defaultDelay: 1500,
+      onProgress,
+    });
+
+    console.log(`\n📢 Đã gửi thông báo cuộc họp: ${result.successfulMessages}/${result.totalMessages} tin nhắn thành công`);
+  } catch (error) {
+    console.error("❌ Lỗi gửi thông báo cuộc họp:", error);
+  }
+}
+
+// Export các function để sử dụng
+export {
+  sendMessageListToGroupExample,
+  sendMessageListToMultipleGroupsExample,
+  sendMentionMessageListExample,
+};

package/examples/send-message-sequence.ts

@@ -0,0 +1,200 @@
+import { ConsultationService, MessageItem, SendMessageSequenceRequest } from "../src/services/consultation.service";
+import { ZaloClient } from "../src/clients/zalo-client";
+
+/**
+ * Ví dụ sử dụng API gửi chuỗi tin nhắn tư vấn
+ */
+async function sendMessageSequenceExample() {
+  // Khởi tạo Zalo client và consultation service
+  const zaloClient = new ZaloClient();
+  const consultationService = new ConsultationService(zaloClient);
+
+  // Thông tin cấu hình
+  const accessToken = "YOUR_ACCESS_TOKEN";
+  const userId = "USER_ID_TO_SEND_TO";
+
+  // Định nghĩa chuỗi tin nhắn
+  const messages: MessageItem[] = [
+    // 1. Tin nhắn chào hỏi
+    {
+      type: "text",
+      text: "Xin chào! Cảm ơn bạn đã liên hệ với chúng tôi 👋",
+      delay: 2000, // Delay 2 giây sau tin nhắn này
+    },
+
+    // 2. Gửi sticker
+    {
+      type: "sticker",
+      stickerAttachmentId: "STICKER_ID",
+      delay: 1500, // Delay 1.5 giây
+    },
+
+    // 3. Tin nhắn giới thiệu dịch vụ
+    {
+      type: "text",
+      text: "Chúng tôi cung cấp các dịch vụ tư vấn chuyên nghiệp. Dưới đây là một số thông tin chi tiết:",
+      delay: 3000, // Delay 3 giây
+    },
+
+    // 4. Gửi hình ảnh minh họa
+    {
+      type: "image",
+      imageUrl: "https://example.com/service-image.jpg",
+      text: "Dịch vụ tư vấn của chúng tôi",
+      delay: 2000,
+    },
+
+    // 5. Gửi file tài liệu
+    {
+      type: "file",
+      fileToken: "FILE_TOKEN_FROM_UPLOAD_API",
+      delay: 1000,
+    },
+
+    // 6. Gửi GIF
+    {
+      type: "gif",
+      gifUrl: "https://example.com/animation.gif",
+      width: 300,
+      height: 200,
+      text: "Quy trình làm việc của chúng tôi",
+      delay: 2500,
+    },
+
+    // 7. Yêu cầu thông tin người dùng
+    {
+      type: "request_user_info",
+      title: "Đăng ký tư vấn miễn phí",
+      subtitle: "Vui lòng cung cấp thông tin để chúng tôi hỗ trợ bạn tốt nhất",
+      imageUrl: "https://example.com/consultation-form.jpg",
+      delay: 1000,
+    },
+
+    // 8. Tin nhắn kết thúc (không có delay vì là tin cuối)
+    {
+      type: "text",
+      text: "Cảm ơn bạn! Chúng tôi sẽ liên hệ lại trong thời gian sớm nhất. 🙏",
+    },
+  ];
+
+  // Tạo request
+  const request: SendMessageSequenceRequest = {
+    accessToken,
+    userId,
+    messages,
+    defaultDelay: 1000, // Delay mặc định 1 giây nếu tin nhắn không có delay riêng
+  };
+
+  try {
+    console.log("🚀 Bắt đầu gửi chuỗi tin nhắn...");
+    console.log(`📝 Tổng số tin nhắn: ${messages.length}`);
+    
+    // Gửi chuỗi tin nhắn
+    const result = await consultationService.sendMessageSequence(request);
+
+    console.log("\n✅ Kết quả gửi tin nhắn:");
+    console.log(`✅ Thành công: ${result.successCount}/${messages.length}`);
+    console.log(`❌ Thất bại: ${result.failureCount}/${messages.length}`);
+    console.log(`⏱️ Tổng thời gian: ${result.totalDuration}ms`);
+
+    // In chi tiết kết quả từng tin nhắn
+    console.log("\n📊 Chi tiết từng tin nhắn:");
+    result.results.forEach((messageResult, index) => {
+      const status = messageResult.success ? "✅" : "❌";
+      const time = new Date(messageResult.timestamp).toLocaleTimeString();
+      
+      console.log(`${status} [${index + 1}] ${messageResult.type} - ${time}`);
+      
+      if (messageResult.success && messageResult.response) {
+        console.log(`   📧 Message ID: ${messageResult.response.message_id}`);
+      }
+      
+      if (!messageResult.success && messageResult.error) {
+        console.log(`   ❌ Lỗi: ${messageResult.error}`);
+      }
+    });
+
+  } catch (error) {
+    console.error("❌ Lỗi khi gửi chuỗi tin nhắn:", error);
+  }
+}
+
+/**
+ * Ví dụ gửi chuỗi tin nhắn đơn giản chỉ có text
+ */
+async function sendSimpleTextSequence() {
+  const zaloClient = new ZaloClient();
+  const consultationService = new ConsultationService(zaloClient);
+
+  const accessToken = "YOUR_ACCESS_TOKEN";
+  const userId = "USER_ID_TO_SEND_TO";
+
+  const messages: MessageItem[] = [
+    {
+      type: "text",
+      text: "Tin nhắn đầu tiên",
+      delay: 1000,
+    },
+    {
+      type: "text", 
+      text: "Tin nhắn thứ hai",
+      delay: 1500,
+    },
+    {
+      type: "text",
+      text: "Tin nhắn cuối cùng",
+    },
+  ];
+
+  const request: SendMessageSequenceRequest = {
+    accessToken,
+    userId,
+    messages,
+  };
+
+  try {
+    const result = await consultationService.sendMessageSequence(request);
+    console.log("Kết quả:", result);
+  } catch (error) {
+    console.error("Lỗi:", error);
+  }
+}
+
+/**
+ * Ví dụ gửi chuỗi tin nhắn với delay mặc định
+ */
+async function sendSequenceWithDefaultDelay() {
+  const zaloClient = new ZaloClient();
+  const consultationService = new ConsultationService(zaloClient);
+
+  const accessToken = "YOUR_ACCESS_TOKEN";
+  const userId = "USER_ID_TO_SEND_TO";
+
+  // Các tin nhắn không có delay riêng sẽ sử dụng defaultDelay
+  const messages: MessageItem[] = [
+    { type: "text", text: "Tin nhắn 1" },
+    { type: "text", text: "Tin nhắn 2" },
+    { type: "text", text: "Tin nhắn 3" },
+  ];
+
+  const request: SendMessageSequenceRequest = {
+    accessToken,
+    userId,
+    messages,
+    defaultDelay: 2000, // Delay 2 giây giữa các tin nhắn
+  };
+
+  try {
+    const result = await consultationService.sendMessageSequence(request);
+    console.log("Kết quả:", result);
+  } catch (error) {
+    console.error("Lỗi:", error);
+  }
+}
+
+// Export các function để sử dụng
+export {
+  sendMessageSequenceExample,
+  sendSimpleTextSequence,
+  sendSequenceWithDefaultDelay,
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warriorteam/redai-zalo-sdk",
-  "version": "1.17.5",
-  "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account, ZNS, Consultation Service, Group Messaging, Social APIs, and Enhanced Article Management with Auto-Pagination",
+  "version": "1.19.0",
+  "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account, ZNS, Consultation Service, Group Messaging with List APIs, Social APIs, Enhanced Article Management, and Message Sequence APIs with Real-time Tracking",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -33,7 +33,20 @@
     "article-management",
     "auto-pagination",
     "bulk-fetch",
-    "progress-tracking"
+    "progress-tracking",
+    "message-sequence",
+    "bulk-messaging",
+    "marketing-automation",
+    "real-time-tracking",
+    "callback-tracking",
+    "multiple-users",
+    "campaign-management",
+    "group-messaging",
+    "group-message-list",
+    "bulk-group-messaging",
+    "group-notifications",
+    "team-communication",
+    "group-automation"
   ],
   "author": "RedAI Team",
   "license": "MIT",