@warriorteam/redai-zalo-sdk 1.17.5 → 1.19.0

package/CHANGELOG.md

@@ -5,6 +5,167 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.19.0] - 2025-08-29
+
+### 🚀 NEW FEATURES
+
+#### Group Message List APIs - Gửi Danh Sách Tin Nhắn Group
+- **ADDED**: `sendMessageListToGroup()` - Gửi danh sách tin nhắn tới 1 group với delay tùy chỉnh
+- **ADDED**: `sendMessageListToMultipleGroups()` - Gửi danh sách tin nhắn tới nhiều groups cùng lúc
+- **SUPPORT**: Hỗ trợ đầy đủ 5 loại tin nhắn group: text, image, file, sticker, mention
+- **FLEXIBLE**: Delay riêng cho từng tin nhắn + delay giữa groups để tránh rate limit
+- **SMART**: Tự động loại bỏ group IDs trùng lặp và validation đầy đủ
+
+#### Real-time Progress Tracking cho Groups
+- **CALLBACK**: `onProgress` callback để tracking real-time từng tin nhắn và group
+- **DETAILED**: Thống kê chi tiết thành công/thất bại cho từng tin nhắn và group
+- **ISOLATION**: Error của 1 tin nhắn/group không ảnh hưởng phần còn lại
+- **METRICS**: Tracking thời gian thực hiện, success rate, và message statistics
+
+#### Advanced Group Messaging Features
+- **MENTION**: Hỗ trợ mention members với offset và length chính xác
+- **CAPTION**: Image messages với caption tối đa 2000 ký tự
+- **FILE**: File attachments với token từ upload API
+- **SEQUENTIAL**: Gửi tuần tự để đảm bảo thứ tự và tránh rate limit
+
+### 📊 NEW INTERFACES
+
+#### Group Message List Types
+- **ADDED**: `GroupMessageItem` - Interface cho từng tin nhắn trong danh sách
+- **ADDED**: `SendMessageListToGroupRequest` - Request cho single group
+- **ADDED**: `SendMessageListToGroupResponse` - Response với detailed results
+- **ADDED**: `SendMessageListToMultipleGroupsRequest` - Request cho multiple groups
+- **ADDED**: `SendMessageListToMultipleGroupsResponse` - Response với group statistics
+- **ADDED**: `GroupMessageProgressInfo` - Interface cho message progress tracking
+- **ADDED**: `MultipleGroupsProgressInfo` - Interface cho multiple groups progress tracking
+
+### 📚 DOCUMENTATION & EXAMPLES
+
+#### New Documentation
+- **ADDED**: `docs/group-message-list-api.md` - Comprehensive guide cho Group Message List APIs
+- **UPDATED**: Hướng dẫn chi tiết từng loại tin nhắn group và use cases
+- **ADDED**: So sánh API cũ vs mới với feature comparison table
+
+#### New Examples
+- **ADDED**: `examples/group-message-list.ts` - Ví dụ gửi danh sách tin nhắn group
+- **INCLUDED**: System notifications, marketing campaigns, meeting notifications examples
+- **DEMO**: Mention messages, image captions, file attachments usage
+
+### 🎯 USE CASES
+
+#### System Administration
+- **MAINTENANCE**: Thông báo bảo trì hệ thống tới tất cả groups
+- **ALERTS**: Emergency alerts với hình ảnh và file đính kèm
+- **UPDATES**: System updates với mention admins
+
+#### Marketing & Business
+- **CAMPAIGNS**: Flash sales, khuyến mãi tới customer groups
+- **PROMOTIONS**: Product launches với hình ảnh và stickers
+- **ANNOUNCEMENTS**: Company announcements với professional formatting
+
+#### Team Communication
+- **MEETINGS**: Meeting notifications với mention participants
+- **PROJECTS**: Project updates tới multiple team groups
+- **REPORTS**: Regular reports với file attachments
+
+### 🔧 TECHNICAL IMPROVEMENTS
+
+#### Enhanced Error Handling
+- **ROBUST**: Comprehensive error handling cho từng tin nhắn và group
+- **CONTINUE**: Tiếp tục gửi khi gặp lỗi thay vì dừng toàn bộ process
+- **DETAILED**: Error messages chi tiết với context information
+- **ISOLATION**: Error isolation giữa tin nhắn và giữa groups
+
+#### Performance Optimizations
+- **SEQUENTIAL**: Sequential processing để tránh overwhelming Zalo servers
+- **MEMORY**: Optimized memory usage cho large group lists
+- **RATE-LIMIT**: Built-in rate limiting protection với configurable delays
+- **TIMEOUT**: Proper timeout handling và cleanup
+
+#### Type Safety & Validation
+- **TYPESCRIPT**: Full TypeScript support với strict typing
+- **VALIDATION**: Runtime validation cho tất cả input parameters
+- **INTELLISENSE**: Complete IDE support với detailed JSDoc comments
+- **CONSTRAINTS**: Proper validation cho message constraints (text length, etc.)
+
+## [1.18.0] - 2025-08-29
+
+### 🚀 NEW FEATURES
+
+#### Message Sequence APIs - Gửi Chuỗi Tin Nhắn Tự Động
+- **ADDED**: `sendMessageSequence()` - Gửi chuỗi tin nhắn tư vấn với delay tùy chỉnh
+- **ADDED**: `sendMessageSequenceToMultipleUsers()` - Gửi chuỗi tin nhắn tới nhiều users cùng lúc
+- **SUPPORT**: Hỗ trợ đầy đủ 6 loại tin nhắn: text, image, gif, file, sticker, request_user_info
+- **FLEXIBLE**: Delay riêng cho từng tin nhắn + delay mặc định cho toàn bộ chuỗi
+- **SMART**: Tự động loại bỏ user IDs trùng lặp và validation đầy đủ
+
+#### Real-time Progress Tracking
+- **CALLBACK**: `onProgress` callback để tracking real-time từng user
+- **DETAILED**: Thống kê chi tiết thành công/thất bại cho từng tin nhắn và user
+- **ISOLATION**: Error của 1 user không ảnh hưởng đến users khác
+- **METRICS**: Tracking thời gian thực hiện, success rate, và message statistics
+
+#### Rate Limiting Protection
+- **PROTECTION**: `delayBetweenUsers` để tránh hit rate limit của Zalo
+- **SEQUENTIAL**: Gửi tuần tự từng user để đảm bảo stability
+- **CONFIGURABLE**: Delay linh hoạt theo từng use case
+
+### 📊 NEW INTERFACES
+
+#### Message Sequence Types
+- **ADDED**: `MessageItem` - Interface cho từng tin nhắn trong chuỗi
+- **ADDED**: `SendMessageSequenceRequest` - Request cho single user
+- **ADDED**: `SendMessageSequenceResponse` - Response với detailed results
+- **ADDED**: `SendMessageSequenceToMultipleUsersRequest` - Request cho multiple users
+- **ADDED**: `SendMessageSequenceToMultipleUsersResponse` - Response với user statistics
+- **ADDED**: `UserProgressInfo` - Interface cho progress tracking callback
+
+### 📚 DOCUMENTATION & EXAMPLES
+
+#### New Documentation
+- **ADDED**: `docs/message-sequence-api.md` - Comprehensive guide cho Message Sequence APIs
+- **UPDATED**: Hướng dẫn chi tiết từng loại tin nhắn và use cases
+- **ADDED**: So sánh API đơn user vs nhiều users với bảng feature comparison
+
+#### New Examples
+- **ADDED**: `examples/send-message-sequence.ts` - Ví dụ gửi chuỗi tin nhắn cho 1 user
+- **ADDED**: `examples/send-message-sequence-multiple-users.ts` - Ví dụ gửi cho nhiều users
+- **INCLUDED**: Marketing campaigns, customer support, VIP customer care examples
+
+### 🎯 USE CASES
+
+#### Marketing & Campaigns
+- **CAMPAIGN**: Gửi chuỗi tin nhắn marketing tới danh sách khách hàng
+- **PROMOTION**: Flash sales, khuyến mãi với hình ảnh và call-to-action
+- **TRACKING**: Real-time tracking delivery success rate
+
+#### Customer Support
+- **NOTIFICATION**: Thông báo hệ thống, bảo trì tới tất cả users
+- **SUPPORT**: Gửi hướng dẫn, tài liệu hỗ trợ với file attachments
+- **CARE**: Chăm sóc khách hàng VIP với tin nhắn cá nhân hóa
+
+#### Business Automation
+- **ONBOARDING**: Chuỗi tin nhắn chào mừng khách hàng mới
+- **FOLLOW-UP**: Theo dõi sau bán hàng với stickers và images
+- **SURVEY**: Thu thập feedback với request user info messages
+
+### 🔧 TECHNICAL IMPROVEMENTS
+
+#### Error Handling
+- **ROBUST**: Comprehensive error handling cho từng tin nhắn và user
+- **CONTINUE**: Tiếp tục gửi khi gặp lỗi thay vì dừng toàn bộ process
+- **DETAILED**: Error messages chi tiết với context information
+
+#### Performance
+- **EFFICIENT**: Sequential processing để tránh overwhelming Zalo servers
+- **MEMORY**: Optimized memory usage cho large user lists
+- **TIMEOUT**: Proper timeout handling và cleanup
+
+#### Type Safety
+- **TYPESCRIPT**: Full TypeScript support với strict typing
+- **VALIDATION**: Runtime validation cho tất cả input parameters
+- **INTELLISENSE**: Complete IDE support với detailed JSDoc comments
+
 ## [1.17.2] - 2025-08-29
 
 ### 🐛 BUG FIXES

