@warriorteam/redai-zalo-sdk 1.26.1 → 1.27.0

package/examples/consultation-service-example.ts

@@ -1,390 +0,0 @@
-/**
- * Ví dụ sử dụng ConsultationService - Dịch vụ tin nhắn tư vấn
- * 
- * Ví dụ này minh họa cách sử dụng ConsultationService để:
- * - Gửi tin nhắn tư vấn văn bản
- * - Gửi hình ảnh hỗ trợ
- * - Gửi file hướng dẫn
- * - Xử lý lỗi và retry
- * - Tích hợp với webhook
- */
-
-import { ZaloSDK, ZaloSDKError, SendMessageResponse } from "../src/index";
-
-// Cấu hình SDK
-const zalo = new ZaloSDK({
-  appId: "your-app-id",
-  appSecret: "your-app-secret",
-  debug: true
-});
-
-// Access token của OA (lấy từ quá trình authentication)
-const ACCESS_TOKEN = "your-oa-access-token";
-
-/**
- * Ví dụ 1: Gửi tin nhắn tư vấn cơ bản
- */
-async function basicConsultationExample() {
-  console.log("=== Ví dụ 1: Tin nhắn tư vấn cơ bản ===");
-  
-  try {
-    // Gửi tin nhắn văn bản tư vấn
-    const response = await zalo.consultation.sendTextMessage(
-      ACCESS_TOKEN,
-      { user_id: "user-id-here" },
-      {
-        type: "text",
-        text: "Xin chào! Cảm ơn bạn đã liên hệ với chúng tôi. Tôi có thể hỗ trợ gì cho bạn hôm nay?"
-      }
-    );
-
-    console.log("✅ Gửi tin nhắn thành công!");
-    console.log("Message ID:", response.message_id);
-    console.log("User ID:", response.user_id);
-    
-    if (response.quota) {
-      console.log("Quota còn lại:", response.quota.remain);
-    }
-
-  } catch (error) {
-    if (error instanceof ZaloSDKError) {
-      console.error("❌ Lỗi Zalo API:", error.message);
-      console.error("Mã lỗi:", error.code);
-    } else {
-      console.error("❌ Lỗi không xác định:", error);
-    }
-  }
-}
-
-/**
- * Ví dụ 2: Gửi hình ảnh hỗ trợ
- */
-async function imageConsultationExample() {
-  console.log("\n=== Ví dụ 2: Gửi hình ảnh hỗ trợ ===");
-  
-  try {
-    const response = await zalo.consultation.sendImageMessage(
-      ACCESS_TOKEN,
-      { user_id: "user-id-here" },
-      {
-        type: "image",
-        attachment: {
-          type: "image",
-          payload: {
-            url: "https://example.com/support-guide.jpg"
-          }
-        }
-      }
-    );
-
-    console.log("✅ Gửi hình ảnh hỗ trợ thành công!");
-    console.log("Message ID:", response.message_id);
-
-  } catch (error) {
-    console.error("❌ Lỗi gửi hình ảnh:", error);
-  }
-}
-
-/**
- * Ví dụ 3: Gửi file hướng dẫn
- */
-async function fileConsultationExample() {
-  console.log("\n=== Ví dụ 3: Gửi file hướng dẫn ===");
-  
-  try {
-    const response = await zalo.consultation.sendFileMessage(
-      ACCESS_TOKEN,
-      { user_id: "user-id-here" },
-      {
-        type: "file",
-        url: "https://example.com/user-manual.pdf",
-        filename: "Hướng dẫn sử dụng.pdf",
-        attachment: {
-          type: "file",
-          payload: {
-            url: "https://example.com/user-manual.pdf"
-          }
-        }
-      }
-    );
-
-    console.log("✅ Gửi file hướng dẫn thành công!");
-    console.log("Message ID:", response.message_id);
-
-  } catch (error) {
-    console.error("❌ Lỗi gửi file:", error);
-  }
-}
-
-/**
- * Ví dụ 4: Hệ thống hỗ trợ khách hàng thông minh
- */
-class SmartCustomerSupport {
-  private zalo: ZaloSDK;
-  private accessToken: string;
-
-  constructor(zalo: ZaloSDK, accessToken: string) {
-    this.zalo = zalo;
-    this.accessToken = accessToken;
-  }
-
-  /**
-   * Xử lý câu hỏi của khách hàng
-   */
-  async handleCustomerQuestion(userId: string, question: string) {
-    console.log(`\n📞 Xử lý câu hỏi từ user ${userId}: "${question}"`);
-
-    try {
-      // Phân tích câu hỏi và tạo phản hồi
-      const response = this.analyzeQuestion(question);
-      
-      // Gửi tin nhắn phản hồi
-      await this.zalo.consultation.sendTextMessage(
-        this.accessToken,
-        { user_id: userId },
-        {
-          type: "text",
-          text: response.text
-        }
-      );
-
-      // Gửi thêm tài liệu hỗ trợ nếu cần
-      if (response.needsDocument) {
-        await this.sendSupportDocument(userId, response.documentType);
-      }
-
-      console.log("✅ Đã phản hồi khách hàng thành công!");
-
-    } catch (error) {
-      console.error("❌ Lỗi xử lý câu hỏi khách hàng:", error);
-      
-      // Gửi tin nhắn lỗi cho khách hàng
-      await this.sendErrorMessage(userId);
-    }
-  }
-
-  /**
-   * Phân tích câu hỏi và tạo phản hồi
-   */
-  private analyzeQuestion(question: string) {
-    const lowerQuestion = question.toLowerCase();
-
-    if (lowerQuestion.includes("đăng nhập") || lowerQuestion.includes("login")) {
-      return {
-        text: "Để đăng nhập vào hệ thống, bạn vui lòng:\n1. Truy cập trang đăng nhập\n2. Nhập email và mật khẩu\n3. Nhấn 'Đăng nhập'\n\nNếu quên mật khẩu, bạn có thể sử dụng chức năng 'Quên mật khẩu'.",
-        needsDocument: true,
-        documentType: "login_guide"
-      };
-    }
-
-    if (lowerQuestion.includes("thanh toán") || lowerQuestion.includes("payment")) {
-      return {
-        text: "Chúng tôi hỗ trợ các phương thức thanh toán sau:\n• Thẻ tín dụng/ghi nợ\n• Ví điện tử (MoMo, ZaloPay)\n• Chuyển khoản ngân hàng\n• Thanh toán khi nhận hàng (COD)\n\nBạn cần hỗ trợ về phương thức nào?",
-        needsDocument: true,
-        documentType: "payment_guide"
-      };
-    }
-
-    if (lowerQuestion.includes("giao hàng") || lowerQuestion.includes("shipping")) {
-      return {
-        text: "Thông tin về giao hàng:\n• Nội thành: 1-2 ngày\n• Ngoại thành: 2-3 ngày\n• Tỉnh khác: 3-5 ngày\n\nPhí ship được tính theo khoảng cách và trọng lượng đơn hàng.",
-        needsDocument: false,
-        documentType: null
-      };
-    }
-
-    // Phản hồi mặc định
-    return {
-      text: "Cảm ơn bạn đã liên hệ! Tôi đã ghi nhận câu hỏi của bạn. Đội ngũ hỗ trợ sẽ phản hồi trong vòng 24 giờ.\n\nCác vấn đề phổ biến:\n• Đăng nhập\n• Thanh toán\n• Giao hàng\n• Đổi trả\n\nBạn có thể hỏi cụ thể về các vấn đề này để được hỗ trợ nhanh hơn.",
-      needsDocument: false,
-      documentType: null
-    };
-  }
-
-  /**
-   * Gửi tài liệu hỗ trợ
-   */
-  private async sendSupportDocument(userId: string, documentType: string) {
-    const documents = {
-      login_guide: {
-        url: "https://example.com/guides/login-guide.pdf",
-        filename: "Hướng dẫn đăng nhập.pdf"
-      },
-      payment_guide: {
-        url: "https://example.com/guides/payment-guide.pdf", 
-        filename: "Hướng dẫn thanh toán.pdf"
-      }
-    };
-
-    const doc = documents[documentType as keyof typeof documents];
-    if (!doc) return;
-
-    await this.zalo.consultation.sendFileMessage(
-      this.accessToken,
-      { user_id: userId },
-      {
-        type: "file",
-        url: doc.url,
-        filename: doc.filename,
-        attachment: {
-          type: "file",
-          payload: {
-            url: doc.url
-          }
-        }
-      }
-    );
-  }
-
-  /**
-   * Gửi tin nhắn lỗi
-   */
-  private async sendErrorMessage(userId: string) {
-    try {
-      await this.zalo.consultation.sendTextMessage(
-        this.accessToken,
-        { user_id: userId },
-        {
-          type: "text",
-          text: "Xin lỗi, hiện tại hệ thống đang gặp sự cố. Vui lòng thử lại sau hoặc liên hệ hotline: 1900-xxxx để được hỗ trợ trực tiếp."
-        }
-      );
-    } catch (error) {
-      console.error("❌ Không thể gửi tin nhắn lỗi:", error);
-    }
-  }
-}
-
-/**
- * Ví dụ 5: Retry mechanism
- */
-async function sendWithRetry(
-  userId: string, 
-  message: string, 
-  maxRetries: number = 3
-): Promise<SendMessageResponse | null> {
-  console.log(`\n🔄 Gửi tin nhắn với retry (tối đa ${maxRetries} lần)`);
-  
-  for (let attempt = 1; attempt <= maxRetries; attempt++) {
-    try {
-      console.log(`Lần thử ${attempt}/${maxRetries}`);
-      
-      const response = await zalo.consultation.sendTextMessage(
-        ACCESS_TOKEN,
-        { user_id: userId },
-        { type: "text", text: message }
-      );
-
-      console.log("✅ Gửi thành công!");
-      return response;
-
-    } catch (error) {
-      console.log(`❌ Lần thử ${attempt} thất bại:`, error instanceof ZaloSDKError ? error.message : error);
-      
-      if (attempt === maxRetries) {
-        console.log("❌ Đã thử hết số lần cho phép");
-        return null;
-      }
-
-      // Đợi trước khi thử lại (exponential backoff)
-      const delay = Math.pow(2, attempt) * 1000;
-      console.log(`⏳ Đợi ${delay}ms trước khi thử lại...`);
-      await new Promise(resolve => setTimeout(resolve, delay));
-    }
-  }
-
-  return null;
-}
-
-/**
- * Ví dụ 6: Tích hợp với webhook
- */
-function setupWebhookIntegration() {
-  console.log("\n🔗 Thiết lập tích hợp webhook");
-  
-  const customerSupport = new SmartCustomerSupport(zalo, ACCESS_TOKEN);
-
-  // Giả lập xử lý webhook event
-  const handleWebhookEvent = async (event: any) => {
-    console.log("📨 Nhận webhook event:", event.event_name);
-
-    switch (event.event_name) {
-      case "user_send_text":
-        const userId = event.sender.id;
-        const userMessage = event.message.text;
-        
-        // Kiểm tra xem có phải câu hỏi cần hỗ trợ không
-        if (userMessage.includes("help") || 
-            userMessage.includes("hỗ trợ") ||
-            userMessage.includes("support")) {
-          
-          await customerSupport.handleCustomerQuestion(userId, userMessage);
-        }
-        break;
-
-      case "user_send_sticker":
-        // Phản hồi sticker bằng tin nhắn thân thiện
-        await zalo.consultation.sendTextMessage(
-          ACCESS_TOKEN,
-          { user_id: event.sender.id },
-          {
-            type: "text", 
-            text: "Cảm ơn bạn! 😊 Tôi có thể hỗ trợ gì cho bạn không?"
-          }
-        );
-        break;
-
-      default:
-        console.log("Event không cần xử lý:", event.event_name);
-    }
-  };
-
-  return handleWebhookEvent;
-}
-
-/**
- * Chạy tất cả ví dụ
- */
-async function runAllExamples() {
-  console.log("🚀 Bắt đầu chạy các ví dụ ConsultationService\n");
-
-  // Ví dụ cơ bản
-  await basicConsultationExample();
-  await imageConsultationExample();
-  await fileConsultationExample();
-
-  // Ví dụ hệ thống hỗ trợ thông minh
-  const customerSupport = new SmartCustomerSupport(zalo, ACCESS_TOKEN);
-  await customerSupport.handleCustomerQuestion("user123", "Tôi không đăng nhập được");
-  await customerSupport.handleCustomerQuestion("user456", "Làm sao để thanh toán?");
-
-  // Ví dụ retry
-  await sendWithRetry("user789", "Tin nhắn test retry");
-
-  // Thiết lập webhook
-  const webhookHandler = setupWebhookIntegration();
-  
-  // Giả lập một số webhook events
-  await webhookHandler({
-    event_name: "user_send_text",
-    sender: { id: "user123" },
-    message: { text: "Tôi cần hỗ trợ về đăng nhập" }
-  });
-
-  console.log("\n✅ Hoàn thành tất cả ví dụ!");
-}
-
-// Chạy ví dụ nếu file được execute trực tiếp
-if (require.main === module) {
-  runAllExamples().catch(console.error);
-}
-
-export {
-  basicConsultationExample,
-  imageConsultationExample,
-  fileConsultationExample,
-  SmartCustomerSupport,
-  sendWithRetry,
-  setupWebhookIntegration,
-  runAllExamples
-};

