@warriorteam/redai-zalo-sdk 1.3.0 → 1.4.1

package/docs/WEBHOOK_EVENTS.md

@@ -1,5 +1,46 @@
 # Webhook Events Documentation
 
+> Source of truth: The full, strongly-typed webhook definitions live in `src/types/webhook.ts`.
+>
+> • GitHub: https://github.com/warriorteam/redai-zalo-sdk/blob/main/src/types/webhook.ts
+
+## Table of Contents
+- Overview
+- Event Categories
+- Types & Enums Summary
+- Message Events (examples)
+- User Action Events (examples)
+- Shop Events (examples)
+- OA Message Events (examples)
+- User Interaction Events (examples)
+- Consent Events (examples)
+- Anonymous User Events (examples)
+- Type Guards and Utilities
+- Webhook Handler Setup
+- Best Practices
+- Migration from Legacy Types
+
+## Types & Enums Summary
+
+- Union types
+  - `WebhookEvent` – Tập hợp tất cả event types
+  - `MessageWebhookEvent`, `UserActionWebhookEvent`, `ShopWebhookEvent`, `SystemWebhookEvent`, `AnonymousWebhookEvent`, `CallWebhookEvent`, `ZNSWebhookEvent`, `GroupWebhookEvent`, `WidgetWebhookEvent`
+- Handler map
+  - `WebhookHandlers` – Bản đồ event_name -> handler function có type an toàn
+- Enums
+  - `WebhookEventName` – Tên event chuẩn (string enum)
+  - `AttachmentType` – Loại attachment: image, file, audio, video, gif, link, location, sticker
+- Type guards chính (đều export từ package)
+  - `isMessageEvent`, `isFollowEvent`, `isUserActionEvent`, `isShopEvent`, `isOAMessageEvent`, `isAnonymousEvent`, `isCallEvent`, `isTemplateEvent`, `isBusinessCardEvent`, `isFeedbackEvent`, `isZNSEvent`, `isGroupEvent`, `isJourneyEvent`, `isReactionEvent`, `isConsentEvent`, `isUpdateUserInfoEvent`, `hasAttachments`
+
+- Message shape
+  - `message.msg_id: string` — ID của tin nhắn
+  - `message.text?: string` — Nội dung text (nếu là text)
+  - `message.attachments?: Attachment[]` — Có mặt khi là tin nhắn đa phương tiện (image, gif, video, file, link, location, sticker)
+  - `message.quote_msg_id?: string` — ID của tin nhắn gốc nếu đây là tin nhắn được gửi bằng thao tác “Trả lời” (reply)
+
+
+
 This document describes the webhook event types and DTOs for Zalo Official Account webhooks.
 
 ## Overview
@@ -39,6 +80,9 @@ const textEvent: UserSendTextEvent = {
     text: "Hello from user",
   },
 };
+    // Optional: reply to an existing message
+    quote_msg_id: "96d3cdf3af150460909",
+
 ```
 
 ### User Send Image Event
@@ -403,6 +447,8 @@ const oaTextEvent: OASendTextEvent = {
   message: {
     msg_id: "oa_message_123",
     text: "Hello from Official Account",
+    // Optional: reply to an existing message
+    quote_msg_id: "96d3cdf3af150460909",
   },
 };
 ```
@@ -641,6 +687,8 @@ const anonymousTextEvent: AnonymousSendTextEvent = {
   message: {
     msg_id: "message_123",
     text: "Anonymous message",
+    // Optional: reply to an existing message
+    quote_msg_id: "96d3cdf3af150460909",
     conversation_id: "conversation_123",
   },
 };