package/dist/services/consultation.service.d.ts

@@ -1,5 +1,152 @@
 import { ZaloClient } from "../clients/zalo-client";
 import { MessageRecipient, SendMessageResponse, TextMessage, ConsultationQuoteMessage } from "../types/message";
+/**
+ * Interface cho từng tin nhắn trong chuỗi tin nhắn
+ */
+export interface MessageItem {
+    /** Loại tin nhắn */
+    type: "text" | "image" | "gif" | "file" | "sticker" | "request_user_info";
+    /** Nội dung tin nhắn (cho text message) */
+    text?: string;
+    /** URL hình ảnh (cho image/gif message) */
+    imageUrl?: string;
+    /** URL GIF (cho gif message) */
+    gifUrl?: string;
+    /** Chiều rộng GIF (bắt buộc cho gif) */
+    width?: number;
+    /** Chiều cao GIF (bắt buộc cho gif) */
+    height?: number;
+    /** Token file (cho file message) */
+    fileToken?: string;
+    /** Attachment ID (cho image/sticker message) */
+    attachmentId?: string;
+    /** Sticker attachment ID (cho sticker message) */
+    stickerAttachmentId?: string;
+    /** Tiêu đề (cho request_user_info message) */
+    title?: string;
+    /** Tiêu đề phụ (cho request_user_info message) */
+    subtitle?: string;
+    /** Delay sau khi gửi tin nhắn này (milliseconds) */
+    delay?: number;
+}
+/**
+ * Interface cho request gửi chuỗi tin nhắn
+ */
+export interface SendMessageSequenceRequest {
+    /** Access token của Official Account */
+    accessToken: string;
+    /** ID người nhận */
+    userId: string;
+    /** Danh sách tin nhắn */
+    messages: MessageItem[];
+    /** Delay mặc định giữa các tin nhắn (milliseconds) - nếu không có delay riêng */
+    defaultDelay?: number;
+}
+/**
+ * Interface cho response gửi chuỗi tin nhắn
+ */
+export interface SendMessageSequenceResponse {
+    /** Tổng số tin nhắn đã gửi thành công */
+    successCount: number;
+    /** Tổng số tin nhắn thất bại */
+    failureCount: number;
+    /** Chi tiết kết quả từng tin nhắn */
+    results: Array<{
+        /** Index của tin nhắn trong danh sách */
+        index: number;
+        /** Loại tin nhắn */
+        type: string;
+        /** Trạng thái gửi */
+        success: boolean;
+        /** Thông tin response nếu thành công */
+        response?: SendMessageResponse;
+        /** Thông tin lỗi nếu thất bại */
+        error?: string;
+        /** Thời gian gửi */
+        timestamp: number;
+    }>;
+    /** Tổng thời gian thực hiện (milliseconds) */
+    totalDuration: number;
+}
+/**
+ * Interface cho request gửi chuỗi tin nhắn tới nhiều users
+ */
+export interface SendMessageSequenceToMultipleUsersRequest {
+    /** Access token của Official Account */
+    accessToken: string;
+    /** Danh sách user IDs */
+    userIds: string[];
+    /** Danh sách tin nhắn */
+    messages: MessageItem[];
+    /** Delay mặc định giữa các tin nhắn (milliseconds) */
+    defaultDelay?: number;
+    /** Delay giữa các user (milliseconds) để tránh rate limit */
+    delayBetweenUsers?: number;
+    /** Callback function để tracking tiến trình */
+    onProgress?: (progress: UserProgressInfo) => void;
+}
+/**
+ * Interface cho thông tin tiến trình từng user
+ */
+export interface UserProgressInfo {
+    /** User ID hiện tại */
+    userId: string;
+    /** Index của user trong danh sách (bắt đầu từ 0) */
+    userIndex: number;
+    /** Tổng số users */
+    totalUsers: number;
+    /** Trạng thái: 'started' | 'completed' | 'failed' */
+    status: 'started' | 'completed' | 'failed';
+    /** Kết quả gửi tin nhắn (nếu đã hoàn thành) */
+    result?: SendMessageSequenceResponse;
+    /** Thông tin lỗi (nếu thất bại) */
+    error?: string;
+    /** Thời gian bắt đầu */
+    startTime: number;
+    /** Thời gian kết thúc (nếu đã hoàn thành) */
+    endTime?: number;
+}
+/**
+ * Interface cho response gửi chuỗi tin nhắn tới nhiều users
+ */
+export interface SendMessageSequenceToMultipleUsersResponse {
+    /** Tổng số users */
+    totalUsers: number;
+    /** Số users gửi thành công */
+    successfulUsers: number;
+    /** Số users gửi thất bại */
+    failedUsers: number;
+    /** Chi tiết kết quả từng user */
+    userResults: Array<{
+        /** User ID */
+        userId: string;
+        /** Index của user trong danh sách */
+        userIndex: number;
+        /** Trạng thái gửi cho user này */
+        success: boolean;
+        /** Kết quả chi tiết gửi tin nhắn */
+        messageSequenceResult?: SendMessageSequenceResponse;
+        /** Thông tin lỗi nếu thất bại */
+        error?: string;
+        /** Thời gian bắt đầu gửi */
+        startTime: number;
+        /** Thời gian kết thúc */
+        endTime: number;
+        /** Thời gian thực hiện (milliseconds) */
+        duration: number;
+    }>;
+    /** Tổng thời gian thực hiện (milliseconds) */
+    totalDuration: number;
+    /** Thống kê tin nhắn tổng cộng */
+    messageStats: {
+        /** Tổng số tin nhắn đã gửi thành công */
+        totalSuccessfulMessages: number;
+        /** Tổng số tin nhắn thất bại */
+        totalFailedMessages: number;
+        /** Tổng số tin nhắn */
+        totalMessages: number;
+    };
+}
 /**
  * Service xử lý các API tin nhắn tư vấn của Zalo Official Account
  *
@@ -133,5 +280,25 @@ export declare class ConsultationService {
      * Xem video hướng dẫn: https://vimeo.com/649330161
      */
     sendStickerMessage(accessToken: string, userId: string, stickerAttachmentId: string): Promise<SendMessageResponse>;
