@warriorteam/redai-zalo-sdk 1.1.0

package/dist/services/auth.service.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Authentication service for Zalo API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthService = void 0;
+const auth_1 = require("../types/auth");
+const common_1 = require("../types/common");
+const crypto_1 = require("crypto");
+/**
+ * Authentication service for handling OAuth flows and token management
+ */
+class AuthService {
+    constructor(client, appId, appSecret) {
+        this.client = client;
+        this.appId = appId;
+        this.appSecret = appSecret;
+    }
+    /**
+     * Generate PKCE code verifier and challenge for Social API
+     */
+    generatePKCE() {
+        const codeVerifier = (0, crypto_1.randomBytes)(32).toString("base64url");
+        const codeChallenge = (0, crypto_1.createHash)("sha256")
+            .update(codeVerifier)
+            .digest("base64url");
+        return {
+            code_verifier: codeVerifier,
+            code_challenge: codeChallenge,
+            code_challenge_method: "S256",
+        };
+    }
+    /**
+     * Create OAuth authorization URL for Official Account
+     */
+    createOAAuthUrl(redirectUri, state) {
+        const params = new URLSearchParams({
+            app_id: this.appId,
+            redirect_uri: redirectUri,
+            state: state || "oa_auth",
+        });
+        return `https://oauth.zaloapp.com/v4/oa/permission?${params.toString()}`;
+    }
+    /**
+     * Create OAuth authorization URL for Social API
+     */
+    createSocialAuthUrl(redirectUri, state, pkce) {
+        const params = new URLSearchParams({
+            app_id: this.appId,
+            redirect_uri: redirectUri,
+            state: state || "social_auth",
+        });
+        if (pkce) {
+            params.append("code_challenge", pkce.code_challenge);
+            params.append("code_challenge_method", pkce.code_challenge_method);
+        }
+        return `https://oauth.zaloapp.com/v4/permission?${params.toString()}`;
+    }
+    /**
+     * Exchange authorization code for Official Account access token
+     */
+    async getOAAccessToken(params) {
+        try {
+            const url = "https://openapi.zalo.me/v2.0/oa/oauth/access_token";
+            const requestParams = {
+                app_id: params.app_id,
+                app_secret: params.app_secret,
+                code: params.code,
+                grant_type: "authorization_code",
+                redirect_uri: params.redirect_uri,
+            };
+            await this.client.oauthRequestWithUrl("POST", url, null, {
+                "Content-Type": "application/x-www-form-urlencoded",
+            });
+            // Convert to URLSearchParams for form data
+            const formData = new URLSearchParams();
+            Object.entries(requestParams).forEach(([key, value]) => {
+                formData.append(key, value);
+            });
+            const result = await this.client.oauthRequestWithUrl("POST", url, formData.toString(), {
+                "Content-Type": "application/x-www-form-urlencoded",
+            });
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.error_description ||
+                    result.message ||
+                    "Failed to get OA access token", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No data received from Zalo API", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get OA access token: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Exchange authorization code for Social API access token
+     */
+    async getSocialAccessToken(params) {
+        try {
+            const url = "https://oauth.zaloapp.com/v4/access_token";
+            const formData = new URLSearchParams();
+            formData.append("code", params.code);
+            formData.append("app_id", params.app_id);
+            formData.append("grant_type", "authorization_code");
+            if (params.code_verifier) {
+                formData.append("code_verifier", params.code_verifier);
+            }
+            const result = await this.client.oauthRequestWithUrl("POST", url, formData.toString(), {
+                "Content-Type": "application/x-www-form-urlencoded",
+                secret_key: params.app_secret,
+            });
+            // Handle different response formats
+            if (result.error && result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.error_description ||
+                    result.message ||
+                    "Failed to get Social access token", result.error, result);
+            }
+            // Response might be direct or wrapped in data
+            if (result.data) {
+                return result.data;
+            }
+            else if (result.access_token) {
+                return {
+                    access_token: result.access_token,
+                    expires_in: result.expires_in,
+                    refresh_token: result.refresh_token,
+                };
+            }
+            else {
+                throw new common_1.ZaloSDKError("No access token received from Zalo API", -1);
+            }
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get Social access token: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Refresh Official Account access token
+     */
+    async refreshOAAccessToken(params) {
+        try {
+            const url = "https://oauth.zaloapp.com/v4/oa/access_token";
+            const formData = new URLSearchParams();
+            formData.append("refresh_token", params.refresh_token);
+            formData.append("app_id", params.app_id);
+            formData.append("grant_type", "refresh_token");
+            const result = await this.client.oauthRequestWithUrl("POST", url, formData.toString(), {
+                "Content-Type": "application/x-www-form-urlencoded",
+                secret_key: params.app_secret,
+            });
+            if (!result.access_token) {
+                throw new common_1.ZaloSDKError("No access token received when refreshing OA token", -1);
+            }
+            return {
+                access_token: result.access_token,
+                refresh_token: result.refresh_token,
+                expires_in: parseInt(result.expires_in),
+            };
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to refresh OA access token: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Refresh Social API access token
+     */
+    async refreshSocialAccessToken(params) {
+        try {
+            const endpoint = this.client.endpoints.auth.refreshSocialToken;
+            const requestParams = {
+                app_id: params.app_id,
+                grant_type: "refresh_token",
+                refresh_token: params.refresh_token,
+            };
+            const result = await this.client.apiGet(endpoint, "", requestParams);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.error_description ||
+                    result.message ||
+                    "Failed to refresh Social access token", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No data received when refreshing Social token", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to refresh Social access token: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Get Social user information
+     */
+    async getSocialUserInfo(accessToken, fields = "id,name,picture") {
+        try {
+            const url = "https://graph.zalo.me/v2.0/me";
+            const params = { fields };
+            const result = await this.client.oauthRequestWithUrl("GET", url, params, {
+                access_token: accessToken,
+            });
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to get Social user info", result.error, result);
+            }
+            if (!result.id) {
+                throw new common_1.ZaloSDKError("No user data received from Social API", -1);
+            }
+            return {
+                id: result.id,
+                name: result.name,
+                picture: result.picture,
+                is_sensitive: result.is_sensitive,
+            };
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to get Social user info: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Validate access token by attempting to get user info
+     */
+    async validateAccessToken(accessToken, scope = auth_1.AuthScope.SOCIAL) {
+        try {
+            if (scope === auth_1.AuthScope.SOCIAL) {
+                const userInfo = await this.getSocialUserInfo(accessToken, "id");
+                return {
+                    valid: true,
+                    user_info: userInfo,
+                };
+            }
+            else {
+                // For OA tokens, we could try to get OA info
+                // This is a simplified validation
+                return { valid: true };
+            }
+        }
+        catch (error) {
+            return { valid: false };
+        }
+    }
+    /**
+     * Get all authentication URLs
+     */
+    getAuthUrls(redirectUri) {
+        return {
+            oa_auth_url: this.createOAAuthUrl(redirectUri),
+            social_auth_url: this.createSocialAuthUrl(redirectUri),
+            token_url: "https://oauth.zaloapp.com/v4/access_token",
+            refresh_url: "https://oauth.zaloapp.com/v4/oa/access_token",
+        };
+    }
+}
+exports.AuthService = AuthService;
+//# sourceMappingURL=auth.service.js.map

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

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

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

@@ -0,0 +1,73 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { Message, SendMessageResponse, TextMessage, ImageMessage, FileMessage, StickerMessage, MessageRecipient } from "../types/message";
+/**
+ * Service xử lý các API tin nhắn tư vấn của Zalo Official Account
+ *
+ * Tin nhắn tư vấn (CS - Customer Service) 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
+ *
+ * ĐIỀU KIỆN GỬI TIN TƯ VẤN:
+ *
+ * 1. THỜI GIAN GỬI:
+ *    - Chỉ được gửi trong vòng 48 giờ kể từ khi người dùng tương tác cuối cùng với OA
+ *    - Tương tác bao gồm: gửi tin nhắn, nhấn button, gọi điện, truy cập website từ OA
+ *
+ * 2. NỘI DUNG TIN NHẮN:
+ *    - Phải liên quan đến tư vấn, hỗ trợ khách hàng
+ *    - Bao gồm: trả lời câu hỏi, hướng dẫn sử dụng, hỗ trợ kỹ thuật
+ *    - Không được chứa nội dung quảng cáo trực tiếp
+ *
+ * 3. TẦN SUẤT GỬI:
+ *    - Không giới hạn số lượng tin nhắn tư vấn trong ngày
+ *    - Tuy nhiên cần tuân thủ nguyên tắc không spam
+ *
+ * 4. 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 phải có tương tác gần đây với OA
+ */
+export declare class ConsultationService {
+    private readonly client;
+    constructor(client: ZaloClient);
+    /**
+     * Gửi tin nhắn tư vấn văn bản
+     * @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 văn bản
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendTextMessage(accessToken: string, recipient: MessageRecipient, message: TextMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn tư vấn hình ảnh
+     * @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 hình ảnh
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendImageMessage(accessToken: string, recipient: MessageRecipient, message: ImageMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn tư vấn file đính kèm
+     * @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 file
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendFileMessage(accessToken: string, recipient: MessageRecipient, message: FileMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn tư vấn sticker
+     * @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 sticker
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendStickerMessage(accessToken: string, recipient: MessageRecipient, message: StickerMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn tư vấn tổng quát
+     * @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
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendMessage(accessToken: string, recipient: MessageRecipient, message: Message): Promise<SendMessageResponse>;
+}
+//# sourceMappingURL=consultation.service.d.ts.map

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

@@ -0,0 +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,OAAO,EAEP,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,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;IA8C/B;;;;;;OAMG;IACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAyC/B;;;;;;OAMG;IACU,eAAe,CAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAyC/B;;;;;;OAMG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC;IAyC/B;;;;;;OAMG;IACU,WAAW,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,mBAAmB,CAAC;CAoChC"}

package/dist/services/consultation.service.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsultationService = void 0;
+const common_1 = require("../types/common");
+/**
+ * Service xử lý các API tin nhắn tư vấn của Zalo Official Account
+ *
+ * Tin nhắn tư vấn (CS - Customer Service) 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
+ *
+ * ĐIỀU KIỆN GỬI TIN TƯ VẤN:
+ *
+ * 1. THỜI GIAN GỬI:
+ *    - Chỉ được gửi trong vòng 48 giờ kể từ khi người dùng tương tác cuối cùng với OA
+ *    - Tương tác bao gồm: gửi tin nhắn, nhấn button, gọi điện, truy cập website từ OA
+ *
+ * 2. NỘI DUNG TIN NHẮN:
+ *    - Phải liên quan đến tư vấn, hỗ trợ khách hàng
+ *    - Bao gồm: trả lời câu hỏi, hướng dẫn sử dụng, hỗ trợ kỹ thuật
+ *    - Không được chứa nội dung quảng cáo trực tiếp
+ *
+ * 3. TẦN SUẤT GỬI:
+ *    - Không giới hạn số lượng tin nhắn tư vấn trong ngày
+ *    - Tuy nhiên cần tuân thủ nguyên tắc không spam
+ *
+ * 4. 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 phải có tương tác gần đây với OA
+ */
+class ConsultationService {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Gửi tin nhắn tư vấn văn bản
+     * @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 văn bản
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendTextMessage(accessToken, recipient, message) {
+        try {
+            // Validate text length theo quy định của Zalo
+            if (!message.text || message.text.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Nội dung tin nhắn không được để trống", -1);
+            }
+            if (message.text.length > 2000) {
+                throw new common_1.ZaloSDKError("Nội dung tin nhắn không được vượt quá 2000 ký tự", -1);
+            }
+            const endpoint = this.client.endpoints.message.send;
+            const request = {
+                recipient,
+                message,
+                messaging_type: "consultation",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send consultation text message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send consultation text message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn tư vấn hình ảnh
+     * @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 hình ảnh
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendImageMessage(accessToken, recipient, message) {
+        try {
+            if (!message.attachment?.payload?.url) {
+                throw new common_1.ZaloSDKError("URL hình ảnh không được để trống", -1);
+            }
+            const endpoint = this.client.endpoints.message.send;
+            const request = {
+                recipient,
+                message,
+                messaging_type: "consultation",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send consultation image message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send consultation image message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn tư vấn file đính kèm
+     * @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 file
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendFileMessage(accessToken, recipient, message) {
+        try {
+            if (!message.attachment?.payload?.url) {
+                throw new common_1.ZaloSDKError("URL file không được để trống", -1);
+            }
+            const endpoint = this.client.endpoints.message.send;
+            const request = {
+                recipient,
+                message,
+                messaging_type: "consultation",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send consultation file message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send consultation file message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn tư vấn sticker
+     * @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 sticker
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendStickerMessage(accessToken, recipient, message) {
+        try {
+            if (!message.attachment?.payload?.id) {
+                throw new common_1.ZaloSDKError("ID sticker không được để trống", -1);
+            }
+            const endpoint = this.client.endpoints.message.send;
+            const request = {
+                recipient,
+                message,
+                messaging_type: "consultation",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send consultation sticker message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send consultation sticker message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn tư vấn tổng quát
+     * @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
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendMessage(accessToken, recipient, message) {
+        try {
+            const endpoint = this.client.endpoints.message.send;
+            const request = {
+                recipient,
+                message,
+                messaging_type: "consultation",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send consultation message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send consultation message: ${error.message}`, -1, error);
+        }
+    }
+}
+exports.ConsultationService = ConsultationService;
+//# sourceMappingURL=consultation.service.js.map

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

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

package/dist/services/general-message.service.d.ts

@@ -0,0 +1,85 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { Message, SendMessageResponse, UploadFileResponse, TextMessage, ImageMessage, MessageRecipient, AnonymousTextMessage } from "../types/message";
+/**
+ * Service xử lý các API tin nhắn tổng quát của Zalo Official Account
+ *
+ * Bao gồm các loại tin nhắn:
+ * - Tin nhắn phản hồi (Response Message)
+ * - Tin nhắn ẩn danh (Anonymous Message)
+ * - Tin nhắn tự động (Auto Message)
+ * - Tin nhắn hệ thống (System Message)
+ *
+ * ĐIỀU KIỆN GỬI TIN NHẮN TỔNG QUÁT:
+ *
+ * 1. TIN NHẮN PHẢN HỒI:
+ *    - Chỉ được gửi trong vòng 24 giờ kể từ khi người dùng gửi tin nhắn đến OA
+ *    - Không giới hạn số lượng tin nhắn phản hồi
+ *    - Có thể chứa bất kỳ nội dung nào (tư vấn, quảng cáo, thông tin)
+ *
+ * 2. TIN NHẮN ẨN DANH:
+ *    - Gửi tin nhắn mà không hiển thị thông tin OA
+ *    - Chỉ dành cho các trường hợp đặc biệt
+ *    - Cần được Zalo phê duyệt trước khi sử dụng
+ *
+ * 3. TIN NHẮN TỰ ĐỘNG:
+ *    - Tin nhắn được gửi tự động dựa trên trigger
+ *    - Bao gồm: tin chào mừng, tin cảm ơn, tin nhắc nhở
+ *
+ * 4. TIN NHẮN HỆ THỐNG:
+ *    - Tin nhắn thông báo từ hệ thống
+ *    - Bao gồm: thông báo bảo trì, cập nhật chính sách
+ */
+export declare class GeneralMessageService {
+    private readonly client;
+    constructor(client: ZaloClient);
+    /**
+     * Gửi tin nhắn phản hồi văn bản
+     * @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 văn bản
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendResponseTextMessage(accessToken: string, recipient: MessageRecipient, message: TextMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn phản hồi hình ảnh
+     * @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 hình ảnh
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendResponseImageMessage(accessToken: string, recipient: MessageRecipient, message: ImageMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn ẩn danh
+     * @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 ẩn danh
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendAnonymousMessage(accessToken: string, recipient: MessageRecipient, message: AnonymousTextMessage): Promise<SendMessageResponse>;
+    /**
+     * Upload file để sử dụng trong tin nhắn
+     * @param accessToken Access token của Official Account
+     * @param file File data (base64 hoặc buffer)
+     * @param fileName Tên file
+     * @returns Thông tin file đã upload
+     */
+    uploadFile(accessToken: string, file: string | Buffer, fileName: string): Promise<UploadFileResponse>;
+    /**
+     * Upload hình ảnh để sử dụng trong tin nhắn
+     * @param accessToken Access token của Official Account
+     * @param image Image data (base64 hoặc buffer)
+     * @param fileName Tên file hình ảnh
+     * @returns Thông tin hình ảnh đã upload
+     */
+    uploadImage(accessToken: string, image: string | Buffer, fileName: string): Promise<UploadFileResponse>;
+    /**
+     * Gửi tin nhắn tổng quát
+     * @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
+     * @param messagingType Loại tin nhắn (response, update, message_tag)
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendMessage(accessToken: string, recipient: MessageRecipient, message: Message, messagingType?: "consultation" | "transaction" | "promotion" | "response" | "update" | "message_tag"): Promise<SendMessageResponse>;
+}
+//# sourceMappingURL=general-message.service.d.ts.map

package/dist/services/general-message.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general-message.service.d.ts","sourceRoot":"","sources":["../../src/services/general-message.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,OAAO,EAEP,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,EAGZ,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACU,uBAAuB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAgD/B;;;;;;OAMG;IACU,wBAAwB,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,mBAAmB,CAAC;IAyC/B;;;;;;OAMG;IACU,oBAAoB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IA2C/B;;;;;;OAMG;IACU,UAAU,CACrB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC;IA0C9B;;;;;;OAMG;IACU,WAAW,CACtB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC;IA0C9B;;;;;;;OAOG;IACU,WAAW,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,OAAO,EAChB,aAAa,GACT,cAAc,GACd,aAAa,GACb,WAAW,GACX,UAAU,GACV,QAAQ,GACR,aAA0B,GAC7B,OAAO,CAAC,mBAAmB,CAAC;CAoChC"}