package/examples/get-all-articles-example.ts

@@ -1,171 +0,0 @@
-/**
- * Example: How to use the enhanced getAllArticles and getAllArticlesCombined methods
- * 
- * This example demonstrates the new custom API methods that can fetch all articles
- * automatically by handling pagination internally.
- */
-
-import { ArticleService } from "../src/services/article.service";
-import { ZaloClient } from "../src/clients/zalo-client";
-
-// Initialize the services
-const zaloClient = new ZaloClient();
-const articleService = new ArticleService(zaloClient);
-
-// Your access token
-const ACCESS_TOKEN = "your-access-token-here";
-
-/**
- * Example 1: Get all normal articles with progress tracking
- */
-async function getAllNormalArticlesExample() {
-  console.log("=== Getting All Normal Articles ===");
-  
-  try {
-    const result = await articleService.getAllArticles(ACCESS_TOKEN, "normal", {
-      batchSize: 50,           // Fetch 50 articles per API call
-      maxArticles: 1000,       // Stop after 1000 articles (0 = no limit)
-      onProgress: (progress) => {
-        console.log(`📄 Batch ${progress.currentBatch}: ${progress.totalFetched} articles fetched, hasMore: ${progress.hasMore}`);
-      }
-    });
-
-    console.log(`✅ Completed! Total: ${result.totalFetched} normal articles in ${result.totalBatches} batches`);
-    console.log(`📊 Has more articles available: ${result.hasMore}`);
-    
-    // Access the articles
-    result.articles.forEach((article, index) => {
-      console.log(`${index + 1}. ${article.title} (ID: ${article.id})`);
-    });
-    
-    return result;
-  } catch (error) {
-    console.error("❌ Error getting normal articles:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 2: Get all video articles
- */
-async function getAllVideoArticlesExample() {
-  console.log("\n=== Getting All Video Articles ===");
-  
-  try {
-    const result = await articleService.getAllArticles(ACCESS_TOKEN, "video", {
-      batchSize: 30,           // Smaller batch size for videos
-      maxArticles: 500,        // Limit to 500 videos
-      onProgress: (progress) => {
-        console.log(`🎥 Video Batch ${progress.currentBatch}: ${progress.totalFetched} videos fetched`);
-      }
-    });
-
-    console.log(`✅ Completed! Total: ${result.totalFetched} video articles in ${result.totalBatches} batches`);
-    
-    return result;
-  } catch (error) {
-    console.error("❌ Error getting video articles:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 3: Get all articles (both normal and video) combined
- */
-async function getAllArticlesCombinedExample() {
-  console.log("\n=== Getting All Articles Combined ===");
-  
-  try {
-    const result = await articleService.getAllArticlesCombined(ACCESS_TOKEN, {
-      batchSize: 50,
-      maxArticlesPerType: 500,  // Max 500 per type (normal + video)
-      onProgress: (progress) => {
-        console.log(`📱 ${progress.type.toUpperCase()}: Batch ${progress.currentBatch}, Total: ${progress.totalFetched}`);
-      }
-    });
-
-    console.log(`✅ All articles fetched!`);
-    console.log(`📊 Total articles: ${result.totalFetched}`);
-    console.log(`📄 Normal articles: ${result.breakdown.normal.totalFetched}`);
-    console.log(`🎥 Video articles: ${result.breakdown.video.totalFetched}`);
-    console.log(`🔄 Total API calls: ${result.totalBatches}`);
-    
-    // You can access all articles combined
-    console.log(`\n📋 All Articles (${result.articles.length}):`);
-    result.articles.slice(0, 5).forEach((article, index) => {
-      console.log(`${index + 1}. [${article.type?.toUpperCase()}] ${article.title}`);
-    });
-    
-    if (result.articles.length > 5) {
-      console.log(`... and ${result.articles.length - 5} more articles`);
-    }
-    
-    return result;
-  } catch (error) {
-    console.error("❌ Error getting combined articles:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 4: Get unlimited articles (fetch everything)
- */
-async function getAllArticlesUnlimitedExample() {
-  console.log("\n=== Getting ALL Articles (No Limit) ===");
-  
-  try {
-    const result = await articleService.getAllArticles(ACCESS_TOKEN, "normal", {
-      batchSize: 100,          // Max batch size
-      maxArticles: 0,          // 0 = no limit, fetch everything
-      onProgress: (progress) => {
-        console.log(`🔄 Batch ${progress.currentBatch}: ${progress.totalFetched} articles...`);
-      }
-    });
-
-    console.log(`✅ Fetched EVERYTHING! Total: ${result.totalFetched} articles`);
-    console.log(`⚠️  Warning: This fetched all articles without limit!`);
-    
-    return result;
-  } catch (error) {
-    console.error("❌ Error getting unlimited articles:", error);
-    throw error;
-  }
-}
-
-/**
- * Main function to run all examples
- */
-async function runExamples() {
-  try {
-    // Example 1: Normal articles
-    await getAllNormalArticlesExample();
-    
-    // Example 2: Video articles  
-    await getAllVideoArticlesExample();
-    
-    // Example 3: Combined articles
-    await getAllArticlesCombinedExample();
-    
-    // Example 4: Unlimited (commented out for safety)
-    // await getAllArticlesUnlimitedExample();
-    
-    console.log("\n🎉 All examples completed successfully!");
-    
-  } catch (error) {
-    console.error("💥 Example failed:", error);
-  }
-}
-
-// Export for use in other files
-export {
-  getAllNormalArticlesExample,
-  getAllVideoArticlesExample,
-  getAllArticlesCombinedExample,
-  getAllArticlesUnlimitedExample,
-  runExamples
-};
-
-// Run examples if this file is executed directly
-if (require.main === module) {
-  runExamples();
-}