+    /**
+     * Gửi chuỗi tin nhắn tư vấn với delay tùy chỉnh
+     * Hỗ trợ tất cả các loại tin nhắn: text, image, gif, file, sticker, request_user_info
+     *
+     * @param request Thông tin request gửi chuỗi tin nhắn
+     * @returns Kết quả gửi từng tin nhắn
+     */
+    sendMessageSequence(request: SendMessageSequenceRequest): Promise<SendMessageSequenceResponse>;
+    /**
+     * Gửi chuỗi tin nhắn tư vấn tới nhiều users với callback tracking
+     *
+     * @param request Thông tin request gửi chuỗi tin nhắn tới nhiều users
+     * @returns Kết quả gửi tin nhắn cho tất cả users
+     */
+    sendMessageSequenceToMultipleUsers(request: SendMessageSequenceToMultipleUsersRequest): Promise<SendMessageSequenceToMultipleUsersResponse>;
+    /**
+     * Utility method để sleep/delay
+     * @param ms Thời gian delay tính bằng milliseconds
+     */
+    private sleep;
 }
 //# sourceMappingURL=consultation.service.d.ts.map

package/dist/services/consultation.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consultation.service.d.ts","sourceRoot":"","sources":["../../src/services/consultation.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAE5C,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACU,eAAe,CAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAoD/B;;;;;;;OAOG;IACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC;IA6D/B;;;;;;OAMG;IACI,kBAAkB,CACvB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,GACpB,wBAAwB;IAW3B;;;;;;;;;;OAUG;IACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAiE/B;;;;;;;;;;OAUG;IACU,uBAAuB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAiE/B;;;;;;;;;;;;OAYG;IACU,cAAc,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAqE/B;;;;;;;;;;;OAWG;IACU,eAAe,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAiD/B;;;;;;;;;;;OAWG;IACU,0BAA0B,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC;IAyE/B;;;;;;;;;;;;OAYG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,mBAAmB,CAAC;CAwDhC"}
+{"version":3,"file":"consultation.service.d.ts","sourceRoot":"","sources":["../../src/services/consultation.service.ts"],"names":[],"mappings":"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"}

