@warriorteam/redai-zalo-sdk 1.29.0 → 1.30.0

package/dist/types/consultation.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Types cho Consultation Service - Zalo OA API
+ *
+ * Consultation messages (tin nhắn tư vấn) là loại tin nhắn đặc biệt
+ * cho phép OA gửi tin nhắn chủ động đến người dùng trong khung thời gian nhất định
+ *
+ * API Endpoint: https://openapi.zalo.me/v3.0/oa/message/cs
+ * Method: POST
+ * Content-Type: application/json
+ */
+/**
+ * Interface cho template action (default_action trong elements)
+ */
+export interface TemplateAction {
+    /** Loại action */
+    type: "oa.open.url" | "oa.query.show" | "oa.query.hide" | "oa.open.sms" | "oa.open.phone";
+    /** URL (cho oa.open.url) */
+    url?: string;
+    /** Payload string (cho oa.query.show, oa.query.hide) hoặc object (cho oa.open.sms, oa.open.phone) */
+    payload?: string | {
+        content?: string;
+        phone_code?: string;
+    } | {
+        phone_code?: string;
+    };
+}
+/**
+ * Interface cho template element
+ *
+ * Quy tắc elements:
+ * - elements là mảng JSON, tối đa 5 phần tử
+ * - title: bắt buộc, ≤ 100 ký tự
+ * - subtitle: bắt buộc cho element đầu tiên, tùy chọn cho các element sau, ≤ 500 ký tự
+ * - image_url: URL ảnh (tùy chọn)
+ * - default_action: hành động khi click vào element (tùy chọn)
+ */
+export interface TemplateElement {
+    /** Tiêu đề (bắt buộc, ≤ 100 ký tự) */
+    title: string;
+    /** Tiêu đề phụ (bắt buộc cho element đầu tiên, tùy chọn cho các element sau, ≤ 500 ký tự) */
+    subtitle?: string;
+    /** URL ảnh (tùy chọn) */
+    image_url?: string;
+    /** Hành động khi click vào element (tùy chọn) */
+    default_action?: TemplateAction;
+}
+/**
+ * Interface cho template button
+ *
+ * Quy tắc buttons:
+ * - buttons là mảng JSON, tối đa 5 phần tử
+ * - title: bắt buộc, ≤ 100 ký tự
+ * - type: loại action
+ * - payload: dữ liệu của action, phụ thuộc vào loại type
+ */
+export interface TemplateButton {
+    /** Tiêu đề button (bắt buộc, ≤ 100 ký tự) */
+    title: string;
+    /** Loại button */
+    type: "oa.open.url" | "oa.query.show" | "oa.query.hide" | "oa.open.sms" | "oa.open.phone";
+    /** Payload của button, phụ thuộc vào type */
+    payload: string | {
+        url?: string;
+    } | {
+        content?: string;
+        phone_code?: string;
+    } | {
+        phone_code?: string;
+    };
+}
+/**
+ * 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?: any;
+        /** 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;
+    };
+}
+/**
+ * Các loại template action types
+ */
+export type TemplateActionType = "oa.open.url" | "oa.query.show" | "oa.query.hide" | "oa.open.sms" | "oa.open.phone";
+/**
+ * Các loại template button types (giống với action types)
+ */
+export type TemplateButtonType = TemplateActionType;
+/**
+ * Payload cho URL action/button
+ */
+export interface UrlPayload {
+    url: string;
+}
+/**
+ * Payload cho SMS action/button
+ */
+export interface SmsPayload {
+    phone_code: string;
+    content?: string;
+}
+/**
+ * Payload cho Phone action/button
+ */
+export interface PhonePayload {
+    phone_code: string;
+}
+/**
+ * Union type cho tất cả các loại payload
+ */
+export type ConsultationTemplatePayload = string | UrlPayload | SmsPayload | PhonePayload;
+/**
+ * Template types được hỗ trợ
+ */
+export type TemplateType = "request_user_info" | "media" | string;
+//# sourceMappingURL=consultation.d.ts.map

package/dist/types/consultation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultation.d.ts","sourceRoot":"","sources":["../../src/types/consultation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,eAAe,CAAC;IAC1F,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxF;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,eAAe,CAAC;IAC1F,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1G;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,mBAAmB,CAAC;IAC1E,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,KAAK,CAAC;QACb,yCAAyC;QACzC,KAAK,EAAE,MAAM,CAAC;QACd,oBAAoB;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,qBAAqB;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,wCAAwC;QACxC,QAAQ,CAAC,EAAE,GAAG,CAAC;QACf,iCAAiC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,oBAAoB;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yCAAyC;IACxD,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,0CAA0C;IACzD,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,WAAW,EAAE,KAAK,CAAC;QACjB,cAAc;QACd,MAAM,EAAE,MAAM,CAAC;QACf,qCAAqC;QACrC,SAAS,EAAE,MAAM,CAAC;QAClB,kCAAkC;QAClC,OAAO,EAAE,OAAO,CAAC;QACjB,oCAAoC;QACpC,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;QACpD,iCAAiC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,4BAA4B;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,yBAAyB;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,yCAAyC;QACzC,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,YAAY,EAAE;QACZ,yCAAyC;QACzC,uBAAuB,EAAE,MAAM,CAAC;QAChC,gCAAgC;QAChC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,uBAAuB;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,eAAe,GACf,eAAe,GACf,aAAa,GACb,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,OAAO,GACP,MAAM,CAAC"}

