@warriorteam/redai-zalo-sdk 1.1.0

package/dist/services/promotion.service.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionService = void 0;
+const common_1 = require("../types/common");
+/**
+ * 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
+ */
+class PromotionService {
+    constructor(client) {
+        this.client = client;
+        this.promotionApiUrl = "https://openapi.zalo.me/v2.0/oa/message/promotion";
+    }
+    /**
+     * 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
+     */
+    async sendPromotionMessage(accessToken, recipient, message) {
+        try {
+            // Validate promotion message
+            this.validatePromotionMessage(message);
+            // Check sending time (8:00 - 22:00)
+            this.validateSendingTime();
+            const request = {
+                recipient,
+                message,
+            };
+            const result = await this.client.apiPost(this.promotionApiUrl, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send promotion 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 promotion message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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
+     */
+    async sendProductPromotion(accessToken, recipient, promotionInfo) {
+        try {
+            const message = {
+                type: "promotion",
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "promotion",
+                        elements: [
+                            {
+                                title: promotionInfo.title,
+                                subtitle: promotionInfo.description,
+                                image_url: promotionInfo.imageUrl,
+                                default_action: {
+                                    type: "web_url",
+                                    url: promotionInfo.productUrl,
+                                },
+                                buttons: [
+                                    {
+                                        type: "web_url",
+                                        title: "Mua ngay",
+                                        url: promotionInfo.productUrl,
+                                    },
+                                    {
+                                        type: "postback",
+                                        title: "Xem thêm",
+                                        payload: `VIEW_PRODUCT_${Date.now()}`,
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            };
+            return this.sendPromotionMessage(accessToken, recipient, message);
+        }
+        catch (error) {
+            throw new common_1.ZaloSDKError(`Failed to send product promotion: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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
+     */
+    async sendEventNotification(accessToken, recipient, eventInfo) {
+        try {
+            const message = {
+                type: "promotion",
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "promotion",
+                        elements: [
+                            {
+                                title: eventInfo.title,
+                                subtitle: `${eventInfo.description}\n📅 ${eventInfo.eventDate}\n📍 ${eventInfo.location}`,
+                                image_url: eventInfo.imageUrl,
+                                default_action: {
+                                    type: "web_url",
+                                    url: eventInfo.registrationUrl,
+                                },
+                                buttons: [
+                                    {
+                                        type: "web_url",
+                                        title: "Đăng ký tham gia",
+                                        url: eventInfo.registrationUrl,
+                                    },
+                                    {
+                                        type: "postback",
+                                        title: "Chia sẻ",
+                                        payload: `SHARE_EVENT_${Date.now()}`,
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            };
+            return this.sendPromotionMessage(accessToken, recipient, message);
+        }
+        catch (error) {
+            throw new common_1.ZaloSDKError(`Failed to send event notification: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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
+     */
+    async sendNewsletter(accessToken, recipient, newsletterInfo) {
+        try {
+            const message = {
+                type: "promotion",
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "promotion",
+                        elements: [
+                            {
+                                title: newsletterInfo.title,
+                                subtitle: newsletterInfo.summary,
+                                image_url: newsletterInfo.imageUrl,
+                                buttons: [
+                                    {
+                                        type: "web_url",
+                                        title: "Đọc toàn bộ",
+                                        url: newsletterInfo.articles[0]?.url || "#",
+                                    },
+                                    {
+                                        type: "web_url",
+                                        title: "Hủy đăng ký",
+                                        url: newsletterInfo.unsubscribeUrl,
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            };
+            return this.sendPromotionMessage(accessToken, recipient, message);
+        }
+        catch (error) {
+            throw new common_1.ZaloSDKError(`Failed to send newsletter: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Validate promotion message format
+     * @param message Promotion message to validate
+     */
+    validatePromotionMessage(message) {
+        if (!message.attachment) {
+            throw new common_1.ZaloSDKError("Promotion message must have attachment", -1);
+        }
+        if (!message.attachment.payload) {
+            throw new common_1.ZaloSDKError("Promotion message attachment must have payload", -1);
+        }
+        if (message.attachment.payload.template_type !== "promotion") {
+            throw new common_1.ZaloSDKError("Promotion message must use promotion template type", -1);
+        }
+    }
+    /**
+     * Validate sending time (8:00 - 22:00)
+     */
+    validateSendingTime() {
+        const now = new Date();
+        const hour = now.getHours();
+        if (hour < 8 || hour >= 22) {
+            throw new common_1.ZaloSDKError("Tin nhắn truyền thông chỉ được gửi trong khung giờ từ 8:00 - 22:00", 2001);
+        }
+    }
+}
+exports.PromotionService = PromotionService;
+//# sourceMappingURL=promotion.service.js.map

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

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

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

@@ -0,0 +1,144 @@
+import { ZaloClient } from "../clients/zalo-client";
+/**
+ * Service for managing Zalo OA user tags
+ * Provides comprehensive tag management capabilities
+ */
+export declare class TagService {
+    private readonly client;
+    private readonly apiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Get all tags of the OA
+     * @param accessToken OA access token
+     * @returns List of all tags
+     */
+    getAllTags(accessToken: string): Promise<{
+        error: number;
+        message: string;
+        data?: Array<{
+            tag_name: string;
+            tag_id?: string;
+            user_count?: number;
+        }>;
+    }>;
+    /**
+     * Get tags of a specific user
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @returns User's tags
+     */
+    getUserTags(accessToken: string, userId: string): Promise<{
+        error: number;
+        message: string;
+        data?: Array<{
+            tag_name: string;
+            tag_id?: string;
+        }>;
+    }>;
+    /**
+     * Create a new tag
+     * @param accessToken OA access token
+     * @param tagName Tag name
+     * @returns Created tag information
+     */
+    createTag(accessToken: string, tagName: string): Promise<{
+        error: number;
+        message: string;
+        data?: {
+            tag_name: string;
+            tag_id?: string;
+        };
+    }>;
+    /**
+     * Delete a tag
+     * @param accessToken OA access token
+     * @param tagName Tag name to delete
+     * @returns Deletion result
+     */
+    deleteTag(accessToken: string, tagName: string): Promise<{
+        error: number;
+        message: string;
+    }>;
+    /**
+     * Tag a user with specific tags
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param tagNames Array of tag names
+     * @returns Tagging result
+     */
+    tagUser(accessToken: string, userId: string, tagNames: string[]): Promise<{
+        error: number;
+        message: string;
+    }>;
+    /**
+     * Remove tags from a user
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param tagNames Array of tag names to remove
+     * @returns Untagging result
+     */
+    untagUser(accessToken: string, userId: string, tagNames: string[]): Promise<{
+        error: number;
+        message: string;
+    }>;
+    /**
+     * Get users by tag
+     * @param accessToken OA access token
+     * @param tagName Tag name
+     * @param offset Offset for pagination
+     * @param count Number of users to retrieve
+     * @returns Users with the specified tag
+     */
+    getUsersByTag(accessToken: string, tagName: string, offset?: number, count?: number): Promise<{
+        error: number;
+        message: string;
+        data?: {
+            users: Array<{
+                user_id: string;
+                user_id_by_app?: string;
+                display_name: string;
+                avatar?: string;
+                user_is_follower: boolean;
+            }>;
+            total: number;
+        };
+    }>;
+    /**
+     * Bulk tag multiple users
+     * @param accessToken OA access token
+     * @param userIds Array of user IDs
+     * @param tagNames Array of tag names
+     * @returns Bulk tagging result
+     */
+    bulkTagUsers(accessToken: string, userIds: string[], tagNames: string[]): Promise<{
+        error: number;
+        message: string;
+        data?: {
+            successful_users: string[];
+            failed_users: Array<{
+                user_id: string;
+                error: string;
+            }>;
+        };
+    }>;
+    /**
+     * Bulk untag multiple users
+     * @param accessToken OA access token
+     * @param userIds Array of user IDs
+     * @param tagNames Array of tag names to remove
+     * @returns Bulk untagging result
+     */
+    bulkUntagUsers(accessToken: string, userIds: string[], tagNames: string[]): Promise<{
+        error: number;
+        message: string;
+        data?: {
+            successful_users: string[];
+            failed_users: Array<{
+                user_id: string;
+                error: string;
+            }>;
+        };
+    }>;
+    private handleTagError;
+}
+//# sourceMappingURL=tag.service.d.ts.map

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

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

package/dist/services/tag.service.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagService = void 0;
+/**
+ * Service for managing Zalo OA user tags
+ * Provides comprehensive tag management capabilities
+ */
+class TagService {
+    constructor(client) {
+        this.client = client;
+        this.apiUrl = "https://openapi.zalo.me/v3.0/oa";
+    }
+    /**
+     * Get all tags of the OA
+     * @param accessToken OA access token
+     * @returns List of all tags
+     */
+    async getAllTags(accessToken) {
+        try {
+            const response = await this.client.apiGet(`${this.apiUrl}/tag/gettagsofoa`, accessToken);
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to get all tags");
+        }
+    }
+    /**
+     * Get tags of a specific user
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @returns User's tags
+     */
+    async getUserTags(accessToken, userId) {
+        try {
+            const response = await this.client.apiGet(`${this.apiUrl}/tag/gettagsofuser`, accessToken, {
+                user_id: userId,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to get user tags");
+        }
+    }
+    /**
+     * Create a new tag
+     * @param accessToken OA access token
+     * @param tagName Tag name
+     * @returns Created tag information
+     */
+    async createTag(accessToken, tagName) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/tag/create`, accessToken, {
+                tag_name: tagName,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to create tag");
+        }
+    }
+    /**
+     * Delete a tag
+     * @param accessToken OA access token
+     * @param tagName Tag name to delete
+     * @returns Deletion result
+     */
+    async deleteTag(accessToken, tagName) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/tag/delete`, accessToken, {
+                tag_name: tagName,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to delete tag");
+        }
+    }
+    /**
+     * Tag a user with specific tags
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param tagNames Array of tag names
+     * @returns Tagging result
+     */
+    async tagUser(accessToken, userId, tagNames) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/tag/taguser`, accessToken, {
+                user_id: userId,
+                tag_names: tagNames,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to tag user");
+        }
+    }
+    /**
+     * Remove tags from a user
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param tagNames Array of tag names to remove
+     * @returns Untagging result
+     */
+    async untagUser(accessToken, userId, tagNames) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/tag/rmtaguser`, accessToken, {
+                user_id: userId,
+                tag_names: tagNames,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to untag user");
+        }
+    }
+    /**
+     * Get users by tag
+     * @param accessToken OA access token
+     * @param tagName Tag name
+     * @param offset Offset for pagination
+     * @param count Number of users to retrieve
+     * @returns Users with the specified tag
+     */
+    async getUsersByTag(accessToken, tagName, offset = 0, count = 50) {
+        try {
+            const response = await this.client.apiGet(`${this.apiUrl}/tag/getusersoftag`, accessToken, {
+                tag_name: tagName,
+                offset,
+                count,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to get users by tag");
+        }
+    }
+    /**
+     * Bulk tag multiple users
+     * @param accessToken OA access token
+     * @param userIds Array of user IDs
+     * @param tagNames Array of tag names
+     * @returns Bulk tagging result
+     */
+    async bulkTagUsers(accessToken, userIds, tagNames) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/tag/bulktagusers`, accessToken, {
+                user_ids: userIds,
+                tag_names: tagNames,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to bulk tag users");
+        }
+    }
+    /**
+     * Bulk untag multiple users
+     * @param accessToken OA access token
+     * @param userIds Array of user IDs
+     * @param tagNames Array of tag names to remove
+     * @returns Bulk untagging result
+     */
+    async bulkUntagUsers(accessToken, userIds, tagNames) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/tag/bulkuntagusers`, accessToken, {
+                user_ids: userIds,
+                tag_names: tagNames,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleTagError(error, "Failed to bulk untag users");
+        }
+    }
+    handleTagError(error, defaultMessage) {
+        if (error.response?.data) {
+            const errorData = error.response.data;
+            return new Error(`${defaultMessage}: ${errorData.message || errorData.error || "Unknown error"}`);
+        }
+        return new Error(`${defaultMessage}: ${error.message || "Unknown error"}`);
+    }
+}
+exports.TagService = TagService;
+//# sourceMappingURL=tag.service.js.map

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

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