@warriorteam/redai-zalo-sdk 1.1.0

package/dist/services/message-management.service.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageManagementService = void 0;
+const common_1 = require("../types/common");
+/**
+ * Service xử lý các API quản lý tin nhắn của Zalo Official Account
+ *
+ * Bao gồm các chức năng:
+ * - Kiểm tra hạn mức gửi tin nhắn
+ * - Lấy danh sách tin nhắn trong cuộc hội thoại
+ * - Lấy danh sách cuộc hội thoại
+ * - Upload file và hình ảnh
+ * - Quản lý trạng thái tin nhắn
+ *
+ * ĐIỀU KIỆN SỬ DỤNG:
+ *
+ * 1. KIỂM TRA HẠN MỨC:
+ *    - Cần quyền truy cập thông tin quota từ Zalo
+ *    - Quota được reset hàng ngày vào 00:00 GMT+7
+ *
+ * 2. LẤY TIN NHẮN:
+ *    - Chỉ có thể lấy tin nhắn trong vòng 7 ngày gần nhất
+ *    - Tối đa 50 tin nhắn mỗi lần gọi API
+ *
+ * 3. UPLOAD FILE:
+ *    - Kích thước tối đa 25MB
+ *    - Hỗ trợ các định dạng: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
+ *
+ * 4. UPLOAD HÌNH ẢNH:
+ *    - Kích thước tối đa 5MB
+ *    - Hỗ trợ các định dạng: JPG, PNG, GIF
+ */
+class MessageManagementService {
+    constructor(client) {
+        this.client = client;
+        this.baseApiUrl = "https://openapi.zalo.me/v2.0/oa";
+        this.uploadApiUrl = "https://openapi.zalo.me/v2.0/oa/upload";
+    }
+    /**
+     * Kiểm tra hạn mức gửi tin nhắn đến user cụ thể
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người dùng Zalo
+     * @returns Thông tin hạn mức gửi tin nhắn
+     */
+    async checkMessageQuota(accessToken, userId) {
+        try {
+            const result = await this.client.apiGet(`${this.baseApiUrl}/quota`, accessToken, { user_id: userId });
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to check message quota", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No quota data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to check message quota: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Lấy danh sách tin nhắn trong cuộc hội thoại với user
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người dùng Zalo
+     * @param offset Vị trí bắt đầu lấy tin nhắn (mặc định: 0)
+     * @param count Số lượng tin nhắn cần lấy (mặc định: 20, tối đa: 50)
+     * @returns Danh sách tin nhắn và thông tin phân trang
+     */
+    async getConversationMessages(accessToken, userId, offset = 0, count = 20) {
+        try {
+            if (count > 50) {
+                throw new common_1.ZaloSDKError("Số lượng tin nhắn tối đa là 50", -1);
+            }
+            const result = await this.client.apiGet(`${this.baseApiUrl}/conversation`, accessToken, {
+                user_id: userId,
+                offset,
+                count,
+            });
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to get conversation messages", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No conversation data received", -1);
+            }
+            return {
+                messages: result.data.messages,
+                pagination: {
+                    offset,
+                    count,
+                    total: result.data.total,
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get conversation messages: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Lấy danh sách cuộc hội thoại gần đây
+     * @param accessToken Access token của Official Account
+     * @param offset Vị trí bắt đầu lấy cuộc hội thoại (mặc định: 0)
+     * @param count Số lượng cuộc hội thoại cần lấy (mặc định: 20, tối đa: 50)
+     * @returns Danh sách cuộc hội thoại và thông tin phân trang
+     */
+    async getRecentConversations(accessToken, offset = 0, count = 20) {
+        try {
+            if (count > 50) {
+                throw new common_1.ZaloSDKError("Số lượng cuộc hội thoại tối đa là 50", -1);
+            }
+            const result = await this.client.apiGet(`${this.baseApiUrl}/listrecentchat`, accessToken, {
+                offset,
+                count,
+            });
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to get recent conversations", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No conversations data received", -1);
+            }
+            return {
+                conversations: result.data.conversations,
+                pagination: {
+                    offset,
+                    count,
+                    total: result.data.total,
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get recent conversations: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Upload file để sử dụng trong tin nhắn
+     * @param accessToken Access token của Official Account
+     * @param fileData Dữ liệu file (base64 hoặc buffer)
+     * @param fileName Tên file
+     * @returns Thông tin file đã upload
+     */
+    async uploadFile(accessToken, fileData, fileName) {
+        try {
+            // Validate file size (max 25MB)
+            const maxSize = 25 * 1024 * 1024; // 25MB
+            let fileSize;
+            if (typeof fileData === "string") {
+                // Base64 string
+                fileSize = Buffer.from(fileData, "base64").length;
+            }
+            else {
+                // Buffer
+                fileSize = fileData.length;
+            }
+            if (fileSize > maxSize) {
+                throw new common_1.ZaloSDKError("Kích thước file không được vượt quá 25MB", -1);
+            }
+            const formData = new FormData();
+            if (typeof fileData === "string") {
+                const buffer = Buffer.from(fileData, "base64");
+                formData.append("file", new Blob([new Uint8Array(buffer)]), fileName);
+            }
+            else {
+                formData.append("file", new Blob([new Uint8Array(fileData)]), fileName);
+            }
+            const result = await this.client.apiPost(`${this.uploadApiUrl}/file`, accessToken, formData);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to upload file", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No upload result received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to upload file: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Upload hình ảnh để sử dụng trong tin nhắn
+     * @param accessToken Access token của Official Account
+     * @param imageData Dữ liệu hình ảnh (base64 hoặc buffer)
+     * @param fileName Tên file hình ảnh
+     * @returns Thông tin hình ảnh đã upload
+     */
+    async uploadImage(accessToken, imageData, fileName) {
+        try {
+            // Validate image size (max 5MB)
+            const maxSize = 5 * 1024 * 1024; // 5MB
+            let imageSize;
+            if (typeof imageData === "string") {
+                // Base64 string
+                imageSize = Buffer.from(imageData, "base64").length;
+            }
+            else {
+                // Buffer
+                imageSize = imageData.length;
+            }
+            if (imageSize > maxSize) {
+                throw new common_1.ZaloSDKError("Kích thước hình ảnh không được vượt quá 5MB", -1);
+            }
+            const formData = new FormData();
+            if (typeof imageData === "string") {
+                const buffer = Buffer.from(imageData, "base64");
+                formData.append("file", new Blob([new Uint8Array(buffer)]), fileName);
+            }
+            else {
+                formData.append("file", new Blob([new Uint8Array(imageData)]), fileName);
+            }
+            const result = await this.client.apiPost(`${this.uploadApiUrl}/image`, accessToken, formData);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to upload image", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No upload result received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to upload image: ${error.message}`, -1, error);
+        }
+    }
+}
+exports.MessageManagementService = MessageManagementService;
+//# sourceMappingURL=message-management.service.js.map

package/dist/services/message-management.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-management.service.js","sourceRoot":"","sources":["../../src/services/message-management.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,67 @@
+/**
+ * Official Account (OA) service for Zalo API
+ */
+import { ZaloClient } from '../clients/zalo-client';
+import { OAInfo, MessageQuota, QuotaMessageRequest, QuotaAsset, OAStatistics, UpdateOAProfileRequest, GMFProductType } from '../types/oa';
+/**
+ * Official Account service for managing OA information and settings
+ */
+export declare class OAService {
+    private readonly client;
+    constructor(client: ZaloClient);
+    /**
+     * Get Official Account information
+     */
+    getOAInfo(accessToken: string): Promise<OAInfo>;
+    /**
+     * Get message quota information
+     */
+    getMessageQuota(accessToken: string): Promise<MessageQuota>;
+    /**
+     * Get detailed quota message information
+     */
+    getDetailedQuotaMessage(accessToken: string, request: QuotaMessageRequest): Promise<QuotaAsset[]>;
+    /**
+     * Get quota for specific product type
+     */
+    getQuotaByProductType(accessToken: string, productType: 'cs' | 'transaction' | 'gmf10' | 'gmf50' | 'gmf100', quotaType?: 'sub_quota' | 'purchase_quota' | 'reward_quota'): Promise<QuotaAsset[]>;
+    /**
+     * Get available GMF quota
+     */
+    getGMFQuota(accessToken: string, gmfType?: GMFProductType): Promise<QuotaAsset[]>;
+    /**
+     * Get consultation message quota
+     */
+    getConsultationQuota(accessToken: string): Promise<QuotaAsset[]>;
+    /**
+     * Get transaction message quota
+     */
+    getTransactionQuota(accessToken: string): Promise<QuotaAsset[]>;
+    /**
+     * Update OA profile information
+     */
+    updateOAProfile(accessToken: string, profileData: UpdateOAProfileRequest): Promise<boolean>;
+    /**
+     * Get OA statistics (if available)
+     */
+    getOAStatistics(accessToken: string): Promise<OAStatistics>;
+    /**
+     * Check if OA has sufficient quota for message type
+     */
+    hasQuotaForMessageType(accessToken: string, messageType: 'cs' | 'transaction' | 'promotion', requiredCount?: number): Promise<boolean>;
+    /**
+     * Get quota summary for all message types
+     */
+    getQuotaSummary(accessToken: string): Promise<{
+        consultation: QuotaAsset[];
+        transaction: QuotaAsset[];
+        gmf10: QuotaAsset[];
+        gmf50: QuotaAsset[];
+        gmf100: QuotaAsset[];
+    }>;
+    /**
+     * Validate OA access token by getting OA info
+     */
+    validateOAToken(accessToken: string): Promise<boolean>;
+}
+//# sourceMappingURL=oa.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oa.service.d.ts","sourceRoot":"","sources":["../../src/services/oa.service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,MAAM,EACN,YAAY,EACZ,mBAAmB,EAEnB,UAAU,EAEV,YAAY,EACZ,sBAAsB,EAEtB,cAAc,EAEf,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;OAEG;IACU,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0B5D;;OAEG;IACU,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA0BxE;;OAEG;IACU,uBAAuB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;IAsBxB;;OAEG;IACU,qBAAqB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,IAAI,GAAG,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,EAChE,SAAS,CAAC,EAAE,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAC1D,OAAO,CAAC,UAAU,EAAE,CAAC;IAUxB;;OAEG;IACU,WAAW,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAqC,GAC7C,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB;;OAEG;IACU,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI7E;;OAEG;IACU,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI5E;;OAEG;IACU,eAAe,CAC1B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,sBAAsB,GAClC,OAAO,CAAC,OAAO,CAAC;IAwBnB;;OAEG;IACU,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA6BxE;;OAEG;IACU,sBAAsB,CACjC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,IAAI,GAAG,aAAa,GAAG,WAAW,EAC/C,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC,OAAO,CAAC;IA4BnB;;OAEG;IACU,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QACzD,YAAY,EAAE,UAAU,EAAE,CAAC;QAC3B,WAAW,EAAE,UAAU,EAAE,CAAC;QAC1B,KAAK,EAAE,UAAU,EAAE,CAAC;QACpB,KAAK,EAAE,UAAU,EAAE,CAAC;QACpB,MAAM,EAAE,UAAU,EAAE,CAAC;KACtB,CAAC;IAyBF;;OAEG;IACU,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQpE"}

package/dist/services/oa.service.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * Official Account (OA) service for Zalo API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OAService = void 0;
+const oa_1 = require("../types/oa");
+const common_1 = require("../types/common");
+/**
+ * Official Account service for managing OA information and settings
+ */
+class OAService {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get Official Account information
+     */
+    async getOAInfo(accessToken) {
+        try {
+            const endpoint = this.client.endpoints.oa.info;
+            const result = await this.client.apiGet(endpoint, accessToken);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || 'Failed to get OA information', result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError('No OA data received', -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get OA info: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Get message quota information
+     */
+    async getMessageQuota(accessToken) {
+        try {
+            const endpoint = this.client.endpoints.oa.quota;
+            const result = await this.client.apiGet(endpoint, accessToken);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || 'Failed to get message quota', result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError('No quota data received', -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get message quota: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Get detailed quota message information
+     */
+    async getDetailedQuotaMessage(accessToken, request) {
+        try {
+            const endpoint = this.client.endpoints.oa.quotaMessage;
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || 'Failed to get detailed quota message', result.error, result);
+            }
+            return result.data || [];
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get detailed quota message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Get quota for specific product type
+     */
+    async getQuotaByProductType(accessToken, productType, quotaType) {
+        const request = {
+            quota_owner: 'OA',
+            product_type: productType,
+            quota_type: quotaType,
+        };
+        return this.getDetailedQuotaMessage(accessToken, request);
+    }
+    /**
+     * Get available GMF quota
+     */
+    async getGMFQuota(accessToken, gmfType = oa_1.GMFProductType.GMF10) {
+        return this.getQuotaByProductType(accessToken, gmfType);
+    }
+    /**
+     * Get consultation message quota
+     */
+    async getConsultationQuota(accessToken) {
+        return this.getQuotaByProductType(accessToken, 'cs');
+    }
+    /**
+     * Get transaction message quota
+     */
+    async getTransactionQuota(accessToken) {
+        return this.getQuotaByProductType(accessToken, 'transaction');
+    }
+    /**
+     * Update OA profile information
+     */
+    async updateOAProfile(accessToken, profileData) {
+        try {
+            // Note: This endpoint might not be available in all Zalo API versions
+            // This is a placeholder implementation
+            const endpoint = '/v2.0/oa/update';
+            const result = await this.client.apiPost(endpoint, accessToken, profileData);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || 'Failed to update OA profile', result.error, result);
+            }
+            return true;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to update OA profile: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Get OA statistics (if available)
+     */
+    async getOAStatistics(accessToken) {
+        try {
+            // Note: This endpoint might not be available in all Zalo API versions
+            // This is a placeholder implementation
+            const endpoint = '/v2.0/oa/statistics';
+            const result = await this.client.apiGet(endpoint, accessToken);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || 'Failed to get OA statistics', result.error, result);
+            }
+            return result.data || {
+                total_followers: 0,
+                new_followers_today: 0,
+                messages_sent_today: 0,
+                messages_received_today: 0,
+            };
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get OA statistics: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Check if OA has sufficient quota for message type
+     */
+    async hasQuotaForMessageType(accessToken, messageType, requiredCount = 1) {
+        try {
+            let productType;
+            if (messageType === 'promotion') {
+                // Promotion messages might use different quota logic
+                return true; // Placeholder
+            }
+            else {
+                productType = messageType;
+            }
+            const quotaAssets = await this.getQuotaByProductType(accessToken, productType);
+            // Check if there are available assets
+            const availableAssets = quotaAssets.filter(asset => asset.status === 'available');
+            if (availableAssets.length === 0) {
+                return false;
+            }
+            // For simplicity, assume each available asset can handle the required count
+            return true;
+        }
+        catch (error) {
+            // If we can't check quota, assume it's available to avoid blocking
+            return true;
+        }
+    }
+    /**
+     * Get quota summary for all message types
+     */
+    async getQuotaSummary(accessToken) {
+        try {
+            const [consultation, transaction, gmf10, gmf50, gmf100] = await Promise.all([
+                this.getConsultationQuota(accessToken),
+                this.getTransactionQuota(accessToken),
+                this.getGMFQuota(accessToken, oa_1.GMFProductType.GMF10),
+                this.getGMFQuota(accessToken, oa_1.GMFProductType.GMF50),
+                this.getGMFQuota(accessToken, oa_1.GMFProductType.GMF100),
+            ]);
+            return {
+                consultation,
+                transaction,
+                gmf10,
+                gmf50,
+                gmf100,
+            };
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get quota summary: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Validate OA access token by getting OA info
+     */
+    async validateOAToken(accessToken) {
+        try {
+            await this.getOAInfo(accessToken);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+exports.OAService = OAService;
+//# sourceMappingURL=oa.service.js.map

package/dist/services/oa.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oa.service.js","sourceRoot":"","sources":["../../src/services/oa.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,114 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { SendMessageResponse, PromotionMessage, MessageRecipient } from "../types/message";
+/**
+ * Service xử lý các API tin nhắn truyền thông/quảng cáo của Zalo Official Account
+ *
+ * ĐIỀU KIỆN GỬI TIN TRUYỀN THÔNG:
+ *
+ * 1. THỜI GIAN GỬI:
+ *    - Chỉ được gửi trong khung giờ từ 8:00 - 22:00 hàng ngày
+ *    - Không được gửi vào các ngày lễ, tết theo quy định
+ *
+ * 2. NỘI DUNG TIN NHẮN:
+ *    - Phải là nội dung quảng cáo, khuyến mãi, tin tức
+ *    - Không được chứa nội dung vi phạm pháp luật
+ *    - Phải tuân thủ quy định về quảng cáo của Việt Nam
+ *
+ * 3. TẦN SUẤT GỬI:
+ *    - Tối đa 1 tin nhắn truyền thông/ngày cho mỗi người dùng
+ *    - Người dùng có thể từ chối nhận tin truyền thông
+ *
+ * 4. ĐỊNH DẠNG:
+ *    - Phải sử dụng template được Zalo phê duyệt trước
+ *    - Template phải tuân thủ format chuẩn của tin truyền thông
+ *
+ * 5. NGƯỜI DÙNG:
+ *    - Người dùng phải đã follow OA
+ *    - Người dùng không được block OA
+ *    - Người dùng không được từ chối nhận tin truyền thông
+ *
+ * 6. OFFICIAL ACCOUNT:
+ *    - OA phải được xác minh (verified)
+ *    - OA phải có quyền gửi tin truyền thông được Zalo cấp phép
+ *    - OA không được vi phạm chính sách về quảng cáo
+ *
+ * LỖI THƯỜNG GẶP:
+ * - 2001: Ngoài khung giờ cho phép (8:00-22:00)
+ * - 2002: Người dùng đã từ chối nhận tin truyền thông
+ * - 2003: Vượt quá giới hạn 1 tin/ngày
+ * - 2004: Template chưa được phê duyệt
+ * - 2005: Nội dung vi phạm chính sách quảng cáo
+ * - 2006: OA chưa có quyền gửi tin truyền thông
+ */
+export declare class PromotionService {
+    private readonly client;
+    private readonly promotionApiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Gửi tin nhắn truyền thông/quảng cáo
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param message Nội dung tin nhắn truyền thông
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendPromotionMessage(accessToken: string, recipient: MessageRecipient, message: PromotionMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn khuyến mãi sản phẩm
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param promotionInfo Thông tin khuyến mãi
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendProductPromotion(accessToken: string, recipient: MessageRecipient, promotionInfo: {
+        title: string;
+        description: string;
+        imageUrl: string;
+        originalPrice: number;
+        discountPrice: number;
+        discountPercent: number;
+        validUntil: string;
+        productUrl: string;
+    }): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn thông báo sự kiện
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param eventInfo Thông tin sự kiện
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendEventNotification(accessToken: string, recipient: MessageRecipient, eventInfo: {
+        title: string;
+        description: string;
+        imageUrl: string;
+        eventDate: string;
+        location: string;
+        registrationUrl: string;
+    }): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn newsletter
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param newsletterInfo Thông tin newsletter
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendNewsletter(accessToken: string, recipient: MessageRecipient, newsletterInfo: {
+        title: string;
+        summary: string;
+        imageUrl: string;
+        articles: Array<{
+            title: string;
+            url: string;
+        }>;
+        unsubscribeUrl: string;
+    }): Promise<SendMessageResponse>;
+    /**
+     * Validate promotion message format
+     * @param message Promotion message to validate
+     */
+    private validatePromotionMessage;
+    /**
+     * Validate sending time (8:00 - 22:00)
+     */
+    private validateSendingTime;
+}
+//# sourceMappingURL=promotion.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.service.d.ts","sourceRoot":"","sources":["../../src/services/promotion.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CACsB;gBAEzB,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACU,oBAAoB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAyC/B;;;;;;OAMG;IACU,oBAAoB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA6C/B;;;;;;OAMG;IACU,qBAAqB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA6C/B;;;;;;OAMG;IACU,cAAc,CACzB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,KAAK,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;SACb,CAAC,CAAC;QACH,cAAc,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,mBAAmB,CAAC;IAyC/B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAW5B"}