@warriorteam/redai-zalo-sdk 1.1.0

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

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneralMessageService = void 0;
+const common_1 = require("../types/common");
+/**
+ * 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
+ */
+class GeneralMessageService {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 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
+     */
+    async sendResponseTextMessage(accessToken, recipient, message) {
+        try {
+            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: "response",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send response 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 response text message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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
+     */
+    async sendResponseImageMessage(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: "response",
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send response 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 response image message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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
+     */
+    async sendAnonymousMessage(accessToken, recipient, message) {
+        try {
+            if (!message.text || message.text.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Nội dung tin nhắn ẩn danh không được để trống", -1);
+            }
+            const endpoint = this.client.endpoints.message.sendAnonymous;
+            const request = {
+                recipient,
+                message,
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send anonymous 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 anonymous message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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
+     */
+    async uploadFile(accessToken, file, fileName) {
+        try {
+            const endpoint = this.client.endpoints.upload.file;
+            const formData = new FormData();
+            if (typeof file === "string") {
+                // Base64 string
+                const buffer = Buffer.from(file, "base64");
+                formData.append("file", new Blob([new Uint8Array(buffer)]), fileName);
+            }
+            else {
+                // Buffer
+                formData.append("file", new Blob([new Uint8Array(file)]), fileName);
+            }
+            const result = await this.client.apiPost(endpoint, 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 response data 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 image Image data (base64 hoặc buffer)
+     * @param fileName Tên file hình ảnh
+     * @returns Thông tin hình ảnh đã upload
+     */
+    async uploadImage(accessToken, image, fileName) {
+        try {
+            const endpoint = this.client.endpoints.upload.image;
+            const formData = new FormData();
+            if (typeof image === "string") {
+                // Base64 string
+                const buffer = Buffer.from(image, "base64");
+                formData.append("file", new Blob([new Uint8Array(buffer)]), fileName);
+            }
+            else {
+                // Buffer
+                formData.append("file", new Blob([new Uint8Array(image)]), fileName);
+            }
+            const result = await this.client.apiPost(endpoint, 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 response data 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);
+        }
+    }
+    /**
+     * 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
+     */
+    async sendMessage(accessToken, recipient, message, messagingType = "response") {
+        try {
+            const endpoint = this.client.endpoints.message.send;
+            const request = {
+                recipient,
+                message,
+                messaging_type: messagingType,
+            };
+            const result = await this.client.apiPost(endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send 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 message: ${error.message}`, -1, error);
+        }
+    }
+}
+exports.GeneralMessageService = GeneralMessageService;
+//# sourceMappingURL=general-message.service.js.map

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

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

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

@@ -0,0 +1,220 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { GroupCreateRequest, GroupCreateResult, GroupUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupAdminActionRequest, GroupQuota, GroupRecentChat, GroupConversationMessage, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersResponse, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageResponse } from "../types/group";
+import { GMFProductType, QuotaType } from "../types/oa";
+/**
+ * Service for handling Zalo Official Account Group Management Framework (GMF) APIs
+ *
+ * CONDITIONS FOR USING ZALO GMF GROUP MANAGEMENT:
+ *
+ * 1. GENERAL CONDITIONS:
+ *    - OA must be granted permission to use GMF (Group Message Framework) feature
+ *    - Access token must have "manage_group" and "group_message" scopes
+ *    - OA must have active status and be verified
+ *    - Must comply with limits on number of groups and members
+ *
+ * 2. CREATE NEW GROUP:
+ *    - Group name: required, max 100 characters, no special characters
+ *    - Description: optional, max 500 characters
+ *    - Avatar: optional, JPG/PNG format, max 5MB
+ *    - Initial members: max 200 people, must be users who have interacted with OA
+ *    - OA automatically becomes admin of the group
+ *
+ * 3. MEMBER MANAGEMENT:
+ *    - Only admins can invite/remove members
+ *    - Invite members: max 50 people per time, users must have interacted with OA
+ *    - Remove members: cannot remove other admins, must have at least 1 admin
+ *    - Members can leave group themselves
+ *
+ * 4. ADMIN MANAGEMENT:
+ *    - Only current admins can add/remove other admins
+ *    - Must have at least 1 admin in group
+ *    - OA always has admin rights and cannot be removed
+ *
+ * 5. LIMITS AND CONSTRAINTS:
+ *    - Maximum groups: according to service package (usually 10-100 groups)
+ *    - Maximum members per group: 200 people
+ *    - Group creation frequency: max 10 groups/day
+ *    - Member invitation frequency: max 500 invitations/day
+ */
+export declare class GroupManagementService {
+    private readonly client;
+    private readonly apiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Create new group chat with asset_id
+     * @param accessToken OA access token
+     * @param groupData Group information to create
+     * @returns Created group information
+     */
+    createGroup(accessToken: string, groupData: GroupCreateRequest): Promise<GroupCreateResult>;
+    /**
+     * Get detailed group information
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @returns Detailed group information including group_info, asset_info and group_setting
+     */
+    getGroupInfo(accessToken: string, groupId: string): Promise<GroupDetailResponse["data"]>;
+    /**
+     * Update group information
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param updateData Information to update
+     * @returns Update result
+     */
+    updateGroupInfo(accessToken: string, groupId: string, updateData: GroupUpdateRequest): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Update group avatar
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param avatarData New avatar information
+     * @returns Update result
+     */
+    updateGroupAvatar(accessToken: string, groupId: string, avatarData: GroupAvatarUpdateRequest): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Invite members to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param inviteData List of user IDs to invite
+     * @returns Invitation result
+     */
+    inviteMembers(accessToken: string, groupId: string, inviteData: GroupMemberInviteRequest): Promise<{
+        success: boolean;
+        invited_count: number;
+    }>;
+    /**
+     * Get list of pending members
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param offset Offset for pagination (default: 0)
+     * @param count Maximum number to return (default: 20, max: 50)
+     * @returns List of pending members
+     */
+    getPendingMembers(accessToken: string, groupId: string, offset?: number, count?: number): Promise<GroupPendingMembersResponse>;
+    /**
+     * Accept pending members to group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param memberUserIds List of user IDs to accept
+     * @returns Accept result
+     */
+    acceptPendingMembers(accessToken: string, groupId: string, memberUserIds: string[]): Promise<GroupAcceptPendingMembersResponse>;
+    /**
+     * Reject pending members from group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param memberUserIds List of user IDs to reject
+     * @returns Reject result
+     */
+    rejectPendingMembers(accessToken: string, groupId: string, memberUserIds: string[]): Promise<GroupAcceptPendingMembersResponse>;
+    /**
+     * Remove members from group
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param memberUserIds List of user IDs to remove
+     * @returns Remove result
+     */
+    removeMembers(accessToken: string, groupId: string, memberUserIds: string[]): Promise<GroupRemoveMembersResponse>;
+    /**
+     * Add admin rights to members
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param adminData List of user IDs to add admin rights
+     * @returns Add admin result
+     */
+    addAdmins(accessToken: string, groupId: string, adminData: GroupAdminActionRequest): Promise<{
+        error: number;
+        message: string;
+    }>;
+    /**
+     * Remove admin rights from members
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param adminData List of user IDs to remove admin rights
+     * @returns Remove admin result
+     */
+    removeAdmins(accessToken: string, groupId: string, adminData: GroupAdminActionRequest): Promise<{
+        error: number;
+        message: string;
+    }>;
+    /**
+     * Delete group chat (Disband group)
+     * @param accessToken OA access token
+     * @param groupId Group ID to delete
+     * @returns Delete result
+     */
+    deleteGroup(accessToken: string, groupId: string): Promise<{
+        error: number;
+        message: string;
+    }>;
+    /**
+     * Get list of OA groups
+     * @param accessToken OA access token
+     * @param offset Offset for pagination (default: 0)
+     * @param count Maximum number to return (default: 20, max: 50)
+     * @returns List of OA groups
+     */
+    getGroupsOfOA(accessToken: string, offset?: number, count?: number): Promise<{
+        groups: any[];
+        total: number;
+    }>;
+    /**
+     * Get group quota information and asset_id
+     * @param accessToken OA access token
+     * @param productType Product type (optional)
+     * @param quotaType Quota type (optional)
+     * @returns Group quota information including asset_id
+     */
+    getGroupQuota(accessToken: string, productType?: GMFProductType, quotaType?: QuotaType): Promise<GroupQuota>;
+    /**
+     * Get asset_id for creating GMF group
+     * @param accessToken OA access token
+     * @returns Asset_id for group creation
+     */
+    getAssetId(accessToken: string): Promise<string>;
+    /**
+     * Get list of asset_ids available for creating GMF groups
+     * @param accessToken OA access token
+     * @returns List of asset_ids and quota information
+     */
+    getAssetIds(accessToken: string): Promise<GroupQuotaMessageResponse>;
+    /**
+     * Get list of recent chats
+     * @param accessToken OA access token
+     * @param offset Offset for pagination (default: 0)
+     * @param count Maximum number to return (default: 20, max: 50)
+     * @returns List of recent chats
+     */
+    getRecentChats(accessToken: string, offset?: number, count?: number): Promise<{
+        chats: GroupRecentChat[];
+        total: number;
+    }>;
+    /**
+     * Get group conversation history
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param offset Offset for pagination (default: 0)
+     * @param count Maximum number of messages to return (default: 20, max: 100)
+     * @param fromTime Start time (Unix timestamp, optional)
+     * @param toTime End time (Unix timestamp, optional)
+     * @returns Group conversation history
+     */
+    getGroupConversation(accessToken: string, groupId: string, offset?: number, count?: number, fromTime?: number, toTime?: number): Promise<{
+        messages: GroupConversationMessage[];
+        total: number;
+    }>;
+    /**
+     * Get group members list from Zalo API
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param offset Offset for pagination (default: 0)
+     * @param count Maximum number to return (default: 5, max: 50)
+     * @returns Group members list
+     */
+    getGroupMembers(accessToken: string, groupId: string, offset?: number, count?: number): Promise<GroupMembersResponse>;
+    private handleGroupManagementError;
+}
+//# sourceMappingURL=group-management.service.d.ts.map

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

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