package/dist/services/consultation.service.js

@@ -484,6 +484,280 @@ class ConsultationService {
             throw new common_1.ZaloSDKError(`Failed to send consultation sticker message: ${error.message}`, -1, error);
         }
     }
+    /**
+     * Gửi chuỗi tin nhắn tư vấn với delay tùy chỉnh
+     * Hỗ trợ tất cả các loại tin nhắn: text, image, gif, file, sticker, request_user_info
+     *
+     * @param request Thông tin request gửi chuỗi tin nhắn
+     * @returns Kết quả gửi từng tin nhắn
+     */
+    async sendMessageSequence(request) {
+        const startTime = Date.now();
+        const results = [];
+        let successCount = 0;
+        let failureCount = 0;
+        try {
+            // Validate input
+            if (!request.accessToken || request.accessToken.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Access token không được để trống", -1);
+            }
+            if (!request.userId || request.userId.trim().length === 0) {
+                throw new common_1.ZaloSDKError("User ID không được để trống", -1);
+            }
+            if (!request.messages || request.messages.length === 0) {
+                throw new common_1.ZaloSDKError("Danh sách tin nhắn không được để trống", -1);
+            }
+            // Gửi từng tin nhắn theo thứ tự
+            for (let i = 0; i < request.messages.length; i++) {
+                const message = request.messages[i];
+                const messageResult = {
+                    index: i,
+                    type: message.type,
+                    success: false,
+                    timestamp: Date.now(),
+                };
+                try {
+                    let response;
+                    // Gửi tin nhắn theo loại
+                    switch (message.type) {
+                        case "text":
+                            if (!message.text) {
+                                throw new Error("Text không được để trống cho text message");
+                            }
+                            response = await this.sendTextMessage(request.accessToken, { user_id: request.userId }, { type: "text", text: message.text });
+                            break;
+                        case "image":
+                            if (message.imageUrl) {
+                                response = await this.sendImageMessage(request.accessToken, request.userId, message.imageUrl, message.text);
+                            }
+                            else if (message.attachmentId) {
+                                response = await this.sendImageByAttachmentId(request.accessToken, request.userId, message.attachmentId, message.text);
+                            }
+                            else {
+                                throw new Error("imageUrl hoặc attachmentId là bắt buộc cho image message");
+                            }
+                            break;
+                        case "gif":
+                            if (!message.gifUrl || !message.width || !message.height) {
+                                throw new Error("gifUrl, width và height là bắt buộc cho gif message");
+                            }
+                            response = await this.sendGifMessage(request.accessToken, request.userId, message.gifUrl, message.width, message.height, message.text);
+                            break;
+                        case "file":
+                            if (!message.fileToken) {
+                                throw new Error("fileToken là bắt buộc cho file message");
+                            }
+                            response = await this.sendFileMessage(request.accessToken, request.userId, message.fileToken);
+                            break;
+                        case "sticker":
+                            if (!message.stickerAttachmentId) {
+                                throw new Error("stickerAttachmentId là bắt buộc cho sticker message");
+                            }
+                            response = await this.sendStickerMessage(request.accessToken, request.userId, message.stickerAttachmentId);
+                            break;
+                        case "request_user_info":
+                            if (!message.title || !message.subtitle || !message.imageUrl) {
+                                throw new Error("title, subtitle và imageUrl là bắt buộc cho request_user_info message");
+                            }
+                            response = await this.sendRequestUserInfoMessage(request.accessToken, request.userId, message.title, message.subtitle, message.imageUrl);
+                            break;
+                        default:
+                            throw new Error(`Loại tin nhắn không được hỗ trợ: ${message.type}`);
+                    }
+                    // Ghi nhận thành công
+                    messageResult.success = true;
+                    messageResult.response = response;
+                    successCount++;
+                }
+                catch (error) {
+                    // Ghi nhận thất bại
+                    messageResult.success = false;
+                    messageResult.error = error instanceof Error ? error.message : String(error);
+                    failureCount++;
+                }
+                results.push(messageResult);
+                // Delay trước khi gửi tin nhắn tiếp theo (trừ tin nhắn cuối cùng)
+                if (i < request.messages.length - 1) {
+                    const delayTime = message.delay ?? request.defaultDelay ?? 0;
+                    if (delayTime > 0) {
+                        await this.sleep(delayTime);
+                    }
+                }
+            }
+            const totalDuration = Date.now() - startTime;
+            return {
+                successCount,
+                failureCount,
+                results,
+                totalDuration,
+            };
+        }
+        catch (error) {
+            // Lỗi tổng quát
+            const totalDuration = Date.now() - startTime;
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send message sequence: ${error.message}`, -1, {
+                successCount,
+                failureCount,
+                results,
+                totalDuration,
+            });
+        }
+    }
+    /**
+     * Gửi chuỗi tin nhắn tư vấn tới nhiều users với callback tracking
+     *
+     * @param request Thông tin request gửi chuỗi tin nhắn tới nhiều users
+     * @returns Kết quả gửi tin nhắn cho tất cả users
+     */
+    async sendMessageSequenceToMultipleUsers(request) {
+        const startTime = Date.now();
+        const userResults = [];
+        let successfulUsers = 0;
+        let failedUsers = 0;
+        let totalSuccessfulMessages = 0;
+        let totalFailedMessages = 0;
+        try {
+            // Validate input
+            if (!request.accessToken || request.accessToken.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Access token không được để trống", -1);
+            }
+            if (!request.userIds || request.userIds.length === 0) {
+                throw new common_1.ZaloSDKError("Danh sách user IDs không được để trống", -1);
+            }
+            if (!request.messages || request.messages.length === 0) {
+                throw new common_1.ZaloSDKError("Danh sách tin nhắn không được để trống", -1);
+            }
+            // Loại bỏ user IDs trùng lặp và rỗng
+            const uniqueUserIds = [...new Set(request.userIds.filter(id => id && id.trim().length > 0))];
+            if (uniqueUserIds.length === 0) {
+                throw new common_1.ZaloSDKError("Không có user ID hợp lệ nào", -1);
+            }
+            // Gửi tin nhắn cho từng user tuần tự
+            for (let i = 0; i < uniqueUserIds.length; i++) {
+                const userId = uniqueUserIds[i];
+                const userStartTime = Date.now();
+                // Callback: Bắt đầu gửi cho user
+                if (request.onProgress) {
+                    request.onProgress({
+                        userId,
+                        userIndex: i,
+                        totalUsers: uniqueUserIds.length,
+                        status: 'started',
+                        startTime: userStartTime,
+                    });
+                }
+                const userResult = {
+                    userId,
+                    userIndex: i,
+                    success: false,
+                    startTime: userStartTime,
+                    endTime: 0,
+                    duration: 0,
+                };
+                try {
+                    // Gửi chuỗi tin nhắn cho user này
+                    const messageSequenceResult = await this.sendMessageSequence({
+                        accessToken: request.accessToken,
+                        userId,
+                        messages: request.messages,
+                        defaultDelay: request.defaultDelay,
+                    });
+                    // Ghi nhận thành công
+                    const userEndTime = Date.now();
+                    userResult.success = true;
+                    userResult.messageSequenceResult = messageSequenceResult;
+                    userResult.endTime = userEndTime;
+                    userResult.duration = userEndTime - userStartTime;
+                    successfulUsers++;
+                    totalSuccessfulMessages += messageSequenceResult.successCount;
+                    totalFailedMessages += messageSequenceResult.failureCount;
+                    // Callback: Hoàn thành thành công
+                    if (request.onProgress) {
+                        request.onProgress({
+                            userId,
+                            userIndex: i,
+                            totalUsers: uniqueUserIds.length,
+                            status: 'completed',
+                            result: messageSequenceResult,
+                            startTime: userStartTime,
+                            endTime: userEndTime,
+                        });
+                    }
+                }
+                catch (error) {
+                    // Ghi nhận thất bại
+                    const userEndTime = Date.now();
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    userResult.success = false;
+                    userResult.error = errorMessage;
+                    userResult.endTime = userEndTime;
+                    userResult.duration = userEndTime - userStartTime;
+                    failedUsers++;
+                    // Với user thất bại, coi như tất cả tin nhắn đều thất bại
+                    totalFailedMessages += request.messages.length;
+                    // Callback: Thất bại
+                    if (request.onProgress) {
+                        request.onProgress({
+                            userId,
+                            userIndex: i,
+                            totalUsers: uniqueUserIds.length,
+                            status: 'failed',
+                            error: errorMessage,
+                            startTime: userStartTime,
+                            endTime: userEndTime,
+                        });
+                    }
+                }
+                userResults.push(userResult);
+                // Delay giữa các user (trừ user cuối cùng)
+                if (i < uniqueUserIds.length - 1 && request.delayBetweenUsers && request.delayBetweenUsers > 0) {
+                    await this.sleep(request.delayBetweenUsers);
+                }
+            }
+            const totalDuration = Date.now() - startTime;
+            const totalMessages = uniqueUserIds.length * request.messages.length;
+            return {
+                totalUsers: uniqueUserIds.length,
+                successfulUsers,
+                failedUsers,
+                userResults,
+                totalDuration,
+                messageStats: {
+                    totalSuccessfulMessages,
+                    totalFailedMessages,
+                    totalMessages,
+                },
+            };
+        }
+        catch (error) {
+            const totalDuration = Date.now() - startTime;
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send message sequence to multiple users: ${error.message}`, -1, {
+                totalUsers: request.userIds?.length || 0,
+                successfulUsers,
+                failedUsers,
+                userResults,
+                totalDuration,
+                messageStats: {
+                    totalSuccessfulMessages,
+                    totalFailedMessages,
+                    totalMessages: (request.userIds?.length || 0) * (request.messages?.length || 0),
+                },
+            });
+        }
+    }
+    /**
+     * Utility method để sleep/delay
+     * @param ms Thời gian delay tính bằng milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
 }
 exports.ConsultationService = ConsultationService;
 //# sourceMappingURL=consultation.service.js.map