@@ -661,6 +709,8 @@ const anonymousImageEvent: AnonymousSendImageEvent = {
   message: {
     msg_id: "message_123",
     text: "Anonymous image",
+    // Optional: reply to an existing message
+    quote_msg_id: "96d3cdf3af150460909",
     conversation_id: "conversation_123",
     attachments: [
       {
@@ -689,6 +739,8 @@ const anonymousFileEvent: AnonymousSendFileEvent = {
   recipient: { id: "579745863508352884" },
   message: {
     msg_id: "message_123",
+    // Optional: reply to an existing message
+    quote_msg_id: "96d3cdf3af150460909",
     conversation_id: "conversation_123",
     attachments: [
       {
@@ -716,19 +768,19 @@ import {
   isFollowEvent,
   hasAttachments,
   WebhookEvent,
-} from "redai-zalo-sdk";
+} from "@warriorteam/redai-zalo-sdk";
 
 function handleWebhook(event: WebhookEvent) {
   if (isMessageEvent(event)) {
     console.log("Message event:", event.event_name);
 
-    if (hasAttachments(event.message)) {
+    if ("message" in event && hasAttachments(event.message)) {
       console.log("Has attachments:", event.message.attachments.length);
     }
   }
 
   if (isFollowEvent(event)) {
-    console.log("New follower:", event.follower.id);
+    console.log("Follower event:", event.event_name);
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warriorteam/redai-zalo-sdk",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Comprehensive TypeScript/JavaScript SDK for Zalo APIs - Official Account, ZNS, Consultation Service, Group Messaging, and Social APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -1,144 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,184 +0,0 @@
-"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

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

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

@@ -1,117 +0,0 @@
-import { ZaloClient } from "../clients/zalo-client";
-import { UserProfile, UserList, UserTag, UserTagList, UserNote, UserInteraction } from "../types/user-management";
-/**
- * Service for managing Zalo OA users
- * Provides comprehensive user management capabilities including:
- * - User profile management
- * - User tagging and segmentation
- * - User notes and interactions
- * - User analytics and insights
- */
-export declare class UserManagementService {
-    private readonly client;
-    private readonly apiUrl;
-    constructor(client: ZaloClient);
-    /**
-     * Get user profile information
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @returns User profile
-     */
-    getUserProfile(accessToken: string, userId: string): Promise<UserProfile>;
-    /**
-     * Get list of users who follow the OA
-     * @param accessToken OA access token
-     * @param offset Offset for pagination
-     * @param count Number of users to retrieve
-     * @returns User list
-     */
-    getFollowersList(accessToken: string, offset?: number, count?: number): Promise<UserList>;
-    /**
-     * Search users by phone number
-     * @param accessToken OA access token
-     * @param phoneNumber Phone number to search
-     * @returns User profile if found
-     */
-    searchUserByPhone(accessToken: string, phoneNumber: string): Promise<UserProfile | null>;
-    /**
-     * Get user tags
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @returns User tags
-     */
-    getUserTags(accessToken: string, userId: string): Promise<UserTag[]>;
-    /**
-     * Tag user with specific tags
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @param tagNames Array of tag names
-     * @returns Tag result
-     */
-    tagUser(accessToken: string, userId: string, tagNames: string[]): Promise<{
-        success: boolean;
-    }>;
-    /**
-     * Remove tags from user
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @param tagNames Array of tag names to remove
-     * @returns Untag result
-     */
-    untagUser(accessToken: string, userId: string, tagNames: string[]): Promise<{
-        success: boolean;
-    }>;
-    /**
-     * Get all available tags
-     * @param accessToken OA access token
-     * @returns List of all tags
-     */
-    getAllTags(accessToken: string): Promise<UserTagList>;
-    /**
-     * Create new tag
-     * @param accessToken OA access token
-     * @param tagName Tag name
-     * @returns Created tag
-     */
-    createTag(accessToken: string, tagName: string): Promise<UserTag>;
-    /**
-     * Delete tag
-     * @param accessToken OA access token
-     * @param tagName Tag name to delete
-     * @returns Deletion result
-     */
-    deleteTag(accessToken: string, tagName: string): Promise<{
-        success: boolean;
-    }>;
-    /**
-     * Add note to user
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @param note Note content
-     * @returns Note result
-     */
-    addUserNote(accessToken: string, userId: string, note: string): Promise<{
-        success: boolean;
-    }>;
-    /**
-     * Get user notes
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @returns User notes
-     */
-    getUserNotes(accessToken: string, userId: string): Promise<UserNote[]>;
-    /**
-     * Get user interaction history
-     * @param accessToken OA access token
-     * @param userId User ID
-     * @param offset Offset for pagination
-     * @param count Number of interactions to retrieve
-     * @returns User interactions
-     */
-    getUserInteractions(accessToken: string, userId: string, offset?: number, count?: number): Promise<{
-        data: UserInteraction[];
-        total: number;
-    }>;
-    private handleUserManagementError;
-}
-//# sourceMappingURL=user-management.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"user-management.service.d.ts","sourceRoot":"","sources":["../../src/services/user-management.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,WAAW,EACX,QAAQ,EACR,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAE/B,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAgBvB;;;;;;OAMG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAiBpB;;;;;OAKG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAgB9B;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgB1E;;;;;;OAMG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBhC;;;;;;OAMG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBhC;;;;OAIG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAa3D;;;;;OAKG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBvE;;;;;OAKG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBhC;;;;;;OAMG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBhC;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgB5E;;;;;;;OAOG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBtD,OAAO,CAAC,yBAAyB;CAWlC"}