@warriorteam/redai-zalo-sdk 1.1.0

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

@@ -0,0 +1,102 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { GroupTextMessage, GroupImageMessage, GroupFileMessage, GroupStickerMessage, GroupMentionMessage, GroupMessageResult, GroupInfo, GroupMember } from "../types/group";
+/**
+ * Service for handling Zalo Official Account Group Message Framework (GMF) APIs
+ *
+ * CONDITIONS FOR USING ZALO GMF:
+ *
+ * 1. OPT-IN CONDITIONS FOR SENDING GROUP MESSAGES:
+ *    - OA must have the group_id of the chat group
+ *    - OA must be added to the chat group by group admin
+ *    - OA must have permission to send messages in the group (granted by group admin)
+ *    - Chat group must be active (not locked or disbanded)
+ *
+ * 2. ACCESS PERMISSIONS:
+ *    - Application needs to be granted group chat management permissions
+ *    - Access token must have "manage_group" scope or equivalent
+ *    - OA must be authenticated and have active status
+ *
+ * 3. LIMITS AND CONSTRAINTS:
+ *    - Can only send messages to groups that OA has joined
+ *    - Cannot send messages to private groups that OA hasn't been invited to
+ *    - Must comply with Zalo's message sending frequency limits
+ *    - Message content must comply with Zalo's content policy
+ *
+ * 4. SUPPORTED MESSAGE TYPES:
+ *    - Text message: Plain text messages
+ *    - Image message: Image messages (JPG, PNG, GIF - max 5MB)
+ *    - File message: File attachments (max 25MB)
+ *    - Sticker message: Stickers from Zalo collection
+ *    - Mention message: Tag/mention specific members
+ *
+ * 5. TECHNICAL REQUIREMENTS:
+ *    - Use HTTPS for all API calls
+ *    - Content-Type: application/json for text/mention messages
+ *    - Content-Type: multipart/form-data for file/image uploads
+ */
+export declare class GroupMessageService {
+    private readonly client;
+    private readonly apiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Send text message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Text message content
+     * @returns Send result
+     */
+    sendTextMessage(accessToken: string, groupId: string, message: GroupTextMessage): Promise<GroupMessageResult>;
+    /**
+     * Send image message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Image message content
+     * @returns Send result
+     */
+    sendImageMessage(accessToken: string, groupId: string, message: GroupImageMessage): Promise<GroupMessageResult>;
+    /**
+     * Send file message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message File message content
+     * @returns Send result
+     */
+    sendFileMessage(accessToken: string, groupId: string, message: GroupFileMessage): Promise<GroupMessageResult>;
+    /**
+     * Send sticker message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Sticker message content
+     * @returns Send result
+     */
+    sendStickerMessage(accessToken: string, groupId: string, message: GroupStickerMessage): Promise<GroupMessageResult>;
+    /**
+     * Send mention message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Mention message content
+     * @returns Send result
+     */
+    sendMentionMessage(accessToken: string, groupId: string, message: GroupMentionMessage): Promise<GroupMessageResult>;
+    /**
+     * Get group information
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @returns Group information
+     */
+    getGroupInfo(accessToken: string, groupId: string): Promise<GroupInfo>;
+    /**
+     * Get group members
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param offset Offset for pagination
+     * @param count Number of members to retrieve
+     * @returns Group members list
+     */
+    getGroupMembers(accessToken: string, groupId: string, offset?: number, count?: number): Promise<{
+        members: GroupMember[];
+        total: number;
+    }>;
+    private handleGroupMessageError;
+}
+//# sourceMappingURL=group-message.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-message.service.d.ts","sourceRoot":"","sources":["../../src/services/group-message.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,EACT,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAE/B,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAwB9B;;;;;;OAMG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAmC9B;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC;IA6B9B;;;;;;OAMG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAmC9B;;;;;;OAMG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAyB9B;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmB5E;;;;;;;OAOG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBrD,OAAO,CAAC,uBAAuB;CAWhC"}

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

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupMessageService = void 0;
+/**
+ * Service for handling Zalo Official Account Group Message Framework (GMF) APIs
+ *
+ * CONDITIONS FOR USING ZALO GMF:
+ *
+ * 1. OPT-IN CONDITIONS FOR SENDING GROUP MESSAGES:
+ *    - OA must have the group_id of the chat group
+ *    - OA must be added to the chat group by group admin
+ *    - OA must have permission to send messages in the group (granted by group admin)
+ *    - Chat group must be active (not locked or disbanded)
+ *
+ * 2. ACCESS PERMISSIONS:
+ *    - Application needs to be granted group chat management permissions
+ *    - Access token must have "manage_group" scope or equivalent
+ *    - OA must be authenticated and have active status
+ *
+ * 3. LIMITS AND CONSTRAINTS:
+ *    - Can only send messages to groups that OA has joined
+ *    - Cannot send messages to private groups that OA hasn't been invited to
+ *    - Must comply with Zalo's message sending frequency limits
+ *    - Message content must comply with Zalo's content policy
+ *
+ * 4. SUPPORTED MESSAGE TYPES:
+ *    - Text message: Plain text messages
+ *    - Image message: Image messages (JPG, PNG, GIF - max 5MB)
+ *    - File message: File attachments (max 25MB)
+ *    - Sticker message: Stickers from Zalo collection
+ *    - Mention message: Tag/mention specific members
+ *
+ * 5. TECHNICAL REQUIREMENTS:
+ *    - Use HTTPS for all API calls
+ *    - Content-Type: application/json for text/mention messages
+ *    - Content-Type: multipart/form-data for file/image uploads
+ */
+class GroupMessageService {
+    constructor(client) {
+        this.client = client;
+        this.apiUrl = "https://openapi.zalo.me/v3.0/oa";
+    }
+    /**
+     * Send text message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Text message content
+     * @returns Send result
+     */
+    async sendTextMessage(accessToken, groupId, message) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/message/group`, accessToken, {
+                recipient: {
+                    group_id: groupId,
+                },
+                message: {
+                    text: message.text,
+                },
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to send text message to group");
+        }
+    }
+    /**
+     * Send image message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Image message content
+     * @returns Send result
+     */
+    async sendImageMessage(accessToken, groupId, message) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/message/group`, accessToken, {
+                recipient: {
+                    group_id: groupId,
+                },
+                message: {
+                    attachment: {
+                        type: "template",
+                        payload: {
+                            template_type: "media",
+                            elements: [
+                                {
+                                    media_type: "image",
+                                    url: message.imageUrl,
+                                },
+                            ],
+                        },
+                    },
+                },
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to send image message to group");
+        }
+    }
+    /**
+     * Send file message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message File message content
+     * @returns Send result
+     */
+    async sendFileMessage(accessToken, groupId, message) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/message/group`, accessToken, {
+                recipient: {
+                    group_id: groupId,
+                },
+                message: {
+                    attachment: {
+                        type: "file",
+                        payload: {
+                            url: message.fileUrl,
+                        },
+                    },
+                },
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to send file message to group");
+        }
+    }
+    /**
+     * Send sticker message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Sticker message content
+     * @returns Send result
+     */
+    async sendStickerMessage(accessToken, groupId, message) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/message/group`, accessToken, {
+                recipient: {
+                    group_id: groupId,
+                },
+                message: {
+                    attachment: {
+                        type: "template",
+                        payload: {
+                            template_type: "media",
+                            elements: [
+                                {
+                                    media_type: "sticker",
+                                    attachment_id: message.stickerId,
+                                },
+                            ],
+                        },
+                    },
+                },
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to send sticker message to group");
+        }
+    }
+    /**
+     * Send mention message to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param message Mention message content
+     * @returns Send result
+     */
+    async sendMentionMessage(accessToken, groupId, message) {
+        try {
+            const response = await this.client.apiPost(`${this.apiUrl}/message/group`, accessToken, {
+                recipient: {
+                    group_id: groupId,
+                },
+                message: {
+                    text: message.text,
+                    mention: message.mentions,
+                },
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to send mention message to group");
+        }
+    }
+    /**
+     * Get group information
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @returns Group information
+     */
+    async getGroupInfo(accessToken, groupId) {
+        try {
+            const response = await this.client.apiGet(`${this.apiUrl}/group/getinfo`, accessToken, {
+                group_id: groupId,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to get group information");
+        }
+    }
+    /**
+     * Get group members
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param offset Offset for pagination
+     * @param count Number of members to retrieve
+     * @returns Group members list
+     */
+    async getGroupMembers(accessToken, groupId, offset = 0, count = 50) {
+        try {
+            const response = await this.client.apiGet(`${this.apiUrl}/group/getmembers`, accessToken, {
+                group_id: groupId,
+                offset,
+                count,
+            });
+            return response;
+        }
+        catch (error) {
+            throw this.handleGroupMessageError(error, "Failed to get group members");
+        }
+    }
+    handleGroupMessageError(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.GroupMessageService = GroupMessageService;
+//# sourceMappingURL=group-message.service.js.map

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

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

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

@@ -0,0 +1,135 @@
+import { ZaloClient } from "../clients/zalo-client";
+/**
+ * Interface cho thông tin quota tin nhắn
+ */
+export interface MessageQuotaInfo {
+    quota: number;
+    used: number;
+    remaining: number;
+    reset_time: number;
+}
+/**
+ * Interface cho tin nhắn trong cuộc hội thoại
+ */
+export interface ConversationMessage {
+    message_id: string;
+    from_id: string;
+    to_id: string;
+    message: {
+        text?: string;
+        attachment?: {
+            type: string;
+            payload: any;
+        };
+    };
+    timestamp: number;
+    type: "incoming" | "outgoing";
+}
+/**
+ * Interface cho cuộc hội thoại
+ */
+export interface Conversation {
+    conversation_id: string;
+    user_id: string;
+    last_message: ConversationMessage;
+    unread_count: number;
+    updated_time: number;
+}
+/**
+ * Interface cho kết quả upload file
+ */
+export interface UploadResult {
+    attachment_id: string;
+    url: string;
+    type: string;
+    size: number;
+}
+/**
+ * Interface cho thông tin phân trang tin nhắn
+ */
+export interface MessagePagination {
+    offset: number;
+    count: number;
+    total: number;
+}
+/**
+ * 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
+ */
+export declare class MessageManagementService {
+    private readonly client;
+    private readonly baseApiUrl;
+    private readonly uploadApiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * 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
+     */
+    checkMessageQuota(accessToken: string, userId: string): Promise<MessageQuotaInfo>;
+    /**
+     * 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
+     */
+    getConversationMessages(accessToken: string, userId: string, offset?: number, count?: number): Promise<{
+        messages: ConversationMessage[];
+        pagination: MessagePagination;
+    }>;
+    /**
+     * 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
+     */
+    getRecentConversations(accessToken: string, offset?: number, count?: number): Promise<{
+        conversations: Conversation[];
+        pagination: MessagePagination;
+    }>;
+    /**
+     * 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
+     */
+    uploadFile(accessToken: string, fileData: string | Buffer, fileName: string): Promise<UploadResult>;
+    /**
+     * 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
+     */
+    uploadImage(accessToken: string, imageData: string | Buffer, fileName: string): Promise<UploadResult>;
+}
+//# sourceMappingURL=message-management.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-management.service.d.ts","sourceRoot":"","sources":["../../src/services/message-management.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE;YACX,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,GAAG,CAAC;SACd,CAAC;KACH,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,mBAAmB,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,wBAAwB;IAIvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;gBAE5C,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAiC5B;;;;;;;OAOG;IACG,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;QACT,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QAChC,UAAU,EAAE,iBAAiB,CAAC;KAC/B,CAAC;IAmDF;;;;;;OAMG;IACG,sBAAsB,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;QACT,aAAa,EAAE,YAAY,EAAE,CAAC;QAC9B,UAAU,EAAE,iBAAiB,CAAC;KAC/B,CAAC;IAkDF;;;;;;OAMG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;IA0DxB;;;;;;OAMG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;CAgEzB"}