package/dist/types/consultation.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Types cho Consultation Service - Zalo OA API
+ *
+ * Consultation messages (tin nhắn tư vấn) là loại tin nhắn đặc biệt
+ * cho phép OA gửi tin nhắn chủ động đến người dùng trong khung thời gian nhất định
+ *
+ * API Endpoint: https://openapi.zalo.me/v3.0/oa/message/cs
+ * Method: POST
+ * Content-Type: application/json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=consultation.js.map

package/dist/types/consultation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultation.js","sourceRoot":"","sources":["../../src/types/consultation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/examples/consultation-template-example.ts

@@ -0,0 +1,324 @@
+/**
+ * Ví dụ sử dụng ConsultationService.sendTemplateMessage()
+ * Gửi tin nhắn template tổng quát với elements và buttons
+ * 
+ * API Endpoint: https://openapi.zalo.me/v3.0/oa/message/cs
+ * Method: POST
+ * Content-Type: application/json
+ */
+
+import { 
+  ConsultationService, 
+  TemplateElement, 
+  TemplateButton,
+  TemplateAction 
+} from '../src/services/consultation.service';
+import { ZaloClient } from '../src/clients/zalo-client';
+
+// Khởi tạo service
+const zaloClient = new ZaloClient();
+const consultationService = new ConsultationService(zaloClient);
+
+const ACCESS_TOKEN = "your_access_token_here";
+const USER_ID = "2468458835296117922";
+
+/**
+ * Ví dụ 1: Template request_user_info cơ bản
+ */
+async function example1_BasicRequestUserInfo() {
+  try {
+    // Tạo elements (tối đa 5 phần tử)
+    const elements: TemplateElement[] = [
+      // Element đầu tiên PHẢI có subtitle
+      consultationService.createTemplateElement(
+        "OA Chatbot (Testing)",
+        "Đang yêu cầu thông tin từ bạn",
+        "https://developers.zalo.me/web/static/zalo.png",
+        consultationService.createUrlAction("https://developers.zalo.me/")
+      ),
+      // Các element sau có thể không có subtitle
+      consultationService.createTemplateElement(
+        "Liên hệ hỗ trợ",
+        undefined, // không có subtitle
+        "https://developers.zalo.me/web/static/zalo.png",
+        consultationService.createPhoneAction("84919018791")
+      )
+    ];
+
+    // Tạo buttons (tối đa 5 phần tử)
+    const buttons: TemplateButton[] = [
+      consultationService.createUrlButton("OPEN URL", "https://developers.zalo.me/"),
+      consultationService.createQueryShowButton("QUERY SHOW", "#callback_data"),
+      consultationService.createQueryHideButton("QUERY HIDE", "#callback_data"),
+      consultationService.createSmsButton("OPEN SMS", "84919018791", "alo"),
+      consultationService.createPhoneButton("OPEN PHONE", "84919018791")
+    ];
+
+    // Gửi template message
+    const result = await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      elements,
+      buttons
+    );
+
+    console.log("✅ Template message sent successfully:", result);
+    return result;
+
+  } catch (error) {
+    console.error("❌ Error sending template message:", error);
+    throw error;
+  }
+}
+
+/**
+ * Ví dụ 2: Template đơn giản chỉ có 1 element và 2 buttons
+ */
+async function example2_SimpleTemplate() {
+  try {
+    // Chỉ 1 element
+    const elements: TemplateElement[] = [
+      {
+        title: "Chào mừng bạn đến với dịch vụ của chúng tôi!",
+        subtitle: "Chúng tôi có thể hỗ trợ gì cho bạn?",
+        image_url: "https://example.com/welcome.png"
+      }
+    ];
+
+    // 2 buttons đơn giản
+    const buttons: TemplateButton[] = [
+      consultationService.createQueryShowButton("Tư vấn sản phẩm", "product_consultation"),
+      consultationService.createPhoneButton("Gọi hotline", "84919018791")
+    ];
+
+    const result = await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      elements,
+      buttons
+    );
+
+    console.log("✅ Simple template sent successfully:", result);
+    return result;
+
+  } catch (error) {
+    console.error("❌ Error sending simple template:", error);
+    throw error;
+  }
+}
+
+/**
+ * Ví dụ 3: Template không có buttons (chỉ elements)
+ */
+async function example3_ElementsOnly() {
+  try {
+    const elements: TemplateElement[] = [
+      {
+        title: "Thông báo quan trọng",
+        subtitle: "Hệ thống sẽ bảo trì từ 2:00 - 4:00 sáng ngày mai",
+        image_url: "https://example.com/maintenance.png",
+        default_action: {
+          type: "oa.open.url",
+          url: "https://example.com/maintenance-info"
+        }
+      },
+      {
+        title: "Liên hệ hỗ trợ khẩn cấp",
+        // Không có subtitle cho element thứ 2
+        default_action: {
+          type: "oa.open.phone",
+          payload: { phone_code: "84919018791" }
+        }
+      }
+    ];
+
+    // Không có buttons
+    const result = await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      elements
+      // buttons parameter bỏ qua
+    );
+
+    console.log("✅ Elements-only template sent successfully:", result);
+    return result;
+
+  } catch (error) {
+    console.error("❌ Error sending elements-only template:", error);
+    throw error;
+  }
+}
+
+/**
+ * Ví dụ 4: Template với tất cả loại buttons
+ */
+async function example4_AllButtonTypes() {
+  try {
+    const elements: TemplateElement[] = [
+      {
+        title: "Trung tâm hỗ trợ khách hàng",
+        subtitle: "Chọn hình thức liên hệ phù hợp với bạn",
+        image_url: "https://example.com/support.png"
+      }
+    ];
+
+    const buttons: TemplateButton[] = [
+      // URL button
+      {
+        title: "Xem FAQ",
+        type: "oa.open.url",
+        payload: { url: "https://example.com/faq" }
+      },
+      // Query show button
+      {
+        title: "Chat với tư vấn viên",
+        type: "oa.query.show",
+        payload: "start_chat_with_agent"
+      },
+      // Query hide button
+      {
+        title: "Gửi phản hồi",
+        type: "oa.query.hide",
+        payload: "send_feedback"
+      },
+      // SMS button
+      {
+        title: "Gửi SMS hỗ trợ",
+        type: "oa.open.sms",
+        payload: {
+          phone_code: "84919018791",
+          content: "Tôi cần hỗ trợ"
+        }
+      },
+      // Phone button
+      {
+        title: "Gọi hotline",
+        type: "oa.open.phone",
+        payload: { phone_code: "84919018791" }
+      }
+    ];
+
+    const result = await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      elements,
+      buttons
+    );
+
+    console.log("✅ All button types template sent successfully:", result);
+    return result;
+
+  } catch (error) {
+    console.error("❌ Error sending all button types template:", error);
+    throw error;
+  }
+}
+
+/**
+ * Ví dụ 5: Template với validation errors (để test)
+ */
+async function example5_ValidationErrors() {
+  try {
+    // Element với title quá dài (> 100 ký tự)
+    const invalidElements: TemplateElement[] = [
+      {
+        title: "A".repeat(101), // 101 ký tự - sẽ báo lỗi
+        subtitle: "This will cause validation error"
+      }
+    ];
+
+    await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      invalidElements
+    );
+
+  } catch (error) {
+    console.log("✅ Expected validation error caught:", error.message);
+  }
+
+  try {
+    // Element đầu tiên không có subtitle
+    const invalidElements2: TemplateElement[] = [
+      {
+        title: "Valid title",
+        // Thiếu subtitle cho element đầu tiên - sẽ báo lỗi
+      }
+    ];
+
+    await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      invalidElements2
+    );
+
+  } catch (error) {
+    console.log("✅ Expected validation error caught:", error.message);
+  }
+
+  try {
+    // Quá nhiều elements (> 5)
+    const tooManyElements: TemplateElement[] = Array(6).fill(null).map((_, i) => ({
+      title: `Element ${i + 1}`,
+      subtitle: i === 0 ? "Required subtitle for first element" : undefined
+    }));
+
+    await consultationService.sendTemplateMessage(
+      ACCESS_TOKEN,
+      USER_ID,
+      "request_user_info",
+      tooManyElements
+    );
+
+  } catch (error) {
+    console.log("✅ Expected validation error caught:", error.message);
+  }
+}
+
+// Chạy các ví dụ
+async function runExamples() {
+  console.log("🚀 Running Consultation Template Examples...\n");
+
+  try {
+    await example1_BasicRequestUserInfo();
+    console.log("\n");
+
+    await example2_SimpleTemplate();
+    console.log("\n");
+
+    await example3_ElementsOnly();
+    console.log("\n");
+
+    await example4_AllButtonTypes();
+    console.log("\n");
+
+    await example5_ValidationErrors();
+    console.log("\n");
+
+    console.log("✅ All examples completed!");
+
+  } catch (error) {
+    console.error("❌ Example failed:", error);
+  }
+}
+
+// Export để có thể import và sử dụng
+export {
+  example1_BasicRequestUserInfo,
+  example2_SimpleTemplate,
+  example3_ElementsOnly,
+  example4_AllButtonTypes,
+  example5_ValidationErrors,
+  runExamples
+};
+
+// Chạy nếu file được execute trực tiếp
+if (require.main === module) {
+  runExamples();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warriorteam/redai-zalo-sdk",
-  "version": "1.29.0",
+  "version": "1.30.0",
   "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account v3.0, ZNS with Full Type Safety, 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",