@redonvn/zalo-ads-sdk 0.2.0 → 0.2.4

package/dist/index.d.mts

@@ -439,7 +439,7 @@ declare class ZaloSdkError extends Error {
     readonly status: number;
     readonly operationId: string;
     readonly responseBody: unknown;
-    constructor(message: string, status: number, operationId: string, responseBody: unknown);
+    constructor(message: string, status?: number, operationId?: string, responseBody?: unknown);
 }
 interface FileDownloadResponse {
     file: Blob;
@@ -447,6 +447,62 @@ interface FileDownloadResponse {
     contentType: string | null;
 }
 
+/**
+ * Mã trạng thái kỹ thuật & nghiệp vụ của Instant Page:
+ * - 0: Bản sao mới tạo (Clone Draft) - vừa nhân bản từ template hoặc trang khác, chưa từng sửa và chưa xuất bản
+ * - 1: Bản nháp đang sửa (Draft) - đang biên tập trong trình tạo trang (Canvas Editor), lưu trong draft
+ * - 2: Đã xuất bản (Published / Active) - trang chính thức, cấu hình live nằm trong content, sẵn sàng chạy ads
+ * - 3: Lưu trữ / Đã kết thúc (Archived / Ended) - trang đã ngưng hoạt động hoặc kết thúc chiến dịch
+ */
+type ZaloInstantPageStatus = 0 | 1 | 2 | 3;
+/**
+ * Cờ trạng thái hoạt động của Instant Page:
+ * - 0: Tắt (tạm khóa, không cho người dùng truy cập)
+ * - 1: Bật (cho phép xem trang qua https://page.zalo.me/p/{publicId})
+ * Bắt buộc kiểu số nguyên 0 | 1, không truyền boolean true/false.
+ */
+type ZaloInstantPageActive = 0 | 1;
+/**
+ * Danh mục mã định danh các loại khối giao diện (Block Types) trong Instant Page Canvas (trường draft và content):
+ */
+declare enum ZaloInstantPageBlockType {
+    /** Slide ảnh/video banner trình chiếu sản phẩm */
+    CAROUSEL_SLIDER = 1,
+    /** Đồng hồ đếm ngược Flash sale / thời gian khuyến mãi */
+    COUNTDOWN = 2,
+    /** Văn bản mô tả giàu định dạng (HTML / Quill Delta ops) */
+    RICH_TEXT = 4,
+    /** Hình ảnh đơn / banner minh họa (Hero image) */
+    HERO_IMAGE = 6,
+    /** Form field: Ô nhập họ và tên khách hàng */
+    FORM_NAME = 7,
+    /** Nút CTA Đặt hàng ngay (cố định chân trang hoặc mở form popup) */
+    ORDER_CTA_BUTTON = 8,
+    /** Form field: Ô nhập số điện thoại */
+    FORM_PHONE = 9,
+    /** Form field: Ô nhập địa chỉ giao hàng */
+    FORM_ADDRESS = 10,
+    /** Chân trang thương hiệu (Hotline, Email, Website, Địa chỉ) */
+    FOOTER = 14,
+    /** Form field: Ô chọn số lượng sản phẩm mua */
+    FORM_QUANTITY = 16,
+    /** Phân loại / Biến thể sản phẩm (Màu sắc, Size, Combo) */
+    PRODUCT_VARIANT = 18,
+    /** Tiêu đề sản phẩm & Giá bán (name, rawPrice, price) */
+    PRODUCT_TITLE_PRICE = 19,
+    /** Câu hỏi gợi ý nhanh (FAQ quick replies) */
+    QUICK_QUESTIONS = 20,
+    /** Nút CTA nhắn tin trực tiếp đến Zalo Official Account */
+    MESSAGE_CTA_BUTTON = 21,
+    /** Tiêu đề phân đoạn (Section Heading) */
+    SECTION_HEADING = 22,
+    /** Nút Hotline gọi điện thoại tư vấn viên */
+    CALL_HOTLINE_BUTTON = 23,
+    /** Bảng thông số / Ưu đãi 2 cột (Key-Value rows) */
+    KEY_VALUE_TABLE = 25,
+    /** Điều khoản đồng thuận thu thập dữ liệu cá nhân theo NĐ 13 */
+    CONSENT_NOTICE = 27
+}
 /** Sao chép một Instant Page hiện có và trả về bản Instant Page mới cùng toàn bộ draft được sao chép. Đây là mutation tool thuộc lane zalo-ads-content; dùng khi cần tạo bản làm việc độc lập trước khi chỉnh sửa nội dung hoặc trạng thái. Bản sao có id và publicId mới, không ghi đè Instant Page nguồn. */
 type ZaloInstantPagesCloneInstantPageRequest = {
     /** ID Instant Page nguồn cần sao chép. */
@@ -465,12 +521,12 @@ type ZaloInstantPagesCloneInstantPageResponse = {
         oaId: string;
         /** Chuỗi JSON cấu hình bản nháp đã được sao chép, gồm data các block/section, renderList và các thiết lập layout. Đây chưa tự đại diện cho nội dung public đã phát hành. */
         draft: string;
-        /** Cờ bật/tắt của Instant Page theo quy ước API. */
-        active: number;
+        /** Cờ bật/tắt của Instant Page: 0 = Tắt, 1 = Bật. */
+        active: ZaloInstantPageActive;
         /** ID form liên kết; có thể rỗng. */
         formId: string;
-        /** Mã trạng thái Instant Page. */
-        status: number;
+        /** Mã trạng thái Instant Page: 0 = Bản sao mới tạo, 1 = Bản nháp, 2 = Đã xuất bản, 3 = Lưu trữ. */
+        status: ZaloInstantPageStatus | number;
         /** ID người dùng sở hữu Instant Page. */
         userId: number;
         /** Nội dung đã phát hành/được lưu ngoài draft; có thể rỗng. */
@@ -508,12 +564,12 @@ type ZaloInstantPagesGetInstantPageDetailResponse = {
         oaId: string;
         /** Bản nháp cấu hình Instant Page chưa được phát hành hoặc chưa áp dụng làm nội dung chính; dạng chuỗi JSON/serialized payload. Dùng để so sánh hoặc tiếp tục chỉnh sửa, không tự xem là bản public. */
         draft: string;
-        /** Trạng thái kích hoạt. */
-        active: number;
+        /** Trạng thái kích hoạt: 0 = Tắt, 1 = Bật. */
+        active: ZaloInstantPageActive;
         /** ID form liên kết, khi có. */
         formId: string;
-        /** Trạng thái nghiệp vụ/phát hành. */
-        status: number;
+        /** Trạng thái nghiệp vụ: 0 = Bản sao mới tạo, 1 = Bản nháp, 2 = Đã xuất bản, 3 = Lưu trữ. */
+        status: ZaloInstantPageStatus | number;
         /** ID người dùng sở hữu page. */
         userId: number;
         /** Nội dung/cấu hình Instant Page đang được lưu, dạng chuỗi JSON hoặc serialized payload. */
@@ -577,7 +633,6 @@ type ZaloInstantPagesListInstantPageEditHistoryResponse = {
             created: number;
             /** Tên hiển thị của người dùng thực hiện thao tác. */
             userName: string;
-            [key: string]: unknown;
         }>;
         metadata: {
             /** Giới hạn bản ghi của trang đã trả về. */
@@ -586,19 +641,32 @@ type ZaloInstantPagesListInstantPageEditHistoryResponse = {
             total: number;
             /** Vị trí bắt đầu của trang đã trả về. */
             offset: number;
-            [key: string]: unknown;
         };
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 };
-/** Lấy danh sách bản ghi gửi form của một Instant Page. Đây là detail tool thuộc lane zalo-ads-content; dùng khi cần xem dữ liệu khách hàng đã gửi từ form gắn với trang cụ thể. Schema chi tiết từng bản ghi chưa được xác minh do chưa có response mẫu. */
+/** Lấy danh sách bản ghi gửi form của một Instant Page. Đây là detail tool thuộc lane zalo-ads-content; dùng khi cần xem dữ liệu khách hàng đã gửi từ form gắn với trang cụ thể. */
 type ZaloInstantPagesListInstantPageFormRecordsRequest = {
     /** ID Instant Page có form cần lấy bản ghi gửi. */
     instantPageId: number;
 };
-type ZaloInstantPagesListInstantPageFormRecordsResponse = {
-    [key: string]: unknown;
+type ZaloInstantPagesFormRecordItem = {
+    id: string;
+    pageId: number;
+    userId?: string;
+    userName?: string;
+    phone?: string;
+    created: number;
+    answers: Array<{
+        questionId: string;
+        title: string;
+        value: string;
+    }>;
+};
+type ZaloInstantPagesListInstantPageFormRecordsResponse = Blob | {
+    data: {
+        items: Array<ZaloInstantPagesFormRecordItem>;
+        total: number;
+    };
 };
 /** Lấy danh sách người dùng được chia sẻ quyền truy cập một Instant Page, gồm quyền trên trang và quyền Official Account. Đây là detail tool thuộc lane zalo-ads-content; dùng để kiểm tra quyền cộng tác trước khi chia sẻ, chỉnh sửa hoặc thu hồi quyền. Mỗi phần tử xác định người dùng bằng userId và thông tin hiển thị. */
 type ZaloInstantPagesListInstantPageSharesRequest = {
@@ -679,14 +747,14 @@ type ZaloInstantPagesSearchInstantPagesResponse = {
         oaId: string;
         /** Tên hiển thị chủ sở hữu. */
         owner: string;
-        /** Trạng thái bật/tắt; dùng API cập nhật với active=0 để tắt và active=1 để bật. */
-        active: 0 | 1;
+        /** Trạng thái bật/tắt: 0 = Tắt, 1 = Bật. */
+        active: ZaloInstantPageActive;
         /** ID form liên kết; có thể rỗng. */
         formId: string;
         /** Tên các người dùng được chia sẻ quyền. */
         shares: Array<string>;
-        /** Mã trạng thái kỹ thuật/lifecycle của Instant Page. */
-        status: number;
+        /** Mã trạng thái: 0 = Bản sao mới tạo, 1 = Bản nháp, 2 = Đã xuất bản, 3 = Lưu trữ. */
+        status: ZaloInstantPageStatus | number;
         /** Unix timestamp theo giây lúc tạo. */
         created: number;
         /** Tên hiển thị người tạo. */
@@ -695,9 +763,9 @@ type ZaloInstantPagesSearchInstantPagesResponse = {
         ownerId: number;
         /** Unix timestamp theo giây lúc cập nhật. */
         modified: number;
-        /** Mã công khai của Instant Page. */
+        /** Mã công khai 12 ký tự của Instant Page (dùng trên https://page.zalo.me/p/{publicId}). */
         publicId: string;
-        /** Unix timestamp theo giây lúc xuất bản. */
+        /** Unix timestamp theo giây lúc xuất bản (0 nếu chưa xuất bản). */
         published: number;
         /** Quyền trực tiếp trên Instant Page khi API trả về. */
         permission?: number;
@@ -709,7 +777,15 @@ type ZaloInstantPagesSearchInstantPagesResponse = {
     }>;
     [key: string]: unknown;
 };
-/** Cập nhật một phần tên, cờ bật/tắt, OA liên kết, trạng thái, content đã lưu hoặc bản nháp Instant Page. Đây là mutation tool thuộc lane zalo-ads-content; dùng khi đã xác nhận đúng page và đúng trường cần thay đổi. Với active, 0 là bật và 1 là tắt; content là cấu hình nội dung theo block, còn draft là cấu hình chưa phát hành. Thao tác này lưu thay đổi, không thay thế thao tác xuất bản riêng trên giao diện. */
+/**
+ * Cập nhật thông tin, cấu hình bản nháp (draft), nội dung chính thức (content) hoặc bật/tắt trạng thái (active) của Instant Page theo ID.
+ *
+ * Hỗ trợ 4 loại thao tác nghiệp vụ:
+ * - **Loại 1 (Bật/Tắt nhanh)**: `{ id, active: 0 | 1 }` (0: Tắt, 1: Bật)
+ * - **Loại 2 (Đổi tên / Đổi OA)**: `{ id, name?: string, oaId?: string }`
+ * - **Loại 3 (Lưu bản nháp - Save Draft)**: `{ id, name?: string, status: 1, draft: string }`
+ * - **Loại 4 (Xuất bản - Publish Live)**: `{ id, name?: string, status: 2, draft: string, content: string }`
+ */
 type ZaloInstantPagesUpdateInstantPageRequest = {
     /** ID Instant Page cần cập nhật. */
     instantPageId: number;
@@ -717,15 +793,26 @@ type ZaloInstantPagesUpdateInstantPageRequest = {
     id: number;
     /** Tên Instant Page mới; giao diện giới hạn tối đa 40 ký tự. Chỉ gửi khi cần đổi tên. */
     name?: string;
-    /** ID Official Account liên kết; chỉ gửi khi cần thay đổi hoặc lưu lại liên kết OA. */
+    /** ID Official Account liên kết; truyền chuỗi rỗng "" nếu trang chưa liên kết OA hoặc không dùng OA. */
     oaId?: string;
-    /** Chuỗi JSON bản nháp cấu hình Instant Page; chỉ gửi khi cập nhật nội dung nháp. Draft không tự đại diện cho bản public đã phát hành và khác với content. */
+    /**
+     * Chuỗi JSON bản nháp cấu hình Instant Page đang biên tập trên Canvas Editor (chưa xuất bản).
+     * Gồm renderList (mảng ID thứ tự hiển thị), data (map ID -> block object), freezedTop, freezedBottom, version.
+     * Danh mục block types:
+     * 1: CAROUSEL_SLIDER | 2: COUNTDOWN | 4: RICH_TEXT | 6: HERO_IMAGE | 7: FORM_NAME |
+     * 8: ORDER_CTA_BUTTON | 9: FORM_PHONE | 10: FORM_ADDRESS | 14: FOOTER | 16: FORM_QUANTITY |
+     * 18: PRODUCT_VARIANT | 19: PRODUCT_TITLE_PRICE | 20: QUICK_QUESTIONS | 21: MESSAGE_CTA_BUTTON |
+     * 22: SECTION_HEADING | 23: CALL_HOTLINE_BUTTON | 25: KEY_VALUE_TABLE | 27: CONSENT_NOTICE
+     */
     draft?: string;
-    /** Thao tác bật/tắt Instant Page: 0 là tắt, 1 là bật. */
-    active?: 0 | 1;
-    /** Mã trạng thái kỹ thuật của Instant Page. Không suy diễn rằng trường này tự xuất bản trang: giao diện có nút Xuất bản riêng và thao tác Lưu chỉ lưu thay đổi. */
-    status?: number;
-    /** Chuỗi JSON cấu hình nội dung được lưu/cập nhật của Instant Page. Gồm renderList (thứ tự ID block), data (object map ID block), freezedTop/freezedBottom và version. Block quan sát: type 1 Carousel (1–10 ảnh/video, kéo-thả thứ tự, rich text Quill màu và cỡ 14/18/24px), type 25 bảng rows left/right, type 20 danh sách câu hỏi/gợi ý, type 21 tin nhắn mặc định/CTA tối đa 40 ký tự. Chỉ gửi khi cập nhật nội dung trang. */
+    /** Thao tác bật/tắt Instant Page: 0 là tắt, 1 là bật. BẮT BUỘC là số nguyên 0 | 1, không truyền kiểu boolean. */
+    active?: ZaloInstantPageActive;
+    /** Mã trạng thái của Instant Page: 1 = Lưu bản nháp (Draft), 2 = Xuất bản chính thức (Published). */
+    status?: ZaloInstantPageStatus | number;
+    /**
+     * Chuỗi JSON cấu hình nội dung chính thức đang chạy ở Production của Instant Page (sau khi xuất bản).
+     * Chỉ gửi khi xuất bản chính thức (status = 2). Cấu trúc tương tự draft.
+     */
     content?: string;
 };
 type ZaloInstantPagesUpdateInstantPageResponse = {
@@ -809,10 +896,10 @@ type ZaloInstantPagesUpsertInstantPageFormRequest = {
         /** Mô tả phụ của câu hỏi (có thể để chuỗi rỗng). */
         description: string;
     }>;
-    /** Sử dụng cấu hình điều khoản đồng ý tùy chỉnh hay mặc định. */
-    useCustomConsent: boolean;
-    /** Cấu hình thông tin pháp lý và phạm vi thu thập dữ liệu cá nhân của biểu mẫu. */
-    consentConfig: {
+    /** Sử dụng cấu hình điều khoản đồng ý tùy chỉnh hay mặc định (mặc định: false). */
+    useCustomConsent?: boolean;
+    /** Cấu hình thông tin pháp lý và phạm vi thu thập dữ liệu cá nhân của biểu mẫu (bắt buộc khi useCustomConsent = true). */
+    consentConfig?: {
         /** Địa chỉ liên hệ của bên kiểm soát hoặc sở hữu dữ liệu. */
         address: string;
         /** Tên cá nhân hoặc đơn vị sở hữu dữ liệu. */
@@ -968,60 +1055,195 @@ type ZaloAdsUpdateFlowRequest = {
     messages: ZaloAdsFlowMessageDto[];
 };
 type ZaloAdsUpdateFlowResponse = {
-    code?: number;
+    code: number;
     msg?: string;
-    data?: unknown;
-    [key: string]: unknown;
+    data?: {
+        id?: number;
+    };
 };
+interface ZaloAdsAdPriceSettingsDto {
+    Bid: number;
+    Type: number;
+    Limit: number;
+    LimitType: number;
+    SpendingMethod: number;
+}
+interface ZaloAdsAdMultiImageItemDto {
+    Url: string;
+    Title?: string;
+    Description?: string;
+    TargetUrl?: string;
+}
+interface ZaloAdsAdImageSettingsDto {
+    LogoUrl?: string;
+    LandscapeCoverUrl?: string;
+    SquareCoverUrl?: string;
+    VideoUrl?: string;
+    VideoDuration?: number;
+    MediaId?: number;
+    MultiImages?: Array<ZaloAdsAdMultiImageItemDto>;
+}
+interface ZaloAdsAdInfoSettingsDto {
+    Title?: string;
+    Description?: string;
+    Caption?: string;
+    Action?: number;
+    ButtonText?: string;
+    MoreInfo?: string;
+    TargetUrl?: string;
+    Phone?: string;
+    Address?: string;
+}
+interface ZaloAdsAdAppInfoSettingsDto {
+    AppType?: number;
+    OsType?: number;
+    StoreUrl?: string;
+}
+interface ZaloAdsAdTargetingSettingsDto {
+    Gender?: number;
+    AgeRanges?: Array<number>;
+    Locations?: string;
+    Provinces?: Array<number>;
+    DistrictsTargeting?: string;
+    WardsTargeting?: string;
+    Platforms?: Array<number>;
+    NetworkTypes?: Array<number>;
+    OsTypes?: Array<number>;
+    AdvanceTargetings?: Array<number>;
+    CustomAudiences?: Array<number>;
+    ExcludeCustomAudiences?: Array<number>;
+}
+interface ZaloAdsAdZVideoSettingsDto {
+    Url: string;
+    Duration: number;
+    Src: number;
+    Thumbnail: string;
+    Description: string;
+    ChannelName: string;
+    ChannelAvt: string;
+    VideoThumbnail: string;
+    ThumbnailIndex: number | null;
+}
+interface ZaloAdsAdSettingsDto {
+    Image: ZaloAdsAdImageSettingsDto;
+    Price: ZaloAdsAdPriceSettingsDto;
+    AdInfo: ZaloAdsAdInfoSettingsDto;
+    AppInfo?: ZaloAdsAdAppInfoSettingsDto;
+    Targeting: ZaloAdsAdTargetingSettingsDto;
+    ZVideo?: ZaloAdsAdZVideoSettingsDto;
+    VideoPlatform?: number;
+    Rating?: number;
+    NewFeatures?: Array<number>;
+    CreatedClientVersion?: number;
+}
+interface ZaloAdsAdUpdatePayloadDto {
+    AdId: number;
+    CampaignId: number;
+    MemberId: number;
+    RowVersion: number;
+    AdName: string;
+    Type: number;
+    Settings: ZaloAdsAdSettingsDto;
+    Status: number;
+    StartDate: number;
+    EndDate: number;
+    ZaloFlowId?: number;
+    ZaloPageId?: number;
+    ZaloFormId?: string;
+    ZaloFeedId?: string | number;
+    MiniPageId?: number;
+    UseConversion?: 0 | 1;
+    ConversionId?: number;
+    Report?: Record<string, number>;
+}
+interface ZaloAdsAdMutationResultDto {
+    AdId?: number;
+    CampaignId?: number;
+    Status?: number;
+    RowVersion?: number;
+}
+interface ZaloAdsCampaignCreatePayloadDto {
+    name: string;
+    campaignType: number;
+    pageId: number;
+    productId: number;
+    targetUrl?: string;
+    articleId?: number;
+    adtype: number;
+    budgetType: number;
+    budgetlimit: number;
+    limitType: number;
+    campaignObjective: number;
+    campaignId: number;
+    adId: number;
+}
+interface ZaloAdsFormSectionTableItemDto {
+    key: string;
+    value: string;
+}
+interface ZaloAdsFormSectionImageItemDto {
+    url: string;
+    title?: string;
+    caption?: string;
+}
+interface ZaloAdsFormSectionContentDto {
+    title?: string;
+    description?: string;
+    table?: Array<ZaloAdsFormSectionTableItemDto>;
+    images?: Array<ZaloAdsFormSectionImageItemDto>;
+}
+interface ZaloAdsFormSectionDto {
+    type: "0" | "1" | "2" | "3" | "4" | number;
+    title: string;
+    expand: boolean;
+    disable: boolean;
+    content: ZaloAdsFormSectionContentDto;
+}
+interface ZaloAdsFormQuestionUiDto {
+    icon?: string;
+    title?: string;
+    removable?: boolean;
+}
+interface ZaloAdsFormAnswerDto {
+    id?: string;
+    type: "2" | "7" | "13" | number;
+    value?: string | null;
+    priority?: number;
+    placeHolder?: string;
+}
+interface ZaloAdsFormQuestionDto {
+    id?: string;
+    ui?: ZaloAdsFormQuestionUiDto;
+    type: "1" | number;
+    title: string;
+    answers: Array<ZaloAdsFormAnswerDto>;
+    groupIdx?: number;
+    priority?: number;
+    isRequired: boolean;
+    editDisabled?: boolean;
+}
+interface ZaloAdsCreateFormPayloadDto {
+    id?: string;
+    oaId: string;
+    formName: string;
+    title?: string;
+    description?: string;
+    coverPhoto?: string;
+    thanks?: string;
+    gotoText?: string;
+    gotoActionType?: number;
+    website?: string;
+    phone?: string;
+    submitTitle?: string;
+    reviewSubmit?: boolean;
+    oaConsentWidget?: boolean;
+    useCustomConsent?: boolean;
+    sections?: Array<ZaloAdsFormSectionDto>;
+    questions: Array<ZaloAdsFormQuestionDto>;
+}
 /** Cập nhật quảng cáo Video; service tự JSON.stringify data rồi gửi form-urlencoded. */
 declare class ZaloAdsUpdateVideoAdRequest {
-    data: {
-        AdId: number;
-        CampaignId: number;
-        MemberId: number;
-        RowVersion: number;
-        AdName: string;
-        /** 11 = Quảng cáo Video. */
-        Type: 11;
-        Settings: {
-            Image: {
-                LogoUrl: string;
-                LandscapeCoverUrl: string;
-                VideoUrl: string;
-                VideoDuration: number;
-                [key: string]: unknown;
-            };
-            Price: {
-                Bid: number;
-                Type: 1;
-                Limit: number;
-                LimitType: 1;
-                SpendingMethod: 0;
-            };
-            AdInfo: Record<string, unknown>;
-            AppInfo: Record<string, unknown>;
-            Targeting: Record<string, unknown>;
-            ZVideo: {
-                Url: string;
-                Duration: number;
-                Src: 2;
-                Thumbnail: string;
-                Description: string;
-                ChannelName: string;
-                ChannelAvt: string;
-                VideoThumbnail: string;
-                ThumbnailIndex: number | null;
-            };
-            VideoPlatform: 1;
-            [key: string]: unknown;
-        };
-        Status: number;
-        StartDate: number;
-        EndDate: number;
-        ZaloFlowId: number;
-        UseConversion: 0 | 1;
-        [key: string]: unknown;
-    };
+    data: ZaloAdsAdUpdatePayloadDto | string;
     est?: string;
     isBoostAd?: 0 | 1;
     stt?: number;
@@ -1029,7 +1251,7 @@ declare class ZaloAdsUpdateVideoAdRequest {
 declare class ZaloAdsUpdateVideoAdResponse {
     code: number;
     msg: string;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 }
 /** Lấy danh sách hoặc Flow cụ thể của một Official Account. Dùng flowId khi cần đọc một Flow trước khi cập nhật, hoặc offset và limit khi duyệt danh sách. */
 type ZaloAdsListFlowsByOfficialAccountRequest = {
@@ -1060,20 +1282,20 @@ type ZaloAdsListFlowsByOfficialAccountResponse = {
                 text: string;
                 editable: boolean;
                 url: string;
-                messages: Array<unknown>;
+                messages: Array<ZaloAdsFlowChildMessageDto>;
+            }>;
+            elements: Array<{
+                type?: number;
+                title?: string;
+                url?: string;
             }>;
-            elements: Array<unknown>;
             stepId: number;
-            [key: string]: unknown;
         }>;
-        [key: string]: unknown;
     }>;
     extend: {
         total: number;
         index?: number;
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 };
 /** Thay đổi trạng thái của một chiến dịch Zalo Ads theo mã trạng thái được chỉ định. Đây là destructive mutation tool thuộc lane quản lý chiến dịch; dùng khi cần dừng, hủy hoặc chuyển trạng thái chiến dịch và phải xác minh rõ mã trạng thái trước khi gọi. Giá trị -2 trong request đã ghi nhận sẽ xóa chiến dịch. */
 type ZaloAdsChangeCampaignStatusRequest = {
@@ -1131,7 +1353,7 @@ type ZaloAdsCreateCustomAudienceResponse = {
 /** Tạo chiến dịch quảng cáo E-commerce (Commerce) trên Zalo Ads (campaignType = 9). Service tự JSON.stringify nếu truyền object. */
 type ZaloAdsCreateEcommerceCampaignRequest = {
     /** Cấu hình chiến dịch Commerce (object hoặc chuỗi JSON): { name, campaignType: 9, pageId, productId, targetUrl, adtype: -1, budgetType: 1, budgetlimit, limitType: 2, campaignObjective: 0, campaignId: 0, adId: 0 }. */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateEcommerceCampaignResponse = {
     msg: string;
@@ -1144,8 +1366,8 @@ type ZaloAdsCreateEcommerceCampaignResponse = {
 };
 /** Tạo form gắn Official Account, câu hỏi thu thập thông tin, nội dung section và màn hình cảm ơn. Đây là thao tác mutation; form mới sẽ xuất hiện trong danh sách biểu mẫu của OA. */
 type ZaloAdsCreateFormRequest = {
-    /** Chuỗi JSON.stringify(CreateFormPayload), sau đó form-url-encode. Đây là field form duy nhất đã capture. */
-    data: string | Record<string, unknown>;
+    /** Cấu hình biểu mẫu thu thập thông tin khách hàng hoặc chuỗi JSON.stringify(CreateFormPayload). */
+    data: ZaloAdsCreateFormPayloadDto | string;
 };
 type ZaloAdsCreateFormResponse = {
     code: "0" | 0;
@@ -1159,57 +1381,8 @@ type ZaloAdsCreateFormResponse = {
         /** Unix epoch giây. */
         createAt: number;
         formName: string;
-        sections: Array<{
-            /** 0=tổng quan; 1=thông tin chi tiết; 2=bảng; 3=ưu điểm; 4=ưu đãi. */
-            type: "0" | "1" | "2" | "3" | "4";
-            title: string;
-            /** Mở rộng section khi hiển thị. */
-            expand: boolean;
-            content: {
-                table?: Array<{
-                    key: string;
-                    value: string;
-                }>;
-                title?: string;
-                images?: Array<{
-                    url: string;
-                    title?: string;
-                    caption?: string;
-                }>;
-                videos?: Array<Record<string, never>>;
-                description?: string;
-            };
-            /** Ẩn/vô hiệu section. */
-            disable: boolean;
-        }>;
-        questions: Array<{
-            /** ID câu hỏi. Không cần khi tạo thông thường; được backend trả về và được gửi lại khi chỉnh sửa/logic. */
-            id?: string;
-            ui?: {
-                icon?: string;
-                title?: string;
-                removable?: boolean;
-            };
-            /** Loại câu hỏi đã capture. */
-            type: "1";
-            /** Nhãn câu hỏi. UI báo lỗi ngoài khoảng 2–180 ký tự. */
-            title: string;
-            answers: Array<{
-                /** ID đáp án do backend cấp. Chỉ cần gửi khi dùng logic câu hỏi/chỉnh sửa; tạo mới thông thường có thể không có. */
-                id?: string;
-                /** 2=số điện thoại phụ; 7=họ tên; 13=số điện thoại chuẩn. */
-                type: "2" | "7" | "13";
-                /** Request mẫu gửi null cho đáp án chuẩn; không thấy ở số điện thoại phụ. */
-                value?: string | null;
-                /** Placeholder do backend trả về sau khi tạo. */
-                placeHolder?: string;
-            }>;
-            /** Chỉ số trang của câu hỏi trong form nhiều trang, bắt đầu từ 0. Không gửi field này trong form một trang. */
-            groupIdx?: number;
-            isRequired: boolean;
-            /** Khóa việc sửa câu hỏi chuẩn. */
-            editDisabled?: boolean;
-        }>;
+        sections: Array<ZaloAdsFormSectionDto>;
+        questions: Array<ZaloAdsFormQuestionDto>;
         /** Unix epoch giây. */
         updatedAt: number;
         description?: string;
@@ -1218,7 +1391,7 @@ type ZaloAdsCreateFormResponse = {
 /** Tạo chiến dịch quảng cáo biểu mẫu (Form) trên Zalo Ads (campaignType = 8). Service tự JSON.stringify nếu truyền object. */
 type ZaloAdsCreateFormCampaignRequest = {
     /** Cấu hình chiến dịch biểu mẫu (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateFormCampaignResponse = {
     msg: string;
@@ -1231,7 +1404,7 @@ type ZaloAdsCreateFormCampaignResponse = {
 /** Tạo chiến dịch quảng cáo Tin nhắn trên Zalo Ads (campaignType = 10). Service tự JSON.stringify nếu truyền object. */
 type ZaloAdsCreateMessageCampaignRequest = {
     /** Cấu hình chiến dịch Tin nhắn (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateMessageCampaignResponse = {
     code?: number;
@@ -1247,7 +1420,7 @@ type ZaloAdsCreateMessageCampaignResponse = {
 /** Tạo chiến dịch quảng cáo Zalo Official Account (campaignType = 2). Service tự JSON.stringify nếu truyền object. */
 type ZaloAdsCreateOfficialAccountCampaignRequest = {
     /** Cấu hình chiến dịch Official Account (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateOfficialAccountCampaignResponse = {
     msg: string;
@@ -1261,27 +1434,7 @@ type ZaloAdsCreateOfficialAccountCampaignResponse = {
 /** Tạo chiến dịch quảng cáo Bài viết trên Zalo Ads (campaignType = 4). Service tự JSON.stringify payload này vào field form data. */
 declare class ZaloAdsCreatePostCampaignRequest {
     /** Cấu hình chiến dịch Bài viết (object hoặc chuỗi JSON). */
-    data: {
-        name: string;
-        /** 4 = Quảng cáo Bài viết. */
-        campaignType: 4;
-        /** ID Official Account/trang chứa bài viết. */
-        pageId: number;
-        /** Mẫu Bài viết dùng -1. */
-        productId: -1;
-        /** ID bài viết Zalo cần quảng cáo. */
-        articleId: number;
-        adtype: -1;
-        budgetType: number;
-        budgetlimit: number;
-        limitType: number;
-        campaignObjective: number;
-        /** Đặt 0 để tạo chiến dịch mới. */
-        campaignId: 0;
-        /** Đặt 0 để tạo quảng cáo mới. */
-        adId: 0;
-        [key: string]: unknown;
-    } | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 }
 declare class ZaloAdsCreatePostCampaignResponse {
     code: number;
@@ -1292,6 +1445,11 @@ declare class ZaloAdsCreatePostCampaignResponse {
         campaignId: number;
     };
 }
+interface ZaloAdsConversionElementSelectorDto {
+    class?: Array<string>;
+    id?: string;
+    tag?: string;
+}
 /** Tạo conversion để đo lường hành động trên trang đích Zalo Ads. Đây là mutation tool thuộc lane zalo-ads-conversion; dùng sau khi đã xác định nhãn conversion, URL trang đích và quy tắc sự kiện click hoặc URL. Chỉ gọi khi cần tạo mới vì mỗi lần gọi sẽ phát sinh một conversion trong tài khoản quảng cáo. */
 type ZaloAdsCreateConversionRequest = {
     /** Tên conversion, phải duy nhất trong tài khoản quảng cáo (2–180 ký tự). */
@@ -1301,10 +1459,7 @@ type ZaloAdsCreateConversionRequest = {
     /** Kiểu khớp URL: 1 hoặc 2. */
     urlType: 1 | 2 | number;
     /** Bộ chọn phần tử click; ví dụ [{"class":["btn"]}]. Dùng mảng rỗng khi không áp dụng. */
-    elements: Array<{
-        class?: Array<string>;
-        [key: string]: unknown;
-    }>;
+    elements: Array<ZaloAdsConversionElementSelectorDto>;
     /** Từ khóa URL cần ghi nhận; dùng mảng rỗng khi không áp dụng. */
     keywords: Array<string>;
     /** Danh sách ID nút theo cấu hình click; dùng mảng rỗng khi không áp dụng. */
@@ -1312,11 +1467,20 @@ type ZaloAdsCreateConversionRequest = {
     /** URL trang đích có Zalo Pixel. */
     landingPage: string;
 };
+interface ZaloAdsConversionItemDto {
+    conversionId: number;
+    name: string;
+    labelId: number;
+    urlType?: number;
+    landingPage?: string;
+    status?: number;
+    created?: number;
+    memberId?: number;
+}
 type ZaloAdsCreateConversionResponse = {
-    code?: number;
+    code: number;
     msg?: string;
-    data?: unknown;
-    [key: string]: unknown;
+    data?: ZaloAdsConversionItemDto | number;
 };
 /** Xóa một conversion đã cấu hình trên Zalo Ads. Đây là destructive tool thuộc lane zalo-ads-conversion; chỉ dùng sau khi đối chiếu ID từ danh sách conversion và xác nhận cần dừng ghi nhận dữ liệu mới. Không dùng để tạm dừng hoặc chỉnh sửa conversion vì thao tác không thể khôi phục. */
 type ZaloAdsDeleteConversionRequest = {
@@ -1327,8 +1491,7 @@ type ZaloAdsDeleteConversionResponse = {
     /** Thông báo trạng thái từ Zalo Ads. */
     msg: string;
     /** Mã thành công đã capture: 0. */
-    code: 0;
-    [key: string]: unknown;
+    code: 0 | number;
 };
 /** Xóa một audience tùy chỉnh theo ID trên Zalo Ads. Đây là destructive tool thuộc lane zalo-ads-audience; chỉ dùng sau khi xác nhận đúng audience và hệ quả không thể hoàn tác. Dùng CustomAudienceId từ tool danh sách hoặc tạo audience. */
 type ZaloAdsDeleteCustomAudienceRequest = {
@@ -1345,10 +1508,29 @@ type ZaloAdsDeleteCustomAudienceResponse = {
 type ZaloAdsGetAdByIdRequest = {
     /** ID mẫu quảng cáo cần lấy chi tiết (query param `adId`). */
     adId?: number | string;
-    [key: string]: unknown;
 };
 type ZaloAdsGetAdByIdResponse = {
-    [key: string]: unknown;
+    code?: number;
+    msg?: string;
+    data?: ZaloAdsAdUpdatePayloadDto;
+    AdId?: number;
+    CampaignId?: number;
+    MemberId?: number;
+    RowVersion?: number;
+    AdName?: string;
+    Type?: number;
+    Settings?: ZaloAdsAdSettingsDto;
+    Status?: number;
+    StartDate?: number;
+    EndDate?: number;
+    ZaloFlowId?: number;
+    ZaloPageId?: number;
+    ZaloFormId?: string;
+    ZaloFeedId?: string | number;
+    MiniPageId?: number;
+    UseConversion?: 0 | 1;
+    ConversionId?: number;
+    Report?: Record<string, number>;
 };
 /** Lấy lịch sử thao tác và các hạng mục thay đổi của một quảng cáo Zalo Ads. Đây là detail tool thuộc lane quản lý quảng cáo; dùng để kiểm tra ai đã tạo hoặc điều chỉnh nội dung, đối tượng, hình/video và conversion. Mỗi bản ghi nêu người thực hiện, thời điểm và danh sách thay đổi chính hoặc bổ sung. */
 type ZaloAdsGetAdChangeLogRequest = {
@@ -1394,25 +1576,96 @@ type ZaloAdsGetApiAdGetlistadadvancetargetingResponse = {
         displayName: string;
     }>;
 };
-/** Lấy danh sách tài khoản hoặc thành viên được phép truy cập tài khoản quảng cáo hiện tại. Đây là entry tool thuộc lane zalo-ads-account; dùng khi cần xác định người có quyền vận hành tài khoản. */
-type ZaloAdsGetApiBaAccountAllaccessorsRequest = Record<string, never>;
+interface ZaloAdsAccessorItemDto {
+    /** ID định danh của thành viên trên Zalo Ads (ví dụ: 257887336). */
+    memberId: number;
+    /** Tên hiển thị của thành viên. */
+    memberName: string;
+    /** Số điện thoại của thành viên (định dạng 84...). */
+    memberPhone?: string;
+    /** URL ảnh đại diện của thành viên. */
+    memberAvatar?: string;
+    /** Cấp độ quyền truy cập (0 = Chủ tài khoản gốc). */
+    accessLevel: number;
+}
+interface ZaloAdsAccountAgencyInfoDto {
+    /** Mã định danh của Agency (ví dụ: 277596648). */
+    agencyId: number;
+    /** ID tài khoản chủ sở hữu Agency (ví dụ: 257887336). */
+    ownerId: number;
+    /** Tên pháp nhân hoặc tên hiển thị của Agency. */
+    agencyName: string;
+    /** Thời điểm khởi tạo Agency, định dạng Unix timestamp tính bằng giây. */
+    created?: number;
+    /** Cấp độ quyền của tài khoản hiện tại trong Agency (ví dụ: 9 = Chủ sở hữu Agency). */
+    accessLevel: number;
+}
+/** Lấy danh sách tài khoản hoặc thành viên có quyền truy cập/tạo chiến dịch trên tài khoản quảng cáo hiện tại (dùng cho bộ lọc người tạo hoặc chuyển đổi ngữ cảnh tài khoản). Đây là entry tool thuộc lane zalo-ads-account; hỗ trợ tham số isShowAll (0 hoặc 1) và trả về danh sách personalAccessors, agencyInfo, agencyAccessors. */
+type ZaloAdsGetApiBaAccountAllaccessorsRequest = {
+    /** Cờ hiển thị toàn bộ danh sách người truy cập (0 = Chỉ hiển thị mặc định/đang hoạt động, 1 = Hiển thị tất cả). Mặc định giao diện Zalo Ads truyền 0. */
+    isShowAll?: 0 | 1 | number;
+};
 type ZaloAdsGetApiBaAccountAllaccessorsResponse = {
-    [key: string]: unknown;
+    /** Mã kết quả (0 = Thành công). */
+    code: number;
+    /** Thông điệp trạng thái (ví dụ: 'success'). */
+    msg?: string;
+    data: {
+        /** Danh sách thành viên truy cập cấp tài khoản cá nhân (bao gồm chủ tài khoản với accessLevel = 0). */
+        personalAccessors: Array<ZaloAdsAccessorItemDto>;
+        /** Thông tin Agency liên kết (nếu có). */
+        agencyInfo?: ZaloAdsAccountAgencyInfoDto;
+        /** Danh sách thành viên thuộc Agency có quyền truy cập tài khoản khách hàng này (nếu có). */
+        agencyAccessors?: Array<ZaloAdsAccessorItemDto>;
+    };
 };
-/** Lấy các thành viên đã được cấp quyền trong tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-account; dùng để kiểm tra phạm vi phân quyền trước khi phối hợp quản trị. */
+interface ZaloAdsGrantedMemberItemDto {
+    /** ID định danh của thành viên trên Zalo Ads (ví dụ: 330114198). */
+    memberId: number;
+    /** Tên hiển thị của thành viên. */
+    memberName: string;
+    /** Số điện thoại liên hệ của thành viên (định dạng 84...). */
+    memberPhone?: string;
+    /** URL ảnh đại diện của thành viên. */
+    memberAvatar?: string;
+    /** Cấp độ phân quyền truy cập của thành viên (ví dụ: 1 = Quản trị viên, 2 = Nhà quảng cáo, 3 = Người phân tích/Xem báo cáo). */
+    accessLevel: number;
+}
+/** Lấy danh sách toàn bộ thành viên đã được cấp quyền truy cập trong tài khoản quảng cáo cá nhân và Agency hiện tại. Đây là entry tool thuộc lane zalo-ads-account; dùng để kiểm tra thông tin Agency (agencyInfo), danh sách thành viên được cấp quyền cấp cá nhân (personalGrantedAccessMembers) và cấp Agency (agencyGrantedAccessMembers) trước khi phối hợp quản trị. */
 type ZaloAdsGetApiBaAccountAllgrantedmembersRequest = Record<string, never>;
 type ZaloAdsGetApiBaAccountAllgrantedmembersResponse = {
-    [key: string]: unknown;
+    /** Mã kết quả (0 = Thành công). */
+    code: number;
+    /** Thông điệp trạng thái (ví dụ: 'success'). */
+    msg?: string;
+    data: {
+        /** Danh sách thành viên được cấp quyền truy cập ở cấp tài khoản cá nhân. */
+        personalGrantedAccessMembers: Array<ZaloAdsGrantedMemberItemDto>;
+        /** Thông tin đơn vị Agency quản lý tài khoản (nếu tài khoản là Agency hoặc thuộc Agency). */
+        agencyInfo?: ZaloAdsAccountAgencyInfoDto;
+        /** Danh sách nhân sự/thành viên thuộc Agency được cấp quyền truy cập. */
+        agencyGrantedAccessMembers: Array<ZaloAdsGrantedMemberItemDto>;
+    };
 };
 /** Lấy danh sách nguồn hoặc sự kiện chuyển đổi đã cấu hình. Đây là entry tool thuộc lane zalo-ads-conversion; dùng khi chọn conversion để đo lường hoặc tối ưu chiến dịch. */
 type ZaloAdsGetApiConversionAllRequest = Record<string, never>;
 type ZaloAdsGetApiConversionAllResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsConversionItemDto>;
 };
+interface ZaloAdsStandardEventItemDto {
+    id: number;
+    name: string;
+    code?: string;
+    description?: string;
+}
 /** Lấy danh mục sự kiện chuyển đổi chuẩn mà Zalo Ads hỗ trợ. Đây là helper tool thuộc lane zalo-ads-conversion; dùng khi ánh xạ mục tiêu đo lường vào event chuẩn. */
 type ZaloAdsGetApiConversionStandardEventsRequest = Record<string, never>;
 type ZaloAdsGetApiConversionStandardEventsResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsStandardEventItemDto>;
 };
 /** Lấy danh sách audience tùy chỉnh có thể dùng để nhắm chọn. Đây là entry tool thuộc lane zalo-ads-audience; dùng để chọn, kiểm tra hoặc lấy CustomAudienceId trước khi liên kết hay xóa audience. */
 type ZaloAdsGetApiCustomAudienceAllRequest = {
@@ -1448,15 +1701,57 @@ type ZaloAdsGetApiCustomAudienceAllResponse = {
         CustomAudienceId: number;
     }>;
 };
+interface ZaloAdsFileGroupItemDto {
+    id: number;
+    name: string;
+    memberId?: number;
+    created?: number;
+    totalFiles?: number;
+}
 /** Lấy các nhóm tệp media hiện có trong tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-media; dùng để tìm nơi chứa tài nguyên trước khi chọn ảnh hoặc video. */
 type ZaloAdsGetApiFilegroupsRequest = Record<string, never>;
 type ZaloAdsGetApiFilegroupsResponse = {
-    [key: string]: unknown;
-};
-/** Lấy danh sách nội dung landing page hoặc tin tức có thể dùng trong quảng cáo. Đây là entry tool thuộc lane zalo-ads-content; dùng khi cần chọn nội dung đích cho chiến dịch. */
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsFileGroupItemDto>;
+};
+interface ZaloAdsLpNewsButtonDto {
+    /** Nhãn nút (ví dụ: 'Xem thêm', 'Xem ngay', 'Quảng cáo ngay'). */
+    label: string;
+    /** Đường dẫn URL đích khi nhấn nút. */
+    linkUrl: string;
+    /** Loại điều hướng (1 = Mở tab mới, 2 = Route nội bộ). */
+    type: number;
+    /** Cờ bật/tắt hiển thị nút (dùng cho secondaryButton). */
+    isDisplayed?: boolean;
+}
+interface ZaloAdsLpNewsItemDto {
+    /** Tiêu đề tin tức/sự kiện. */
+    title: string;
+    /** Mô tả ngắn của tin tức/sự kiện. */
+    description: string;
+    /** URL hình ảnh banner của tin tức. */
+    imageUrl: string;
+    /** Cờ cho biết tin tức có hiển thị trên trang Tổng quan (Dashboard) hay không. */
+    displayOnHomePage?: boolean;
+    /** Cờ cho biết tin tức có hiển thị trên trang chủ Landing Page hay không. */
+    displayOnLandingPage?: boolean;
+    /** Cấu hình nút hành động chính trên Dashboard. */
+    primaryButton?: ZaloAdsLpNewsButtonDto;
+    /** Cấu hình nút hành động phụ trên Dashboard. */
+    secondaryButton?: ZaloAdsLpNewsButtonDto;
+    /** Cấu hình nút hành động hiển thị trên popup Landing Page. */
+    landingPageButton?: ZaloAdsLpNewsButtonDto;
+}
+/** Lấy thông tin tin tức/sự kiện nổi bật hiển thị dạng popup nổi (balloon) trên trang chủ Landing Page của Zalo Ads. Đây là entry tool thuộc lane zalo-ads-content; trả về đối tượng tin tức trong data (khi code = 0) hoặc thông báo "Landing page new is empty" (khi code = 1). */
 type ZaloAdsGetApiLpNewsRequest = Record<string, never>;
 type ZaloAdsGetApiLpNewsResponse = {
-    [key: string]: unknown;
+    /** Mã trạng thái (0 = Có tin tức trả về trong data, 1 = Không có tin tức nào đang hiển thị trên Landing Page). */
+    code: number;
+    /** Thông báo trạng thái (ví dụ: 'Landing page new is empty' khi code = 1). */
+    msg?: string;
+    /** Chi tiết bài viết/tin tức nổi bật hiển thị trên Landing Page (chỉ có mặt khi code = 0). */
+    data?: ZaloAdsLpNewsItemDto;
 };
 /** Lấy danh sách ảnh, video hoặc tài nguyên media theo khoảng thời gian. Đây là entry tool thuộc lane zalo-ads-media; dùng khi cần chọn asset đã tải lên cho mẫu quảng cáo. */
 type ZaloAdsGetApiMediaItemsRequest = {
@@ -1484,32 +1779,82 @@ type ZaloAdsGetApiMediaItemsResponse = {
         CreatedBy: number;
     }>;
 };
+interface ZaloAdsMemberFileItemDto {
+    id: number;
+    name: string;
+    fileUrl: string;
+    status?: number;
+    lineNumber?: number;
+    created?: number;
+    memberId?: number;
+}
 /** Lấy các tệp do thành viên hiện tại quản lý trong tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-media; dùng để tra cứu asset theo quyền sở hữu hoặc trạng thái. */
 type ZaloAdsGetApiMemberFilesRequest = Record<string, never>;
 type ZaloAdsGetApiMemberFilesResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsMemberFileItemDto>;
 };
-/** Lấy thông tin thông báo hiển thị ở đầu trang Zalo Ads. Đây là helper tool thuộc lane zalo-ads-notification; dùng khi cần phát hiện cảnh báo hoặc thay đổi cần xử lý. */
+interface ZaloAdsNotifyHeaderItemDto {
+    /** ID định danh của thông báo (ví dụ: 1). */
+    id: number;
+    /** Nội dung chi tiết của thông báo hiển thị trên đầu trang. */
+    text: string;
+}
+/** Lấy danh sách thông báo quan trọng hiển thị trên thanh tiêu đề (header announcements) của trình quản lý Zalo Ads. Đây là helper tool thuộc lane zalo-ads-notification; dùng khi cần kiểm tra các cảnh báo hệ thống hoặc nhắc nhở quan tâm OA Hỗ trợ quảng cáo Zalo Ads. */
 type ZaloAdsGetApiNotifiesHeaderRequest = Record<string, never>;
 type ZaloAdsGetApiNotifiesHeaderResponse = {
-    [key: string]: unknown;
+    /** Mã kết quả (0 = Thành công). */
+    code: number;
+    /** Thông điệp trạng thái (ví dụ: 'success'). */
+    msg?: string;
+    /** Danh sách các thông báo hiển thị ở đầu trang (header banner). */
+    announcements: Array<ZaloAdsNotifyHeaderItemDto>;
 };
-/** Lấy lịch sử giao dịch thanh toán của tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-billing; dùng khi đối soát nạp tiền, chi tiêu hoặc giao dịch trong một khoảng thời gian xác định. */
+/** Lấy lịch sử nạp tiền (charge/payment transaction history) của tài khoản quảng cáo Zalo Ads trong khoảng thời gian tối đa 31 ngày. Đây là entry tool thuộc lane zalo-ads-billing; dùng khi đối soát các giao dịch nạp tiền, ngân hàng, kênh nạp, trạng thái và xuất hóa đơn theo khoảng thời gian xác định. */
 type ZaloAdsGetApiPaymentTransactionHistoryRequest = {
-    /** Mốc kết thúc khoảng thời gian, Unix timestamp theo giây. */
+    /** Mốc thời gian kết thúc khoảng tra cứu, định dạng Unix timestamp tính bằng giây (khoảng cách giữa from và to tối đa 31 ngày). */
     to: number;
-    /** Mốc bắt đầu khoảng thời gian, Unix timestamp theo giây. */
+    /** Mốc thời gian bắt đầu khoảng tra cứu, định dạng Unix timestamp tính bằng giây (khoảng cách giữa from và to tối đa 31 ngày). */
     from: number;
-    /** ID thành viên cần đối soát. Capture đã quan sát giá trị 0; có thể đại diện ngữ cảnh tài khoản hiện tại. */
+    /** ID tài khoản/thành viên cần tra cứu lịch sử nạp tiền. Truyền 0 để lấy theo tài khoản hiện tại đang đăng nhập hoặc truyền ID thành viên cụ thể (ví dụ: 257887336). */
     memberId: number;
 };
+interface ZaloAdsPaymentTransactionItemDto {
+    /** Số tiền nạp (VNĐ), ví dụ: 1000000. */
+    amount: number;
+    /** Tên ngân hàng hoặc nguồn nạp (ví dụ: 'Ngân hàng TMCP Hàng Hải Việt Nam', 'Voucher'). */
+    bankName: string;
+    /** Kênh nạp tiền (ví dụ: 'Chuyển khoản', 'ZaloPay', 'Thẻ ATM', 'Voucher'). */
+    channel: string;
+    /** Nội dung/ghi chú giao dịch nạp tiền. */
+    content: string;
+    /** Thời điểm phát sinh giao dịch nạp tiền, định dạng Unix timestamp tính bằng giây. */
+    date: number;
+    /** ID người hoặc hệ thống thực hiện nạp tiền (ví dụ: 257887336). */
+    createdId: number;
+    /** Tên người hoặc hệ thống thực hiện nạp tiền (ví dụ: 'Zalo Ads'). */
+    createdName: string;
+    /** Tên phụ của đơn vị/người nạp hộ (nếu có). */
+    secondaryName?: string;
+    /** ID tài khoản quảng cáo thụ hưởng số tiền nạp. */
+    memberId: number;
+    /** Cờ đánh dấu giao dịch có xuất hóa đơn (true = Có, false = Không). */
+    receipt: boolean;
+    /** Trạng thái giao dịch nạp tiền (ví dụ: 'Thành công'). */
+    status: string;
+}
 type ZaloAdsGetApiPaymentTransactionHistoryResponse = {
-    /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
+    /** Mã trạng thái phản hồi (0 = Thành công, 1 = Lỗi tham số hoặc vượt quá 31 ngày). */
     code: number;
-    /** Các giao dịch. Cấu trúc từng giao dịch chưa được quan sát vì response mẫu rỗng. */
-    data: Array<{
-        [key: string]: unknown;
-    }>;
+    /** Thông báo trạng thái hoặc chi tiết lỗi từ hệ thống. */
+    msg?: string;
+    /** Danh sách các giao dịch nạp tiền trong khoảng thời gian đã chọn. */
+    data: Array<ZaloAdsPaymentTransactionItemDto>;
+    /** Thông tin bổ sung của tài khoản được tra cứu (khi xem theo memberId). */
+    extend?: {
+        name?: string;
+    };
 };
 /** Lấy danh mục vùng miền, tỉnh thành và ID quận huyện phục vụ nhắm chọn theo vị trí. Đây là helper tool thuộc lane zalo-ads-targeting; dùng khi xây dựng điều kiện địa lý chi tiết. */
 type ZaloAdsGetApiPlaceGetalldistrictsRequest = Record<string, never>;
@@ -1542,10 +1887,46 @@ type ZaloAdsGetApiPlaceGetalldistrictsResponse = {
         };
     };
 };
-/** Kiểm tra chính tả cho nội dung quảng cáo trước khi sử dụng. Đây là helper tool thuộc lane zalo-ads-content; dùng để phát hiện lỗi câu chữ trong tiêu đề hoặc mô tả. */
-type ZaloAdsGetApiSpellCheckV2Request = Record<string, never>;
+interface ZaloAdsSpellCheckIssueDto {
+    /** Mã quy tắc lỗi ('111'/'278' = Lỗi chính tả, '113' = Lỗi lạm dụng kí tự, '121' = Lỗi viết hoa, '236'/'237' = Lỗi sử dụng URL/SĐT). */
+    code?: string;
+    /** Nhãn mô tả loại lỗi hiển thị cho người dùng. */
+    label?: string;
+    /** Vị trí ký tự bắt đầu của cụm từ lỗi (0-indexed). */
+    start: number;
+    /** Vị trí ký tự kết thúc của cụm từ lỗi. */
+    end: number;
+    /** Cụm từ gốc bị phát hiện lỗi trong văn bản đầu vào. */
+    originalText: string;
+    /** Cụm từ gợi ý thay thế (chuỗi rỗng nếu gợi ý xóa bỏ). */
+    text: string;
+    /** Cờ đánh dấu gợi ý là xóa bỏ cụm từ lỗi (true khi text rỗng). */
+    isRemoval?: boolean;
+    /** Mã phân loại diff (mặc định: 0). */
+    type?: number;
+}
+/** Kiểm tra chính tả và quy định nội dung quảng cáo (viết hoa, lạm dụng ký tự, SĐT/URL) bằng AI cho văn bản quảng cáo (tiêu đề hoặc chú thích). Đây là helper tool thuộc lane zalo-ads-content; bắt buộc truyền query param text và trả về danh sách vị trí lỗi kèm gợi ý chỉnh sửa trong trường data.diffs. */
+type ZaloAdsGetApiSpellCheckV2Request = {
+    /** Nội dung văn bản cần kiểm tra chính tả và quy chuẩn quảng cáo (ví dụ: tiêu đề hoặc chú thích mẫu quảng cáo). */
+    text: string;
+};
 type ZaloAdsGetApiSpellCheckV2Response = {
-    [key: string]: unknown;
+    /** Mã kết quả HTTP/API (0 = Thành công). */
+    code: number;
+    /** Thông báo trạng thái (nếu có). */
+    msg?: string;
+    data: {
+        /** UUID định danh phiên yêu cầu AI kiểm tra chính tả (dùng để gắn vào tracking request_ai_id khi lưu quảng cáo). */
+        requestAiId: string;
+        /** Văn bản đầu ra hoàn chỉnh sau khi AI gợi ý chỉnh sửa. */
+        aiOutput: string;
+        /** Thời gian xử lý của AI tính bằng mili giây (ms). */
+        elapsedTime: number;
+        /** Mã trạng thái dịch vụ AI (0 = SUCCESS, -1 = AI_SERVER_FAILURE, -2 = AI_REQUEST_TIMEOUT). */
+        error: number;
+        /** Danh sách các lỗi chính tả hoặc vi phạm quy định từ ngữ phát hiện được trong văn bản. */
+        diffs: Array<ZaloAdsSpellCheckIssueDto>;
+    };
 };
 /** Lấy thông tin tài khoản Zalo Ads hiện được xác thực, gồm ngân sách, hạn mức và các khả năng được cấp. Đây là auth-sensitive entry tool thuộc lane zalo-ads-account; dùng để xác nhận đúng ngữ cảnh tài khoản trước thao tác khác. Dữ liệu cá nhân, hợp đồng và định danh phiên chỉ được xử lý trong phạm vi được ủy quyền. */
 type ZaloAdsGetApiWhoamiRequest = Record<string, never>;
@@ -1591,6 +1972,21 @@ type ZaloAdsGetApiWhoamiResponse = {
             usedSimplifiedVersion?: boolean;
             canUseMiniPageMessageAd?: boolean;
             canUseOptimizeUniversalPixel?: boolean;
+            /** Cho phép dùng kiểm tra chính tả AI (/api/spell-check/v2). */
+            canUseSpellCheck?: boolean;
+            /** Cho phép dùng tính năng tạo nhiều ảnh bằng AI. */
+            canUseMultiImageAi?: boolean;
+            /** Cho phép dùng công cụ tạo video. */
+            canUseVideoCreationTool?: boolean;
+        };
+        /** Thông tin Agency quản lý tài khoản; chỉ xuất hiện khi tài khoản thuộc một Agency. */
+        agencyInfo?: {
+            /** ID Agency. */
+            agencyId?: number;
+            /** Tên Agency. */
+            agencyName?: string;
+            /** Cấp quyền của tài khoản trong Agency (quan sát được: 7, 9). */
+            level?: number;
         };
         /** Tài khoản gốc liên quan; chứa dữ liệu cá nhân. */
         rootMember?: {
@@ -1623,75 +2019,66 @@ type ZaloAdsGetReportapiV2AdsRequest = {
     /** Bắt đầu khoảng báo cáo, Unix epoch giây. */
     startDate: number;
 };
+interface ZaloAdsAdReportItemDto {
+    /** ID quảng cáo; dùng làm adId cho thao tác chi tiết/cập nhật. */
+    id: number;
+    name: string;
+    /** Mã loại quảng cáo upstream; đã quan sát 28. */
+    adType: number;
+    /** Mã trạng thái. Khi lọc dùng Value chuỗi, ví dụ "3" hoặc "4", trong filter. */
+    status: number;
+    /** Unix epoch giây. */
+    endDate: number;
+    /** URL ảnh bìa. */
+    coverUrl?: string;
+    memberId: number;
+    /** Unix epoch giây. */
+    modified?: number;
+    /** Mã read-only upstream; đã quan sát -1, không phải boolean. */
+    readOnly?: number;
+    viewType?: number;
+    createdBy?: number;
+    /** Unix epoch giây. */
+    startDate: number;
+    /** ID chiến dịch chứa quảng cáo. */
+    campaignId: number;
+    memberName?: string;
+    /** Mã loại giá thầu upstream. */
+    adPriceType?: number;
+    /** Metric động; key là mã chỉ số Zalo Ads. */
+    reportTotal: Record<string, number>;
+    campaignName: string;
+    campaignType?: number;
+    conversionId?: number;
+    reportByDate?: Record<string, Record<string, number>>;
+    reportBySubId?: Record<string, Record<string, number>>;
+    adtimaBookingId?: number;
+    reportTotalByTemplate?: Record<string, Record<string, number>>;
+    reportBySubIdThenByDate?: Record<string, Record<string, Record<string, number>>>;
+    reportByTemplateThenByDate?: Record<string, Record<string, Record<string, number>>>;
+}
 type ZaloAdsGetReportapiV2AdsResponse = {
     msg: string;
     /** 0 là thành công. */
     code: number;
-    data: Array<{
-        /** ID quảng cáo; dùng làm adId cho thao tác chi tiết/cập nhật. */
-        id: number;
-        name: string;
-        /** Mã loại quảng cáo upstream; đã quan sát 28. */
-        adType: number;
-        /** Mã trạng thái. Khi lọc dùng Value chuỗi, ví dụ "3" hoặc "4", trong filter. */
-        status: number;
-        /** Unix epoch giây. */
-        endDate: number;
-        /** URL ảnh bìa. */
-        coverUrl?: string;
-        memberId: number;
-        /** Unix epoch giây. */
-        modified?: number;
-        /** Mã read-only upstream; đã quan sát -1, không phải boolean. */
-        readOnly?: number;
-        viewType?: number;
-        createdBy?: number;
-        /** Unix epoch giây. */
-        startDate: number;
-        /** ID chiến dịch chứa quảng cáo. */
-        campaignId: number;
-        memberName?: string;
-        /** Mã loại giá thầu upstream. */
-        adPriceType?: number;
-        /** Metric động; key là mã chỉ số Zalo Ads. */
-        reportTotal: {
-            [key: string]: number;
-        };
-        campaignName: string;
-        campaignType?: number;
-        conversionId?: number;
-        reportByDate?: {
-            [key: string]: {
-                [key: string]: number;
-            };
-        };
-        reportBySubId?: {
-            [key: string]: {
-                [key: string]: number;
-            };
-        };
-        adtimaBookingId?: number;
-        reportTotalByTemplate?: {
-            [key: string]: {
-                [key: string]: number;
-            };
-        };
-        reportBySubIdThenByDate?: {
-            [key: string]: {
-                [key: string]: {
-                    [key: string]: number;
-                };
-            };
-        };
-        reportByTemplateThenByDate?: {
-            [key: string]: {
-                [key: string]: {
-                    [key: string]: number;
-                };
-            };
-        };
-    }>;
+    data: Array<ZaloAdsAdReportItemDto>;
 };
+interface ZaloAdsCampaignReportItemDto {
+    id: number;
+    name: string;
+    status: number;
+    endDate: number;
+    memberId: number;
+    readOnly: number;
+    viewType: number;
+    startDate: number;
+    memberName?: string;
+    /** Metric động; key là mã chỉ số Zalo Ads. */
+    reportTotal: Record<string, number>;
+    campaignType: number;
+    adtimaCampaignId: number;
+    reportByDate?: Record<string, Record<string, number>>;
+}
 /** Lấy báo cáo chi tiết của một chiến dịch đã biết. Đây là detail tool thuộc lane zalo-ads-reporting; dùng khi đã có campaign ID và cần xem chỉ số hiệu quả của chiến dịch đó. */
 type ZaloAdsGetReportapiV2CampaignsRequest = {
     /** ID chiến dịch cần xem báo cáo. */
@@ -1702,15 +2089,33 @@ type ZaloAdsGetReportapiV2CampaignsRequest = {
     endDate?: number;
     /** Mốc làm mới truy vấn, Unix timestamp mili giây. */
     refresh?: number | string;
-    [key: string]: unknown;
 };
 type ZaloAdsGetReportapiV2CampaignsResponse = {
-    [key: string]: unknown;
-};
-/** Lấy thống kê người dùng duy nhất tiếp cận hoặc tương tác với quảng cáo. Đây là entry tool thuộc lane zalo-ads-reporting; dùng khi đánh giá độ phủ thay vì tổng số lượt hiển thị. */
-type ZaloAdsGetReportapiV2UniqueUserRequest = Record<string, never>;
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsCampaignReportItemDto>;
+};
+interface ZaloAdsUniqueUserReportDataDto {
+    totalUniqueUsers: number;
+    totalReach?: number;
+    frequency?: number;
+    byDate?: Record<string, number>;
+}
+/** Lấy thống kê người dùng duy nhất tiếp cận hoặc tương tác với quảng cáo / chiến dịch (GET https://ads.zalo.me/reportapi/v2/unique-user). */
+type ZaloAdsGetReportapiV2UniqueUserRequest = {
+    start: number;
+    end: number;
+    campaignId?: number | string;
+    adId?: number | string;
+};
 type ZaloAdsGetReportapiV2UniqueUserResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data: number;
+    extend?: Array<{
+        adId: number;
+        count: number;
+    }>;
 };
 /** Lấy báo cáo hiệu quả campaign theo phiên bản dữ liệu báo cáo v3. Đây là entry tool thuộc lane zalo-ads-reporting; dùng khi cần tổng hợp hoặc so sánh chỉ số nhiều chiến dịch trong một khoảng thời gian. */
 type ZaloAdsGetReportapiV3CampaignsRequest = {
@@ -1730,130 +2135,181 @@ type ZaloAdsGetReportapiV3CampaignsRequest = {
 type ZaloAdsGetReportapiV3CampaignsResponse = {
     msg: string;
     code: number;
-    data: Array<{
-        id: number;
-        name: string;
-        status: number;
-        endDate: number;
-        memberId: number;
-        readOnly: number;
-        viewType: number;
-        startDate: number;
-        memberName?: string;
-        /** Metric động; key là mã chỉ số Zalo Ads. */
-        reportTotal: {
-            [key: string]: number;
-        };
-        campaignType: number;
-        adtimaCampaignId: number;
-    }>;
+    data: Array<ZaloAdsCampaignReportItemDto>;
 };
-/** Lấy báo cáo hiệu quả của campaign theo dữ liệu vận hành Zalo Ads. Đây là detail tool thuộc lane zalo-ads-reporting; dùng khi cần kiểm tra chỉ số và trạng thái của một chiến dịch. */
+interface ZaloAdsZaapiCampaignReportItemDto {
+    AdId: number;
+    AdName: string;
+    CampaignId: number;
+    CampaignName: string;
+    CampaignType: number;
+    Date: number;
+    Cost: number;
+    Quantity: number;
+}
+/** Lấy báo cáo hiệu quả của campaign theo dữ liệu vận hành Zalo Ads (GET https://ads.zalo.me/zaapi/Campaign/reportCampaign). */
 type ZaloAdsGetZaapiCampaignReportcampaignRequest = {
-    campaignId?: number | string;
+    campaignId: number | string;
+    from: number;
+    to: number;
     campId?: number | string;
-    [key: string]: unknown;
 };
 type ZaloAdsGetZaapiCampaignReportcampaignResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data?: Array<ZaloAdsZaapiCampaignReportItemDto>;
 };
 /** Kiểm tra một chiến dịch có chứa nhiều quảng cáo hay không. Đây là helper tool thuộc lane zalo-ads-campaign; dùng trước khi chọn luồng xem hoặc cập nhật quảng cáo trong campaign. */
 type ZaloAdsGetZaapiCheckcamphasmanyadsRequest = {
     campaignId?: number | string;
     campId?: number | string;
-    [key: string]: unknown;
 };
 type ZaloAdsGetZaapiCheckcamphasmanyadsResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data: boolean | number;
 };
 /** Lấy danh sách quảng cáo thuộc một chiến dịch. Đây là entry tool thuộc lane zalo-ads-ad; dùng khi đã có campaign ID và cần chọn quảng cáo để xem hoặc chỉnh sửa. */
 type ZaloAdsGetZaapiGetadsfromcampaignidRequest = {
     campaignId?: number | string;
     campId?: number | string;
-    [key: string]: unknown;
 };
 type ZaloAdsGetZaapiGetadsfromcampaignidResponse = {
-    [key: string]: unknown;
-};
-/** Lấy danh sách tất cả Zalo Official Account hoặc trang có thể sử dụng. Đây là entry tool thuộc lane zalo-ads-page; dùng khi cần chọn page/OA trước khi tạo chiến dịch. */
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsAdUpdatePayloadDto>;
+};
+interface ZaloAdsPageConfigDto {
+    /** Hạng tài khoản OA (ví dụ: 0 = Phổ thông, 1 = Xác thực/Nâng cao). */
+    tier?: number;
+    viewStatus?: number;
+    isVerified?: boolean;
+    allowMessage?: boolean;
+}
+/** Một địa điểm trong `extraInfo.locations` của OA (quan sát trên 67 địa điểm của 64 OA). */
+interface ZaloAdsOwnedPageLocationDto {
+    /** Địa chỉ đầy đủ. */
+    address: string;
+    /** Mã tỉnh/thành. */
+    provinceId: number;
+    /** Mã quận/huyện; chỉ có ở 64/67 địa điểm quan sát được. */
+    districtId?: number;
+    /** Vĩ độ. */
+    lat: number;
+    /** Kinh độ. */
+    lng: number;
+}
+/** Cấu trúc của chuỗi JSON `extraInfo` sau khi `JSON.parse`. Dữ liệu cá nhân, chỉ xử lý trong phạm vi được ủy quyền. */
+interface ZaloAdsOwnedPageExtraInfoDto {
+    website: string | null;
+    contactName: string;
+    hotline: string | null;
+    workingTime: string | null;
+    /** Số điện thoại liên hệ dạng quốc tế, ví dụ "84384473007". */
+    contactPhone: string;
+    locations: Array<ZaloAdsOwnedPageLocationDto>;
+}
+interface ZaloAdsOwnedPageItemDto {
+    /** ID nội bộ page/OA (trùng với pageId, ví dụ: 429753475). */
+    id: number;
+    /** Tên danh mục ngành nghề, khi có. */
+    cate?: string;
+    /** Tên page/OA. */
+    name: string;
+    /** Loại page/OA (ví dụ: 2 = Doanh nghiệp/Cửa hàng). */
+    type: number;
+    /** Cờ store (0 hoặc 1). */
+    store?: number;
+    /** Cấu hình phân hạng page/OA thay đổi theo loại. */
+    config?: ZaloAdsPageConfigDto;
+    /** ID nội bộ của page/OA dùng trong các API Zalo Ads như tạo chiến dịch (/zaapi/addNewCamp) hoặc lấy danh sách bài viết (/zaapi/getOwnedArticles). */
+    pageId: number;
+    /** Trạng thái hoạt động page/OA (ví dụ: 1 = Đang hoạt động). */
+    status: number;
+    /** Các ID danh mục ngành nghề (ví dụ: [10018]). */
+    cateIds?: Array<number>;
+    /** ID chủ sở hữu, chỉ xử lý trong phạm vi được ủy quyền. */
+    ownerId?: number;
+    configAd?: {
+        /** Trạng thái hiển thị quảng cáo (ví dụ: 1 = Cho phép). */
+        viewStatus?: number;
+    };
+    /** URL ảnh bìa, khi có. */
+    coverUrl?: string;
+    /** Mã định danh OA làm nhiễu dạng chuỗi số dài (trùng với pageIdNoised). */
+    noisedId?: string;
+    /** Tên hiển thị page/OA. */
+    pageName: string;
+    /** URL ảnh đại diện, khi có. */
+    avatarUrl?: string;
+    /** Cho biết OA đã chứng thực tích vàng (true) hay chưa (false). */
+    certified?: boolean;
+    /** Chuỗi JSON chứa thông tin liên hệ (website, contactName, hotline, contactPhone, workingTime) và danh sách vị trí (locations), khi có. */
+    extraInfo?: string;
+    /** Trạng thái vận hành page/OA (ví dụ: 1 = Hoạt động bình thường). */
+    pageStatus: number;
+    /** Thời điểm tạo dạng Unix timestamp mili giây. */
+    createdTime?: number;
+    /** Mô tả page/OA, khi có. */
+    description?: string;
+    /** Thời điểm cập nhật dạng Unix timestamp mili giây. */
+    updatedTime?: number;
+    /** Mã định danh OA công khai/làm nhiễu dạng chuỗi số dài (ví dụ: '305001418732969574'), dùng làm oaId trong các API Instant Pages, Zalo Forms và Message Flows. */
+    pageIdNoised?: string;
+}
+/** Lấy danh sách tất cả Zalo Official Account hoặc trang có thể sử dụng. Đây là entry tool thuộc lane zalo-ads-page; dùng khi cần chọn page/OA trước khi tạo chiến dịch hoặc lấy bài viết OA. */
 type ZaloAdsGetZaapiGetallpagesRequest = Record<string, never>;
 type ZaloAdsGetZaapiGetallpagesResponse = {
-    [key: string]: unknown;
-};
-/** Lấy các bài viết thuộc những OA mà tài khoản có quyền quản lý. Đây là entry tool thuộc lane zalo-ads-content; dùng khi chọn bài viết nguồn cho quảng cáo bài viết. */
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsOwnedPageItemDto>;
+};
+interface ZaloAdsOwnedArticleItemDto {
+    /** Mã định danh nội bộ của bài viết (ví dụ: 17050656), dùng để truyền vào trường articleId khi tạo chiến dịch Quảng cáo Bài viết (campaignType = 4) hoặc ZaloFeedId khi cập nhật quảng cáo. */
+    articleId: number;
+    /** ID nội bộ của trang Zalo Official Account sở hữu bài viết (ví dụ: 429753475). */
+    pageId: number;
+    /** Tiêu đề của bài viết. */
+    title: string;
+    /** Đoạn mô tả tóm tắt (sapo) của bài viết. */
+    description?: string;
+    /** Đường dẫn URL công khai để xem bài viết trên Zalo OA (ví dụ: 'https://post.oa.zalo.me/d?id=...&pageId=...'). */
+    viewUrl: string;
+    /** URL ảnh đại diện thu nhỏ (thumbnail) của bài viết. */
+    thumbnail?: string;
+    /** Tổng số lượt xem bài viết. */
+    numViews?: number;
+    /** Tổng số lượt chia sẻ bài viết. */
+    numShares?: number;
+    /** Cờ đánh dấu bài viết định dạng video (true) hay bài viết thông thường (false). */
+    isVideoArticle: boolean;
+}
+/** Lấy danh sách các bài viết đã xuất bản thuộc một trang Zalo Official Account (OA) cụ thể theo mã pageId nội bộ. Đây là entry tool thuộc lane zalo-ads-content / zalo-ads-article; dùng khi chọn bài viết nguồn cho quảng cáo bài viết (campaignType = 4). */
 type ZaloAdsGetZaapiGetownedarticlesRequest = {
-    pageId?: number | string;
-    oaId?: number | string;
-    [key: string]: unknown;
+    /** ID nội bộ của trang Zalo Official Account (trường pageId hoặc id kiểu số nguyên lấy từ getZaapiGetownedpages / getZaapiGetallpages, ví dụ: 429753475). Không truyền pageIdNoised. */
+    pageId: number | string;
 };
 type ZaloAdsGetZaapiGetownedarticlesResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg?: string;
+    data: Array<ZaloAdsOwnedArticleItemDto>;
 };
-/** Lấy các OA do tài khoản hiện tại sở hữu hoặc quản lý. Đây là entry tool thuộc lane zalo-ads-page; dùng để lấy page ID hợp lệ trước khi cấu hình campaign. */
+/** Lấy các OA do tài khoản hiện tại sở hữu hoặc quản lý. Đây là entry tool thuộc lane zalo-ads-page; dùng để lấy page ID hợp lệ trước khi cấu hình campaign hoặc lấy bài viết OA. */
 type ZaloAdsGetZaapiGetownedpagesRequest = Record<string, never>;
 type ZaloAdsGetZaapiGetownedpagesResponse = {
     /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
     code: number;
     /** Danh sách page/OA. */
-    data: Array<{
-        /** ID nội bộ page/OA. */
-        id: number;
-        /** Tên danh mục, khi có. */
-        cate?: string;
-        /** Tên page/OA. */
-        name: string;
-        /** Loại page/OA. */
-        type: number;
-        /** Cờ store. */
-        store?: number;
-        /** Cấu hình page/OA thay đổi theo loại. */
-        config?: {
-            [key: string]: unknown;
-        };
-        /** ID page/OA dùng trong các API Zalo Ads. */
-        pageId: number;
-        /** Trạng thái page/OA. */
-        status: number;
-        /** Các ID danh mục. */
-        cateIds?: Array<number>;
-        /** ID chủ sở hữu, chỉ xử lý trong phạm vi được ủy quyền. */
-        ownerId?: number;
-        configAd?: {
-            /** Trạng thái hiển thị quảng cáo. */
-            viewStatus?: number;
-        };
-        /** URL ảnh bìa, khi có. */
-        coverUrl?: string;
-        /** ID làm nhiễu, khi API trả về. */
-        noisedId?: string;
-        /** Tên hiển thị page/OA. */
-        pageName: string;
-        /** URL ảnh đại diện, khi có. */
-        avatarUrl?: string;
-        /** Cho biết OA đã chứng thực hay chưa. */
-        certified?: boolean;
-        /** Chuỗi JSON chứa thông tin liên hệ và vị trí, khi có; có thể là dữ liệu cá nhân. */
-        extraInfo?: string;
-        /** Trạng thái vận hành page/OA. */
-        pageStatus: number;
-        /** Thời điểm tạo dạng Unix timestamp mili giây. */
-        createdTime?: number;
-        /** Mô tả page/OA, khi có. */
-        description?: string;
-        /** Thời điểm cập nhật dạng Unix timestamp mili giây. */
-        updatedTime?: number;
-        /** ID làm nhiễu của page/OA, khi API trả về. */
-        pageIdNoised?: string;
-    }>;
+    data: Array<ZaloAdsOwnedPageItemDto>;
 };
 /** Lấy khách hàng thuộc agency cùng ngân sách, hạn mức và trạng thái truy cập. Đây là auth-sensitive entry tool thuộc lane zalo-ads-agency; dùng khi cần đối soát danh sách khách hàng hoặc hạn mức theo agency. Dữ liệu định danh và số điện thoại thành viên chỉ được xử lý trong phạm vi được ủy quyền. */
 type ZaloAdsListAgencyCustomersWithBudgetRequest = {
-    /** Số khách hàng tối đa mỗi lần lấy. */
-    limit: number;
-    /** Vị trí bắt đầu để phân trang, gốc 0. */
-    offset: number;
-    /** Sắp xếp ngày tham gia tăng dần khi là true. */
-    joinDateAsc: boolean;
+    /** Số khách hàng tối đa mỗi lần lấy (mặc định: 15). */
+    limit?: number;
+    /** Vị trí bắt đầu để phân trang, gốc 0 (mặc định: 0). */
+    offset?: number;
+    /** Sắp xếp ngày tham gia tăng dần khi là true (mặc định: true). */
+    joinDateAsc?: boolean;
 };
 type ZaloAdsListAgencyCustomersWithBudgetResponse = {
     /** Thông điệp kết quả. */
@@ -1968,9 +2424,7 @@ type ZaloAdsListFormsByOfficialAccountResponse = {
             /** Trạng thái mở rộng section. */
             expand: boolean;
             /** Nội dung section thay đổi theo type, ví dụ images, videos hoặc table. */
-            content: {
-                [key: string]: unknown;
-            };
+            content: ZaloAdsFormSectionContentDto;
             /** Cho biết section bị vô hiệu hóa hay không. */
             disable: boolean;
         }>;
@@ -2004,7 +2458,9 @@ type ZaloAdsListFormsByOfficialAccountResponse = {
         updatedAt?: number;
         /** Các điều kiện bổ sung, khi có. */
         conditions?: Array<{
-            [key: string]: unknown;
+            field?: string;
+            operator?: string;
+            value?: string | number;
         }>;
         /** URL ảnh bìa, khi có. */
         coverPhoto?: string;
@@ -2018,7 +2474,8 @@ type ZaloAdsListFormsByOfficialAccountResponse = {
         gotoActionType?: number;
         /** Nhóm câu hỏi, khi có. */
         groupQuestions?: Array<{
-            [key: string]: unknown;
+            groupIdx?: number;
+            title?: string;
         }>;
         /** Cờ widget đồng ý OA. */
         oaConsentWidget?: boolean;
@@ -2117,34 +2574,50 @@ type ZaloAdsPostApiAdEstimateaudienceResponse = {
         };
     };
 };
+interface ZaloAdsMediaSaveSettingsDto {
+    Url: string;
+    Width: number;
+    Height: number;
+    Duration?: number;
+    ThumbUrl?: string;
+}
+interface ZaloAdsMediaSavePayloadDto {
+    Name: string;
+    Type: number;
+    Settings: ZaloAdsMediaSaveSettingsDto;
+}
 /** Lưu tài nguyên media vào thư viện Zalo Ads sau khi đã có URL ảnh hoặc video và metadata kích thước. Đây là mutation tool thuộc lane zalo-ads-media; dùng sau bước upload để nhận MediaId cho cấu hình quảng cáo. */
 type ZaloAdsPostApiMediaSaveRequest = {
-    /** Chuỗi JSON media gồm Name (tên), Type (loại) và Settings với Url, Width, Height. Form-urlencoded field name là data. */
-    data: string;
+    /** Chuỗi JSON hoặc object media gồm Name (tên), Type (loại) và Settings với Url, Width, Height. Form-urlencoded field name là data. */
+    data: ZaloAdsMediaSavePayloadDto | string;
 };
 type ZaloAdsPostApiMediaSaveResponse = {
     code: number;
     /** ID media vừa được lưu. */
     data: number;
 };
-/** Tải ảnh lên kho media của tài khoản quảng cáo. Đây là mutation tool thuộc lane zalo-ads-media; dùng khi cần tạo asset ảnh trước bước cấu hình quảng cáo. Field multipart file là giả định tạm thời và cần xác minh bằng Form Data thực tế. */
+/** Tải ảnh lên kho media của tài khoản quảng cáo (`POST /api/member/upload-image`). Đây là mutation tool thuộc lane zalo-ads-media; dùng khi cần tạo asset ảnh trước bước cấu hình quảng cáo. Đã xác minh thực tế trên Zalo Ads sử dụng trường multipart `File` (chữ hoa). */
 type ZaloAdsPostApiMemberUploadImageRequest = {
-    /** Tệp ảnh cần tải lên; field name file là giả định tạm thời. */
-    file: FileInput;
+    /** Tệp ảnh cần tải lên (URL HTTP/HTTPS, đường dẫn file local trong Node.js, hoặc Blob/Uint8Array). */
+    File?: FileInput;
+    /** Alias tương thích ngược cho `File` (service tự ánh xạ sang `File`). */
+    file?: FileInput;
 };
 type ZaloAdsPostApiMemberUploadImageResponse = {
     /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
     code: number;
     /** URL ảnh do Zalo Ads trả về. */
     data: string;
+    msg?: string;
 };
 /** Xóa hoặc gỡ một quảng cáo đã chọn khỏi Zalo Ads. Đây là mutation tool thuộc lane zalo-ads-ad; chỉ dùng khi đã xác nhận đúng quảng cáo cần xóa. */
 type ZaloAdsPostZaapiDeleteadRequest = {
     adId?: number | string;
-    [key: string]: unknown;
 };
 type ZaloAdsPostZaapiDeleteadResponse = {
-    [key: string]: unknown;
+    code: number;
+    msg: string;
+    data?: number | boolean;
 };
 /** Đổi tên hiển thị của một chiến dịch Zalo Ads đã tồn tại. Đây là mutation tool thuộc lane quản lý chiến dịch; dùng khi chỉ cần thay tên mà không thay đổi ngân sách, lịch chạy hoặc quảng cáo bên trong. Kết quả chỉ xác nhận thao tác thành công hoặc trả lỗi từ Zalo Ads. */
 type ZaloAdsRenameCampaignRequest = {
@@ -2164,26 +2637,26 @@ type ZaloAdsUpdateEcommerceAdRequest = {
     est?: string;
     stt?: number | string;
     /** Payload cập nhật quảng cáo E-commerce / Commerce (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsAdUpdatePayloadDto | string;
     isBoostAd?: number | string;
 };
 type ZaloAdsUpdateEcommerceAdResponse = {
     msg: string;
     code: number;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 };
 /** Cập nhật quảng cáo biểu mẫu (Form) đang có trên Zalo Ads (Type = 18). */
 type ZaloAdsUpdateFormAdRequest = {
     est?: string;
     stt?: number | string;
     /** Payload cập nhật quảng cáo biểu mẫu (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsAdUpdatePayloadDto | string;
     isBoostAd?: number | string;
 };
 type ZaloAdsUpdateFormAdResponse = {
     msg: string;
     code: number;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 };
 /** Cấu hình đầy đủ của quảng cáo Tin nhắn. Giữ lại các trường hệ thống lấy từ getAdById khi cập nhật. */
 declare class ZaloAdsMessageAdUpdateDataDto {
@@ -2195,23 +2668,7 @@ declare class ZaloAdsMessageAdUpdateDataDto {
     AdName: string;
     /** 20 (hoặc 19) là quảng cáo Tin nhắn. */
     Type: number;
-    Settings: {
-        Image: Record<string, unknown>;
-        Price: {
-            Bid: number;
-            Type: number;
-            Limit: number;
-            LimitType: number;
-            SpendingMethod: number;
-        };
-        AdInfo: Record<string, unknown>;
-        AppInfo: Record<string, unknown>;
-        Targeting: Record<string, unknown>;
-        Rating?: number;
-        NewFeatures?: unknown[];
-        CreatedClientVersion?: number;
-        [key: string]: unknown;
-    };
+    Settings: ZaloAdsAdSettingsDto;
     Status: number;
     StartDate: number;
     EndDate: number;
@@ -2221,12 +2678,11 @@ declare class ZaloAdsMessageAdUpdateDataDto {
     ZaloFormId?: string;
     ConversionId?: number;
     Report?: Record<string, number>;
-    [key: string]: unknown;
 }
 /** Cập nhật quảng cáo Tin nhắn. Service tự JSON.stringify data rồi gửi form-urlencoded. */
 declare class ZaloAdsUpdateMessageAdRequest {
     /** Payload quảng cáo đầy đủ (object hoặc chuỗi JSON); service tự tuần tự hóa thành field form data. */
-    data: ZaloAdsMessageAdUpdateDataDto | Record<string, unknown> | string;
+    data: ZaloAdsMessageAdUpdateDataDto | ZaloAdsAdUpdatePayloadDto | string;
     /** Tham số UI phụ trợ; capture Zalo Ads có giá trị literal "undefined". */
     est?: string;
     /** 0 là quảng cáo thông thường, 1 là boost ad. */
@@ -2237,7 +2693,7 @@ declare class ZaloAdsUpdateMessageAdRequest {
 declare class ZaloAdsUpdateMessageAdResponse {
     msg: string;
     code: number;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 }
 /** Tải ảnh và thiết lập vùng crop để tạo asset dùng cho quảng cáo Zalo Ads (`POST /zaapi/UploadCrop`). Đây là mutation tool thuộc lane zalo-ads-media; dùng trước khi đưa URL asset kết quả vào quảng cáo Display. Cần có URL ảnh nguồn và đầy đủ x, y, width, height, scale; dùng toàn bộ 0 cùng scale 1 khi không crop. */
 type ZaloAdsUpdateNewAdsRequest = {
@@ -2255,41 +2711,40 @@ type ZaloAdsUpdateNewAdsRequest = {
     scale: number;
 };
 type ZaloAdsUpdateNewAdsResponse = {
-    code?: number;
+    code: number;
     msg?: string;
-    data?: unknown;
-    [key: string]: unknown;
+    data?: string;
 };
 /** Cập nhật quảng cáo Zalo Official Account hiện có (Type = 2 hoặc 10). */
 type ZaloAdsUpdateOfficialAccountAdRequest = {
     est?: string;
     stt?: number | string;
     /** Payload cập nhật quảng cáo Official Account (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsAdUpdatePayloadDto | string;
     isBoostAd?: number | string;
 };
 type ZaloAdsUpdateOfficialAccountAdResponse = {
     msg: string;
     code: number;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 };
 /** Cập nhật quảng cáo Bài viết hiện có trên Zalo Ads (Type = 3 hoặc 12). */
 type ZaloAdsUpdatePostAdRequest = {
     est?: string;
     stt?: number | string;
     /** Payload cập nhật quảng cáo Bài viết (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsAdUpdatePayloadDto | string;
     isBoostAd?: number | string;
 };
 type ZaloAdsUpdatePostAdResponse = {
     msg: string;
     code: number;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 };
 /** Tạo chiến dịch quảng cáo Website trên Zalo Ads (campaignType = 1, Type = 9). */
 type ZaloAdsCreateWebsiteCampaignRequest = {
     /** Cấu hình chiến dịch Website (object hoặc chuỗi JSON): { name, campaignType: 1, pageId, productId: -1, targetUrl, adtype: -1, budgetType: 0, budgetlimit, limitType: 0, campaignObjective: 0, campaignId: 0, adId: 0 }. */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateWebsiteCampaignResponse = {
     code: number;
@@ -2304,18 +2759,18 @@ type ZaloAdsUpdateWebsiteAdRequest = {
     est?: string;
     stt?: number | string;
     /** Payload cập nhật quảng cáo Website (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsAdUpdatePayloadDto | string;
     isBoostAd?: number | string;
 };
 type ZaloAdsUpdateWebsiteAdResponse = {
     code: number;
     msg: string;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 };
 /** Tạo chiến dịch quảng cáo Display trên Zalo Ads (campaignType = 1, Type = 2). */
 type ZaloAdsCreateDisplayCampaignRequest = {
     /** Cấu hình chiến dịch Display (object hoặc chuỗi JSON): { name, campaignType: 1, pageId: -1, productId: -1, targetUrl, adtype: 2, budgetType: 1, budgetlimit, limitType: 1, campaignObjective: 0, campaignId: 0, adId: 0 }. */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateDisplayCampaignResponse = {
     code: number;
@@ -2330,18 +2785,18 @@ type ZaloAdsUpdateDisplayAdRequest = {
     est?: string;
     stt?: number | string;
     /** Payload cập nhật quảng cáo Display (object hoặc chuỗi JSON). */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsAdUpdatePayloadDto | string;
     isBoostAd?: number | string;
 };
 type ZaloAdsUpdateDisplayAdResponse = {
     code: number;
     msg: string;
-    data?: unknown;
+    data?: ZaloAdsAdMutationResultDto;
 };
 /** Tạo chiến dịch quảng cáo Video trên Zalo Ads (campaignType = 3, Type = 11). */
 type ZaloAdsCreateVideoCampaignRequest = {
     /** Cấu hình chiến dịch Video (object hoặc chuỗi JSON): { name, campaignType: 3, pageId: -1, productId: -1, targetUrl, adtype: -1, budgetType: 1, budgetlimit, limitType: 1, campaignObjective: 0, campaignId: 0, adId: 0 }. */
-    data: Record<string, unknown> | string;
+    data: ZaloAdsCampaignCreatePayloadDto | string;
 };
 type ZaloAdsCreateVideoCampaignResponse = {
     code: number;
@@ -2364,6 +2819,34 @@ type ZaloAdsDeleteCampaignResponse = {
     /** Thông báo kết quả: "Xóa chiến dịch thành công." */
     msg: string;
 };
+interface ZaloAdsAutomatedRuleActionDto {
+    /** Mã loại hành động thực thi khi thỏa mãn điều kiện (ví dụ: 5). */
+    type: number;
+    /** Mã trường mục tiêu mà hành động tác động (ví dụ: 1). */
+    field: number;
+    /** Giới hạn trần hoặc sàn của hành động điều chỉnh (ví dụ: 1000000). */
+    limit: number;
+    /** Mảng giá trị tham số của hành động (ví dụ: [5] tương ứng mức thay đổi 5%). */
+    values: Array<number>;
+}
+interface ZaloAdsAutomatedRuleConditionDto {
+    /** Mã loại điều kiện đánh giá (ví dụ: 1). */
+    type: number;
+    /** Mã chỉ số đo lường dùng làm điều kiện (ví dụ: 11). */
+    field: number;
+    /** Giá trị ngưỡng so sánh của điều kiện (ví dụ: [1000]). */
+    values: Array<number>;
+    /** Mã toán tử so sánh của điều kiện (ví dụ: 1). */
+    operator: number;
+    /** Mã khoảng thời gian lấy dữ liệu đối chiếu điều kiện (ví dụ: 2). */
+    timeRange: number;
+}
+interface ZaloAdsAutomatedRuleScheduleDto {
+    type?: number;
+    frequency?: number;
+    hours?: Array<number>;
+    daysOfWeek?: Array<number>;
+}
 /** Tìm kiếm và lấy danh sách quy tắc tự động (Automated Rules) trên Zalo Ads. */
 type ZaloAdsListAutomatedRulesRequest = {
     /** Từ khóa lọc theo tên quy tắc tự động (truyền "" để lấy toàn bộ). */
@@ -2378,19 +2861,16 @@ type ZaloAdsListAutomatedRulesResponse = {
             memberId: number;
             createdBy: number;
             ruleName: string;
-            action: Record<string, unknown>;
-            conditions: Array<Record<string, unknown>>;
-            schedule: Record<string, unknown>;
+            action: ZaloAdsAutomatedRuleActionDto;
+            conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
+            schedule: ZaloAdsAutomatedRuleScheduleDto;
             status: number;
             createdTime: number;
             appliedTo: number;
-            [key: string]: unknown;
         };
         campaignIds?: number[];
         adIds?: number[];
-        [key: string]: unknown;
     }>;
-    [key: string]: unknown;
 };
 /** Tạo mới một quy tắc tự động (Automated Rule) trên Zalo Ads với phạm vi áp dụng, hành động thực thi, bộ điều kiện kích hoạt và tần suất kiểm tra. Đây là mutation tool thuộc lane zalo-ads-automation. */
 type ZaloAdsCreateAutomatedRuleRequest = {
@@ -2399,41 +2879,18 @@ type ZaloAdsCreateAutomatedRuleRequest = {
     /** Tên quy tắc tự động cần tạo. */
     ruleName: string;
     /** Cấu hình hành động tự động thực thi khi các điều kiện được thỏa mãn. */
-    action: {
-        /** Mã loại hành động thực thi khi thỏa mãn điều kiện (ví dụ: 5). */
-        type: number;
-        /** Mã trường mục tiêu mà hành động tác động (ví dụ: 1). */
-        field: number;
-        /** Giới hạn trần hoặc sàn của hành động điều chỉnh (ví dụ: 1000000). */
-        limit: number;
-        /** Mảng giá trị tham số của hành động (ví dụ: [5] tương ứng mức thay đổi 5%). */
-        values: Array<number>;
-        [key: string]: unknown;
-    } | Record<string, unknown>;
+    action: ZaloAdsAutomatedRuleActionDto;
     /** Danh sách các điều kiện kích hoạt quy tắc tự động. */
-    conditions: Array<{
-        /** Mã loại điều kiện đánh giá (ví dụ: 1). */
-        type: number;
-        /** Mã chỉ số đo lường dùng làm điều kiện (ví dụ: 11). */
-        field: number;
-        /** Giá trị ngưỡng so sánh của điều kiện (ví dụ: [1000]). */
-        values: Array<number>;
-        /** Mã toán tử so sánh của điều kiện (ví dụ: 1). */
-        operator: number;
-        /** Mã khoảng thời gian lấy dữ liệu đối chiếu điều kiện (ví dụ: 2). */
-        timeRange: number;
-        [key: string]: unknown;
-    } | Record<string, unknown>>;
+    conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
     /** Tần suất hệ thống chạy kiểm tra quy tắc (ví dụ: 12). */
     frequency?: number;
     /** Danh sách ID chiến dịch hoặc quảng cáo cụ thể áp dụng quy tắc; truyền mảng rỗng [] nếu áp dụng theo toàn bộ scope. */
     appliedIds?: Array<number>;
     /** Trường tương thích ngược với cấu trúc cũ. */
     appliedTo?: number;
-    schedule?: Record<string, unknown>;
+    schedule?: ZaloAdsAutomatedRuleScheduleDto;
     campaignIds?: number[];
     adIds?: number[];
-    [key: string]: unknown;
 };
 type ZaloAdsCreateAutomatedRuleResponse = {
     /** Mã kết quả phản hồi từ Zalo Ads (0 là tạo quy tắc thành công). */
@@ -2441,8 +2898,7 @@ type ZaloAdsCreateAutomatedRuleResponse = {
     /** Thông điệp kết quả xử lý (ví dụ: 'Quy tắc của bạn đã được tạo thành công.'). */
     msg?: string;
     /** ID quy tắc tự động vừa tạo hoặc cờ kết quả trả về từ hệ thống (ví dụ: 1). */
-    data?: number | unknown;
-    [key: string]: unknown;
+    data?: number;
 };
 /** Cập nhật quy tắc tự động (Automated Rule) trên Zalo Ads. */
 type ZaloAdsUpdateAutomatedRuleRequest = {
@@ -2450,18 +2906,16 @@ type ZaloAdsUpdateAutomatedRuleRequest = {
     rowVersion: number;
     appliedTo: number;
     ruleName: string;
-    action: Record<string, unknown>;
-    conditions: Array<Record<string, unknown>>;
-    schedule: Record<string, unknown>;
+    action: ZaloAdsAutomatedRuleActionDto;
+    conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
+    schedule: ZaloAdsAutomatedRuleScheduleDto;
     campaignIds?: number[];
     adIds?: number[];
-    [key: string]: unknown;
 };
 type ZaloAdsUpdateAutomatedRuleResponse = {
     code: number;
     msg?: string;
-    data?: unknown;
-    [key: string]: unknown;
+    data?: number | boolean;
 };
 /** Thay đổi trạng thái bật hoặc tắt (active/inactive) của một quy tắc tự động (Automated Rule) trên Zalo Ads theo ID quy tắc (`POST /api/automatedrules/change-status`). Dùng khi đã có `automatedRuleId` và cần tạm dừng (`status = 0`) hoặc kích hoạt lại (`status = 1`) quy tắc tự động. */
 type ZaloAdsChangeAutomatedRuleStatusRequest = {
@@ -2477,7 +2931,7 @@ type ZaloAdsChangeAutomatedRuleStatusResponse = {
     code: number;
     /** Thông điệp kết quả thay đổi trạng thái quy tắc tự động (ví dụ: 'Thay đổi trạng thái thành công.'). */
     msg?: string;
-    data?: unknown;
+    data?: number | boolean;
 };
 /** Tra cứu lịch sử thực thi (executeHistory) và lịch sử chỉnh sửa (editHistory) của một quy tắc tự động (Automated Rule) trên Zalo Ads theo ID quy tắc (`GET /api/automatedrules/history/{automatedRuleId}`). */
 type ZaloAdsGetAutomatedRuleHistoryRequest = {
@@ -2499,7 +2953,6 @@ type ZaloAdsGetAutomatedRuleHistoryResponse = {
             content: Array<string>;
             /** Thời điểm thực hiện chỉnh sửa (Unix timestamp tính bằng giây). */
             created: number;
-            [key: string]: unknown;
         }>;
         /** Danh sách lịch sử các lần hệ thống tự động kích hoạt và thực thi quy tắc. */
         executeHistory: Array<{
@@ -2507,11 +2960,8 @@ type ZaloAdsGetAutomatedRuleHistoryResponse = {
             content?: Array<string>;
             /** Thời điểm hệ thống thực thi quy tắc (Unix timestamp tính bằng giây). */
             created?: number;
-            [key: string]: unknown;
         }>;
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 };
 /** Xóa quy tắc tự động trên Zalo Ads. */
 type ZaloAdsDeleteAutomatedRuleRequest = {
@@ -2520,7 +2970,7 @@ type ZaloAdsDeleteAutomatedRuleRequest = {
 type ZaloAdsDeleteAutomatedRuleResponse = {
     code: number;
     msg?: string;
-    data?: unknown;
+    data?: number | boolean;
 };
 /** Tải tệp danh sách số điện thoại để tạo hoặc bổ sung nguồn audience tùy chỉnh trong Zalo Ads. Đây là mutation tool thuộc lane zalo-ads-audience; chỉ dùng khi đã có quyền xử lý dữ liệu cá nhân, tệp hợp lệ và xác nhận phạm vi upload. Không đưa số điện thoại hoặc URL tệp có dữ liệu cá nhân vào mô tả, example hay log. */
 type ZaloAdsUploadCustomAudiencePhoneListRequest = {
@@ -2545,12 +2995,15 @@ type ZaloAdsUploadCustomAudiencePhoneListResponse = {
 /** Tải video lên kho media của tài khoản quảng cáo. Đây là mutation tool thuộc lane zalo-ads-media; dùng khi cần tạo asset video trước bước cấu hình quảng cáo. */
 type ZaloAdsUploadVideoRequest = {
     /** Tệp video tải lên. Capture đã quan sát field File (chữ hoa) với MIME video/mp4. */
-    File: FileInput;
+    File?: FileInput;
+    /** Alias tương thích chữ thường cho File. */
+    file?: FileInput;
 };
 type ZaloAdsUploadVideoResponse = {
     code: number;
     /** URL video do Zalo Ads trả về. */
     data: string;
+    msg?: string;
 };
 /** Tạo mới hoặc cập nhật cấu hình báo cáo tùy chỉnh với tên, cờ mặc định và danh sách chỉ số. Đây là mutation tool thuộc lane zalo-ads-reporting; dùng khi đã xác định bộ cột báo cáo cần lưu. */
 type ZaloAdsUpsertCustomReportRequest = {
@@ -2586,97 +3039,844 @@ type ZaloAdsCreateOaCampaignResponse = ZaloAdsCreateOfficialAccountCampaignRespo
 /** Thiết lập và lưu cấu hình chi tiết cho mẫu Quảng cáo Zalo Official Account (`Type = 2`, `Action = 6`) trên Zalo Ads. Alias chuẩn theo tool `zalo_ads_update_oa_ad` trong Project Schema Zalo ADS. */
 type ZaloAdsUpdateOaAdRequest = ZaloAdsUpdateOfficialAccountAdRequest;
 type ZaloAdsUpdateOaAdResponse = ZaloAdsUpdateOfficialAccountAdResponse;
+/** Tạo mới 'Nhóm đối tượng đã lưu' (`caType = 1` - `DEFAULT`) trên Zalo Ads (`POST /api/ad/audience`). */
+type ZaloAdsCreateSavedAudienceRequest = {
+    /** Tên nhóm đối tượng đã lưu (từ 2 đến 255 ký tự). */
+    name: string;
+    /** Mã loại nhóm đối tượng (cố định `1` = DEFAULT cho Nhóm đối tượng đã lưu). */
+    caType?: 1;
+    /** Chuỗi JSON (`JSON.stringify`) hoặc Object cấu hình nhắm chọn (`NewAgeRanges`, `Gender`, `Os`, `Location`, `AdvanceTargeting`, `IncludedAudiences`, `ExcludedAudiences`). */
+    targeting: string | Record<string, unknown>;
+};
+type ZaloAdsCreateSavedAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Lấy danh sách tài khoản Zalo Official Account (OA) có dữ liệu chuyển đổi (Lead Signal) của nhà quảng cáo (`GET /api/ad/audience/leadSignal/oas`). */
+type ZaloAdsLeadSignalOaItem = {
+    /** ID số của Official Account. */
+    id: number;
+    /** ID mã hóa chuỗi của Official Account. */
+    noisedId?: string;
+    /** Tên hiển thị của Official Account. */
+    name: string;
+    /** URL ảnh đại diện của Official Account. */
+    avatarUrl?: string;
+};
+type ZaloAdsListLeadSignalOasResponse = {
+    code: number;
+    msg: string;
+    data: Array<ZaloAdsLeadSignalOaItem>;
+};
+interface ZaloAdsConversionNameItemDto {
+    /** Mã định danh duy nhất của sự kiện chuyển đổi (Conversion ID). */
+    id: number;
+    /** Tên sự kiện chuyển đổi (Conversion Name, duy nhất trong phạm vi tài khoản quảng cáo). */
+    name: string;
+}
+/** Lấy danh sách rút gọn gồm ID và tên của toàn bộ các sự kiện chuyển đổi (Conversion) đã tạo trên tài khoản quảng cáo Zalo Ads (`GET /api/conversion/names`). */
+type ZaloAdsListConversionNamesRequest = Record<string, never>;
+type ZaloAdsListConversionNamesResponse = {
+    /** Mã kết quả phản hồi từ Zalo Ads (`0` = Thành công). */
+    code: number;
+    /** Thông điệp kết quả phản hồi (ví dụ: `'success'`). */
+    msg?: string;
+    /** Mảng danh sách rút gọn `{ id, name }` các sự kiện chuyển đổi hiện có. */
+    data: Array<ZaloAdsConversionNameItemDto>;
+};
+/** Cấu hình targeting cho Nhóm đối tượng SĐT (`caType = 3`). */
+interface ZaloAdsPhoneAudienceTargetingDto {
+    /** Tên file .txt đã tải lên (ví dụ: 'example.txt'). */
+    Name: string;
+    /** Đường dẫn URL công khai của file .txt sau khi upload. */
+    Path: string;
+    /** Tổng số lượng SĐT hợp lệ trong tệp. */
+    Total: number;
+    /** Mã định danh tệp SĐT do Zalo cấp. */
+    ZaloId: number;
+    /** Cờ đánh dấu SĐT đã được người dùng tự mã hóa SHA256 (bắt đầu bằng 84) trước khi tải lên. */
+    IsHashedByUser?: boolean;
+    /** Mặc định là 0. */
+    OriginAudience?: number;
+}
+/** Tạo mới Nhóm đối tượng từ danh sách Số điện thoại (`caType = 3` - `PHONE_LIST`). */
+type ZaloAdsCreatePhoneAudienceRequest = {
+    name: string;
+    caType?: 3;
+    targeting: string | ZaloAdsPhoneAudienceTargetingDto;
+};
+type ZaloAdsCreatePhoneAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng tương tự (`caType = 6`). */
+interface ZaloAdsLookalikeAudienceTargetingDto {
+    /** ID của nhóm đối tượng SĐT gốc (`caType = 3`). Bắt buộc nhóm gốc phải có từ 1.000 đến 10.000 SĐT! */
+    OriginAudience: number;
+    /** Quy mô nhóm đối tượng mở rộng: 1.000.000, 1.500.000 hoặc 2.000.000. */
+    Total: 1000000 | 1500000 | 2000000 | number;
+    /** Tên nhóm đối tượng SĐT gốc. */
+    Name: string;
+    /** Đường dẫn file nhóm gốc (chuỗi rỗng hoặc URL). */
+    Path?: string;
+}
+/** Tạo mới Nhóm đối tượng tương tự Lookalike (`caType = 6` - `LOOKALIKE`). */
+type ZaloAdsCreateLookalikeAudienceRequest = {
+    name: string;
+    caType?: 6;
+    targeting: string | ZaloAdsLookalikeAudienceTargetingDto;
+};
+type ZaloAdsCreateLookalikeAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng sự kiện Form (`caType = 12`). */
+interface ZaloAdsFormEventAudienceTargetingDto {
+    /** 1: Đã xem Form nhưng chưa submit, 2: Đã xem Form và submit, 3: Đã xem Form, 4: Mở chat OA từ Form. */
+    EventType: 1 | 2 | 3 | 4 | number;
+    /** ID mã hóa chuỗi (noisedId) của tài khoản OA. */
+    OaId: string;
+    /** Khoảng thời gian lưu vết người dùng (1 đến 90 ngày; gợi ý: 7, 14, 30, 60, 90). */
+    NumDays: number;
+    /** Danh sách ID biểu mẫu Zalo Form. */
+    FormIds: string[];
+}
+/** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Zalo Form (`caType = 12` - `FORM_EVENT_AUDIENCE`). */
+type ZaloAdsCreateFormEventAudienceRequest = {
+    name: string;
+    caType?: 12;
+    targeting: string | ZaloAdsFormEventAudienceTargetingDto;
+};
+type ZaloAdsCreateFormEventAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng sự kiện Tin nhắn OA (`caType = 11`). */
+interface ZaloAdsMessageOaEventAudienceTargetingDto {
+    /** 1: Liên hệ sau khi xem quảng cáo tin nhắn. */
+    EventId: 1 | number;
+    /** ID mã hóa chuỗi (noisedId) của tài khoản OA xác thực. */
+    OaId: string;
+    /** Khoảng thời gian lưu vết người dùng (1 đến 90 ngày). */
+    NumDays: number;
+}
+/** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn OA (`caType = 11` - `MESSAGE_AUDIENCE`). */
+type ZaloAdsCreateMessageOaEventAudienceRequest = {
+    name: string;
+    caType?: 11;
+    targeting: string | ZaloAdsMessageOaEventAudienceTargetingDto;
+};
+type ZaloAdsCreateMessageOaEventAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng sự kiện Tin nhắn cá nhân (`caType = 14`). */
+interface ZaloAdsMessagePersonalEventAudienceTargetingDto {
+    /** 1: Đã liên hệ, 2: Đã xem nội dung nhưng không liên hệ, 3: Dành thời gian xem ảnh và video ở carousel nhưng không liên hệ. */
+    EventType: 1 | 2 | 3 | number;
+    /** Khoảng thời gian lưu vết người dùng (1 đến 90 ngày). */
+    NumDays: number;
+    /** Danh sách publicId của các Mini Page template Tin nhắn. */
+    PageIds: string[];
+}
+/** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn cá nhân (`caType = 14` - `MESSAGE_PERSONAL_EVENT_AUDIENCE`). */
+type ZaloAdsCreateMessagePersonalEventAudienceRequest = {
+    name: string;
+    caType?: 14;
+    targeting: string | ZaloAdsMessagePersonalEventAudienceTargetingDto;
+};
+type ZaloAdsCreateMessagePersonalEventAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng Trung tâm Lead - Zalo Form (`caType = 10`). */
+interface ZaloAdsFormLeadAudienceTargetingDto {
+    Name: string;
+    FormAudienceId: string | number;
+    Total: number;
+    IsCommerce?: false;
+}
+/** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Zalo Form (`caType = 10` - `FORM_AUDIENCE`). */
+type ZaloAdsCreateFormLeadAudienceRequest = {
+    name: string;
+    caType?: 10;
+    targeting: string | ZaloAdsFormLeadAudienceTargetingDto;
+};
+type ZaloAdsCreateFormLeadAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng Trung tâm Lead - Commerce Form (`caType = 15`). */
+interface ZaloAdsCommerceFormAudienceTargetingDto {
+    Name: string;
+    FormAudienceId: string | number;
+    Total: number;
+    IsCommerce: true;
+}
+/** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Commerce Form (`caType = 15` - `COMMERCE_FORM_AUDIENCE`). */
+type ZaloAdsCreateCommerceFormAudienceRequest = {
+    name: string;
+    caType?: 15;
+    targeting: string | ZaloAdsCommerceFormAudienceTargetingDto;
+};
+type ZaloAdsCreateCommerceFormAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng Trung tâm Lead - Kịch bản Tin nhắn OA (`caType = 13`). */
+interface ZaloAdsMessageOaLeadAudienceTargetingDto {
+    Name: string;
+    MessageOAAudienceId: string | number;
+    Total: number;
+}
+/** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Kịch bản Tin nhắn OA (`caType = 13` - `MESSAGE_OA_AUDIENCE`). */
+type ZaloAdsCreateMessageOaLeadAudienceRequest = {
+    name: string;
+    caType?: 13;
+    targeting: string | ZaloAdsMessageOaLeadAudienceTargetingDto;
+};
+type ZaloAdsCreateMessageOaLeadAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Cấu hình targeting cho Nhóm đối tượng Dữ liệu chuyển đổi Lead Signal (`caType = 16`). */
+interface ZaloAdsLeadSignalAudienceTargetingDto {
+    /** ID số của Official Account có dữ liệu chuyển đổi. */
+    OaId: number;
+    /** Tên nhãn sự kiện chuyển đổi. */
+    Label: string;
+    /** Mức điều chỉnh độ rộng đối tượng từ 1 đến 20 (mặc định: 5). */
+    SegmentCount: number;
+    /** Ước tính số người tiếp cận (Math.round(A30 / 20 * SegmentCount)). */
+    Total: number;
+}
+/** Tạo mới Nhóm đối tượng từ Dữ liệu chuyển đổi Lead Signal (`caType = 16` - `LEAD_SIGNAL_AUDIENCE`). */
+type ZaloAdsCreateLeadSignalAudienceRequest = {
+    name: string;
+    caType?: 16;
+    targeting: string | ZaloAdsLeadSignalAudienceTargetingDto;
+};
+type ZaloAdsCreateLeadSignalAudienceResponse = ZaloAdsCreateCustomAudienceResponse;
+/** Lấy số liệu báo cáo tổng quan Dashboard (GET https://ads.zalo.me/reportapi/report/overview). */
+type ZaloAdsGetReportOverviewRequest = {
+    /** Chuỗi JSON mã hóa URL, ví dụ: '{"StartDate":1768755600,"EndDate":1768928399}' */
+    data: string;
+};
+type ZaloAdsGetReportOverviewResponse = {
+    code: number;
+    data: Record<string, Record<string, number>>;
+    extend?: {
+        totalUniqueUser?: number;
+    };
+};
+/** Lấy báo cáo nhân khẩu học của chiến dịch hoặc quảng cáo (GET https://ads.zalo.me/api/demographics/report). */
+type ZaloAdsGetDemographicsReportRequest = {
+    campaignId: number;
+    adId: number;
+    startDate: number;
+    endDate: number;
+    agencyId?: number;
+    from?: number;
+    to?: number;
+};
+type ZaloAdsGetDemographicsReportResponse = {
+    cAgeGender?: Record<string, number>;
+    iAgeGender?: Record<string, number>;
+    location?: Record<string, unknown>;
+};
+/** Xóa cấu hình báo cáo tùy chỉnh theo ID (POST https://ads.zalo.me/reportapi/custom-report/delete/{id}). */
+type ZaloAdsDeleteCustomReportRequest = {
+    id: number | string;
+};
+type ZaloAdsDeleteCustomReportResponse = {
+    code?: number;
+    msg?: string;
+    data?: unknown;
+};
+/** Lấy danh sách các bộ lọc báo cáo đã lưu (GET https://ads.zalo.me/reportapi/api/filter/list). */
+type ZaloAdsListReportFiltersRequest = {
+    /** 0: all/chung, 1: campaign, 2: ad */
+    model: number | string;
+};
+type ZaloAdsListReportFiltersResponse = Array<{
+    id: number;
+    name: string;
+    content: string;
+    model: number;
+}>;
+
+/**
+ * Tham số đầu vào cho method tiện ích `uploadAndSaveImage`
+ * (Tự động thực hiện 2 bước: upload lên CDN rồi lưu vào Thư viện Media Zalo Ads).
+ */
+interface ZaloUploadAndSaveImageRequest {
+    /**
+     * Tệp ảnh cần tải lên:
+     * - Buffer / Uint8Array / ArrayBuffer (ví dụ: `req.file.buffer` từ Multer trong NestJS/Express)
+     * - Web Blob / File
+     * - URL công khai trên Internet (http/https hoặc data URI)
+     *
+     * (Lưu ý: Không hỗ trợ đường dẫn tệp cục bộ trên ổ cứng).
+     */
+    file: FileInput;
+    /**
+     * Tên hiển thị của ảnh khi lưu vào Thư viện Media.
+     * Nếu bỏ trống, SDK sẽ tự động trích xuất từ tên file hoặc tự sinh tên dựa trên timestamp.
+     */
+    fileName?: string;
+    /**
+     * Chiều rộng ảnh (pixels).
+     * Tùy chọn; nếu không truyền và là file local/buffer, SDK sẽ tự động đọc header ảnh JPEG/PNG.
+     */
+    width?: number;
+    /**
+     * Chiều cao ảnh (pixels).
+     * Tùy chọn; nếu không truyền và là file local/buffer, SDK sẽ tự động đọc header ảnh JPEG/PNG.
+     */
+    height?: number;
+    /**
+     * Loại tài nguyên media: 1 = Ảnh (mặc định là 1).
+     */
+    type?: number;
+    /**
+     * URL ảnh thu nhỏ (thumbnail) nếu có.
+     */
+    thumbUrl?: string;
+}
+/**
+ * Kết quả trả về từ method `uploadAndSaveImage`.
+ */
+interface ZaloUploadAndSaveImageResult {
+    /** Mã kết quả xử lý từ Zalo Ads (0 = thành công). */
+    code: number;
+    /** ID của media vừa được tạo trong Thư viện Zalo Ads (dùng để gán vào Creative/Banner). */
+    mediaId: number;
+    /** URL CDN trực tiếp của ảnh trên máy chủ Zalo (https://adtima-media.zascdn.me/...). */
+    cdnUrl: string;
+    /** Tên tệp đã lưu trong thư viện. */
+    name: string;
+    /** Chiều rộng ảnh (pixels). */
+    width: number;
+    /** Chiều cao ảnh (pixels). */
+    height: number;
+    /** Loại media (1 = Ảnh). */
+    type: number;
+    /** Chi tiết phản hồi từ API upload ảnh (/api/member/upload-image). */
+    rawUploadResponse: ZaloAdsPostApiMemberUploadImageResponse;
+    /** Chi tiết phản hồi từ API lưu media (/api/media/save). */
+    rawSaveResponse: ZaloAdsPostApiMediaSaveResponse;
+}
+/**
+ * Tham số đầu vào cho method tiện ích `uploadAndSaveVideo`.
+ */
+interface ZaloUploadAndSaveVideoRequest {
+    /**
+     * Tệp video cần tải lên (Buffer, Uint8Array, Blob, File hoặc URL công khai .mp4).
+     * Lưu ý: Không hỗ trợ đường dẫn tệp cục bộ trên ổ cứng.
+     */
+    file: FileInput;
+    /** Tên hiển thị của video trong Thư viện Media. */
+    fileName?: string;
+    /** Chiều rộng video (pixels). Mặc định 1920 hoặc tự truyền. */
+    width?: number;
+    /** Chiều cao video (pixels). Mặc định 1080 hoặc tự truyền. */
+    height?: number;
+    /** Thời lượng video tính bằng giây (tối đa 60s). */
+    duration?: number;
+    /** URL ảnh thu nhỏ (thumbnail poster) của video. */
+    thumbUrl?: string;
+}
+/**
+ * Kết quả trả về từ method `uploadAndSaveVideo`.
+ */
+interface ZaloUploadAndSaveVideoResult {
+    code: number;
+    mediaId: number;
+    cdnUrl: string;
+    name: string;
+    width: number;
+    height: number;
+    duration?: number;
+    type: number;
+    rawUploadResponse: ZaloAdsUploadVideoResponse;
+    rawSaveResponse: ZaloAdsPostApiMediaSaveResponse;
+}
+/**
+ * Kết quả kiểm tra tính hợp lệ của tài nguyên media (Ảnh hoặc Video).
+ */
+interface MediaValidationResult {
+    /** Trạng thái hợp lệ (true nếu vượt qua toàn bộ quy chuẩn, false nếu có lỗi). */
+    isValid: boolean;
+    /** Mã trạng thái: 'VALID' | 'INVALID'. */
+    status: "VALID" | "INVALID";
+    /** Danh sách các thông báo lỗi nếu vi phạm tiêu chí kỹ thuật. Rỗng khi isValid = true. */
+    errors: string[];
+    /** Tóm tắt metadata đã phân tích được từ tệp. */
+    metadata: {
+        fileDetected: boolean;
+        sizeBytes?: number;
+        width?: number;
+        height?: number;
+        durationSeconds?: number;
+        format?: string;
+        aspectRatio?: string;
+    };
+}
+/**
+ * Dữ liệu đầu vào để kiểm tra tính hợp lệ của Ảnh.
+ * Hỗ trợ nhận trực tiếp tệp (Buffer, Blob, path) hoặc metadata do backend (multer/busboy) trích xuất sẵn.
+ *
+ * Tiêu chuẩn quy định:
+ * - "No file chosen": Bắt buộc phải có tệp.
+ * - Dung lượng: Tối đa 2MB (2,097,152 bytes).
+ * - Kích thước tối thiểu: 150x150 pixels.
+ * - Định dạng: .JPG, .JPEG, .PNG.
+ */
+interface ValidateImageInput {
+    /** Tệp ảnh (Buffer, Blob, Uint8Array, đường dẫn file local trong Node.js, hoặc đối tượng có trường size). */
+    file?: FileInput | {
+        size?: number;
+        buffer?: Uint8Array;
+        mimetype?: string;
+        originalname?: string;
+    } | null;
+    /** Dung lượng file tính bằng bytes (nếu truyền từ backend multipart/multer). */
+    sizeBytes?: number;
+    /** Chiều rộng ảnh tính bằng pixels (nếu đã phân tích sẵn). */
+    width?: number;
+    /** Chiều cao ảnh tính bằng pixels (nếu đã phân tích sẵn). */
+    height?: number;
+    /** Định dạng tệp / MIME type (ví dụ: 'image/jpeg', 'image/png', '.jpg', '.png'). */
+    format?: string;
+    /** Tên tệp gốc (ví dụ: 'banner.png'). */
+    fileName?: string;
+}
+/**
+ * Dữ liệu đầu vào để kiểm tra tính hợp lệ của Video.
+ * Hỗ trợ nhận trực tiếp tệp hoặc metadata do backend trích xuất sẵn.
+ *
+ * Tiêu chuẩn quy định:
+ * - "No file chosen": Bắt buộc phải có tệp.
+ * - Định dạng: .MP4 H.264.
+ * - Dung lượng: Tối đa 150MB (157,286,400 bytes).
+ * - Thời lượng: Tối đa 60 giây.
+ * - Tỉ lệ khung hình: 16:9, 9:16 hoặc 1:1.
+ */
+interface ValidateVideoInput {
+    /** Tệp video (Buffer, Blob, Uint8Array, đường dẫn file local, hoặc multer file object). */
+    file?: FileInput | {
+        size?: number;
+        buffer?: Uint8Array;
+        mimetype?: string;
+        originalname?: string;
+    } | null;
+    /** Dung lượng video tính bằng bytes. */
+    sizeBytes?: number;
+    /** Thời lượng video tính bằng giây (tối đa 60 giây). */
+    durationSeconds?: number;
+    /** Chiều rộng video tính bằng pixels (dùng để tính tỉ lệ khung hình). */
+    width?: number;
+    /** Chiều cao video tính bằng pixels (dùng để tính tỉ lệ khung hình). */
+    height?: number;
+    /** Định dạng tệp hoặc codec (ví dụ: '.mp4', 'video/mp4', 'h264'). */
+    format?: string;
+    /** Tên tệp video gốc (ví dụ: 'promo.mp4'). */
+    fileName?: string;
+}
+
+/**
+ * Dịch vụ Quản lý Chiến dịch & Quảng cáo Zalo Ads (Tạo chiến dịch, đổi trạng thái, cập nhật quảng cáo các định dạng).
+ */
+
+declare class ZaloCampaignsService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    updateVideoAd(request: ZaloAdsUpdateVideoAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateVideoAdResponse>;
+    changeCampaignStatus(request: ZaloAdsChangeCampaignStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeCampaignStatusResponse>;
+    deleteCampaign(request: ZaloAdsDeleteCampaignRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCampaignResponse>;
+    createWebsiteCampaign(request: ZaloAdsCreateWebsiteCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateWebsiteCampaignResponse>;
+    updateWebsiteAd(request: ZaloAdsUpdateWebsiteAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateWebsiteAdResponse>;
+    createDisplayCampaign(request: ZaloAdsCreateDisplayCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateDisplayCampaignResponse>;
+    updateDisplayAd(request: ZaloAdsUpdateDisplayAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateDisplayAdResponse>;
+    createVideoCampaign(request: ZaloAdsCreateVideoCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateVideoCampaignResponse>;
+    createEcommerceCampaign(request: ZaloAdsCreateEcommerceCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateEcommerceCampaignResponse>;
+    /** Alias theo tên tool chuẩn `zalo_ads_create_commerce_campaign` trong Project Schema Zalo ADS (`campaignType = 22`). */
+    createCommerceCampaign(request: ZaloAdsCreateCommerceCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateCommerceCampaignResponse>;
+    createForm(request: ZaloAdsCreateFormRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormResponse>;
+    createFormCampaign(request: ZaloAdsCreateFormCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormCampaignResponse>;
+    createMessageCampaign(request: ZaloAdsCreateMessageCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageCampaignResponse>;
+    createOfficialAccountCampaign(request: ZaloAdsCreateOfficialAccountCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateOfficialAccountCampaignResponse>;
+    /** Alias theo tên tool chuẩn `zalo_ads_create_oa_campaign` trong Project Schema Zalo ADS (`campaignType = 3`). */
+    createOaCampaign(request: ZaloAdsCreateOaCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateOaCampaignResponse>;
+    createPostCampaign(request: ZaloAdsCreatePostCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreatePostCampaignResponse>;
+    /** Alias theo tên tool chuẩn `zalo_ads_create_article_campaign` trong Project Schema Zalo ADS (`campaignType = 4`). */
+    createArticleCampaign(request: ZaloAdsCreateArticleCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateArticleCampaignResponse>;
+    getAdById(request?: ZaloAdsGetAdByIdRequest, options?: RequestOptions): Promise<ZaloAdsGetAdByIdResponse>;
+    getAdChangeLog(request: ZaloAdsGetAdChangeLogRequest, options?: RequestOptions): Promise<ZaloAdsGetAdChangeLogResponse>;
+    getApiPlaceGetalldistricts(request?: ZaloAdsGetApiPlaceGetalldistrictsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPlaceGetalldistrictsResponse>;
+    getApiSpellCheckV2(request: ZaloAdsGetApiSpellCheckV2Request, options?: RequestOptions): Promise<ZaloAdsGetApiSpellCheckV2Response>;
+    getZaapiCheckcamphasmanyads(request?: ZaloAdsGetZaapiCheckcamphasmanyadsRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCheckcamphasmanyadsResponse>;
+    getZaapiGetadsfromcampaignid(request?: ZaloAdsGetZaapiGetadsfromcampaignidRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetadsfromcampaignidResponse>;
+    getZaapiGetallpages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
+    getAllPages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
+    getZaapiGetownedarticles(request: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
+    getOwnedArticles(request: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
+    getZaapiGetownedpages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
+    getOwnedPages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
+    listFormsByOfficialAccount(request: ZaloAdsListFormsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFormsByOfficialAccountResponse>;
+    listMiniPagesByTemplate(request: ZaloAdsListMiniPagesByTemplateRequest, options?: RequestOptions): Promise<ZaloAdsListMiniPagesByTemplateResponse>;
+    postZaapiDeletead(request?: ZaloAdsPostZaapiDeleteadRequest, options?: RequestOptions): Promise<ZaloAdsPostZaapiDeleteadResponse>;
+    renameCampaign(request: ZaloAdsRenameCampaignRequest, options?: RequestOptions): Promise<ZaloAdsRenameCampaignResponse>;
+    updateEcommerceAd(request: ZaloAdsUpdateEcommerceAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateEcommerceAdResponse>;
+    /** Alias theo tên tool chuẩn `zalo_ads_update_commerce_ad` trong Project Schema Zalo ADS (`Type = 23`, gắn `MiniPageId`). */
+    updateCommerceAd(request: ZaloAdsUpdateCommerceAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateCommerceAdResponse>;
+    updateFormAd(request: ZaloAdsUpdateFormAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFormAdResponse>;
+    updateMessageAd(request: ZaloAdsUpdateMessageAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateMessageAdResponse>;
+    updateNewAds(request: ZaloAdsUpdateNewAdsRequest, options?: RequestOptions): Promise<ZaloAdsUpdateNewAdsResponse>;
+    updateOfficialAccountAd(request: ZaloAdsUpdateOfficialAccountAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateOfficialAccountAdResponse>;
+    /** Alias theo tên tool chuẩn `zalo_ads_update_oa_ad` trong Project Schema Zalo ADS (`Type = 2`, `Action = 6`). */
+    updateOaAd(request: ZaloAdsUpdateOaAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateOaAdResponse>;
+    updatePostAd(request: ZaloAdsUpdatePostAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdatePostAdResponse>;
+    /** Alias theo tên tool chuẩn `zalo_ads_update_article_ad` trong Project Schema Zalo ADS (`Type = 3`, gắn `ZaloFeedId`). */
+    updateArticleAd(request: ZaloAdsUpdateArticleAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateArticleAdResponse>;
+    /** Xóa quảng cáo */
+    deleteAd(...args: Parameters<this["postZaapiDeletead"]>): ReturnType<this["postZaapiDeletead"]>;
+    /** Danh sách quận/huyện để nhắm mục tiêu */
+    getAllDistricts(...args: Parameters<this["getApiPlaceGetalldistricts"]>): ReturnType<this["getApiPlaceGetalldistricts"]>;
+    /** Kiểm tra chính tả văn bản quảng cáo */
+    getSpellCheckV2(...args: Parameters<this["getApiSpellCheckV2"]>): ReturnType<this["getApiSpellCheckV2"]>;
+}
+
+/**
+ * Dịch vụ Quản lý Tài khoản & Thanh toán Zalo Ads (whoami, transactions, BA accessors, agency).
+ */
+
+declare class ZaloAccountService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    getApiWhoami(request?: ZaloAdsGetApiWhoamiRequest, options?: RequestOptions): Promise<ZaloAdsGetApiWhoamiResponse>;
+    getApiPaymentTransactionHistory(request: ZaloAdsGetApiPaymentTransactionHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPaymentTransactionHistoryResponse>;
+    getApiBaAccountAllaccessors(request?: ZaloAdsGetApiBaAccountAllaccessorsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllaccessorsResponse>;
+    getApiBaAccountAllgrantedmembers(request?: ZaloAdsGetApiBaAccountAllgrantedmembersRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllgrantedmembersResponse>;
+    listAgencyCustomersWithBudget(request?: ZaloAdsListAgencyCustomersWithBudgetRequest, options?: RequestOptions): Promise<ZaloAdsListAgencyCustomersWithBudgetResponse>;
+    getApiNotifiesHeader(request?: ZaloAdsGetApiNotifiesHeaderRequest, options?: RequestOptions): Promise<ZaloAdsGetApiNotifiesHeaderResponse>;
+    getApiLpNews(request?: ZaloAdsGetApiLpNewsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiLpNewsResponse>;
+    /** Lấy thông tin tài khoản đang đăng nhập */
+    getWhoami(...args: Parameters<this["getApiWhoami"]>): ReturnType<this["getApiWhoami"]>;
+    /** Lịch sử giao dịch thanh toán */
+    getPaymentTransactionHistory(...args: Parameters<this["getApiPaymentTransactionHistory"]>): ReturnType<this["getApiPaymentTransactionHistory"]>;
+    /** Danh sách accessor tài khoản BA */
+    getBaAccountAllAccessors(...args: Parameters<this["getApiBaAccountAllaccessors"]>): ReturnType<this["getApiBaAccountAllaccessors"]>;
+    /** Danh sách thành viên được cấp quyền BA */
+    getBaAccountAllGrantedMembers(...args: Parameters<this["getApiBaAccountAllgrantedmembers"]>): ReturnType<this["getApiBaAccountAllgrantedmembers"]>;
+    /** Thông báo trên thanh tiêu đề */
+    getNotifiesHeader(...args: Parameters<this["getApiNotifiesHeader"]>): ReturnType<this["getApiNotifiesHeader"]>;
+    /** Tin tức landing page / bảng tin */
+    getLpNews(...args: Parameters<this["getApiLpNews"]>): ReturnType<this["getApiLpNews"]>;
+}
+
+/**
+ * Dịch vụ Quản lý Đối tượng Tùy chỉnh & Ước tính Tiếp cận (Custom Audiences, Phone List, Lookalike, Event Audiences).
+ */
+
+declare class ZaloAudiencesService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    postApiAdEstimateaudience(request: ZaloAdsPostApiAdEstimateaudienceRequest, options?: RequestOptions): Promise<ZaloAdsPostApiAdEstimateaudienceResponse>;
+    getApiAdGetlistadadvancetargeting(request?: ZaloAdsGetApiAdGetlistadadvancetargetingRequest, options?: RequestOptions): Promise<ZaloAdsGetApiAdGetlistadadvancetargetingResponse>;
+    getApiCustomAudienceAll(request?: ZaloAdsGetApiCustomAudienceAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiCustomAudienceAllResponse>;
+    createCustomAudience(request: ZaloAdsCreateCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateCustomAudienceResponse>;
+    deleteCustomAudience(request: ZaloAdsDeleteCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCustomAudienceResponse>;
+    uploadCustomAudiencePhoneList(request: ZaloAdsUploadCustomAudiencePhoneListRequest, options?: RequestOptions): Promise<ZaloAdsUploadCustomAudiencePhoneListResponse>;
+    /** Tạo mới 'Nhóm đối tượng đã lưu' (`caType = 1` - `DEFAULT`) trên Zalo Ads (`POST /api/ad/audience`). */
+    createSavedAudience(request: ZaloAdsCreateSavedAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateSavedAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ danh sách Số điện thoại (`caType = 3` - `PHONE_LIST`). */
+    createPhoneAudience(request: ZaloAdsCreatePhoneAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreatePhoneAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng tương tự Lookalike (`caType = 6` - `LOOKALIKE`). */
+    createLookalikeAudience(request: ZaloAdsCreateLookalikeAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateLookalikeAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Zalo Form (`caType = 12` - `FORM_EVENT_AUDIENCE`). */
+    createFormEventAudience(request: ZaloAdsCreateFormEventAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormEventAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn OA (`caType = 11` - `MESSAGE_AUDIENCE`). */
+    createMessageOaEventAudience(request: ZaloAdsCreateMessageOaEventAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageOaEventAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn cá nhân (`caType = 14` - `MESSAGE_PERSONAL_EVENT_AUDIENCE`). */
+    createMessagePersonalEventAudience(request: ZaloAdsCreateMessagePersonalEventAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessagePersonalEventAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Zalo Form (`caType = 10` - `FORM_AUDIENCE`). */
+    createFormLeadAudience(request: ZaloAdsCreateFormLeadAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormLeadAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Commerce Form (`caType = 15` - `COMMERCE_FORM_AUDIENCE`). */
+    createCommerceFormAudience(request: ZaloAdsCreateCommerceFormAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateCommerceFormAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Kịch bản Tin nhắn OA (`caType = 13` - `MESSAGE_OA_AUDIENCE`). */
+    createMessageOaLeadAudience(request: ZaloAdsCreateMessageOaLeadAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageOaLeadAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Dữ liệu chuyển đổi Lead Signal (`caType = 16` - `LEAD_SIGNAL_AUDIENCE`). */
+    createLeadSignalAudience(request: ZaloAdsCreateLeadSignalAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateLeadSignalAudienceResponse>;
+    /** Ước tính quy mô đối tượng tiếp cận */
+    estimateAudience(...args: Parameters<this["postApiAdEstimateaudience"]>): ReturnType<this["postApiAdEstimateaudience"]>;
+    /** Danh sách toàn bộ nhóm đối tượng tùy chỉnh */
+    listCustomAudiences(...args: Parameters<this["getApiCustomAudienceAll"]>): ReturnType<this["getApiCustomAudienceAll"]>;
+    /** Danh sách cấu hình nhắm mục tiêu nâng cao */
+    getListAdAdvanceTargeting(...args: Parameters<this["getApiAdGetlistadadvancetargeting"]>): ReturnType<this["getApiAdGetlistadadvancetargeting"]>;
+}
+
+/**
+ * Dịch vụ Báo cáo & Thống kê Hiệu quả Zalo Ads (Campaigns, Ads, Demographics, Overview, Custom Reports).
+ */
+
+declare class ZaloReportsService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    getReportapiV2Ads(request: ZaloAdsGetReportapiV2AdsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2AdsResponse>;
+    getReportapiV2Campaigns(request?: ZaloAdsGetReportapiV2CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2CampaignsResponse>;
+    getReportapiV2UniqueUser(request: ZaloAdsGetReportapiV2UniqueUserRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2UniqueUserResponse>;
+    getReportapiV3Campaigns(request: ZaloAdsGetReportapiV3CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV3CampaignsResponse>;
+    getReportOverview(request: ZaloAdsGetReportOverviewRequest, options?: RequestOptions): Promise<ZaloAdsGetReportOverviewResponse>;
+    getDemographicsReport(request: ZaloAdsGetDemographicsReportRequest, options?: RequestOptions): Promise<ZaloAdsGetDemographicsReportResponse>;
+    getZaapiCampaignReportcampaign(request: ZaloAdsGetZaapiCampaignReportcampaignRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCampaignReportcampaignResponse>;
+    listCustomReports(request?: ZaloAdsListCustomReportsRequest, options?: RequestOptions): Promise<ZaloAdsListCustomReportsResponse>;
+    upsertCustomReport(request: ZaloAdsUpsertCustomReportRequest, options?: RequestOptions): Promise<ZaloAdsUpsertCustomReportResponse>;
+    deleteCustomReport(request: ZaloAdsDeleteCustomReportRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCustomReportResponse>;
+    listReportFilters(request: ZaloAdsListReportFiltersRequest, options?: RequestOptions): Promise<ZaloAdsListReportFiltersResponse>;
+    /** Báo cáo hiệu quả chiến dịch (API V3 - Khuyên dùng) */
+    getCampaignReportV3(...args: Parameters<this["getReportapiV3Campaigns"]>): ReturnType<this["getReportapiV3Campaigns"]>;
+    /** Báo cáo hiệu quả chiến dịch (API V2) */
+    getCampaignReportV2(...args: Parameters<this["getReportapiV2Campaigns"]>): ReturnType<this["getReportapiV2Campaigns"]>;
+    /** Báo cáo hiệu quả quảng cáo (API V2) */
+    getAdsReportV2(...args: Parameters<this["getReportapiV2Ads"]>): ReturnType<this["getReportapiV2Ads"]>;
+    /** Báo cáo người dùng tiếp cận duy nhất (Unique Reach) */
+    getUniqueUserReport(...args: Parameters<this["getReportapiV2UniqueUser"]>): ReturnType<this["getReportapiV2UniqueUser"]>;
+    /** Báo cáo chiến dịch theo ngày/tháng (Legacy ZAAPI) */
+    getCampaignReportLegacy(...args: Parameters<this["getZaapiCampaignReportcampaign"]>): ReturnType<this["getZaapiCampaignReportcampaign"]>;
+}
+
+/**
+ * Dịch vụ Quản lý Chuyển đổi & Zalo Pixel (Conversions, Standard Events, Lead Signals, Pixel Labels).
+ */
+
+declare class ZaloConversionsService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    createConversion(request: ZaloAdsCreateConversionRequest, options?: RequestOptions): Promise<ZaloAdsCreateConversionResponse>;
+    deleteConversion(request: ZaloAdsDeleteConversionRequest, options?: RequestOptions): Promise<ZaloAdsDeleteConversionResponse>;
+    getApiConversionAll(request?: ZaloAdsGetApiConversionAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionAllResponse>;
+    getApiConversionStandardEvents(request?: ZaloAdsGetApiConversionStandardEventsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionStandardEventsResponse>;
+    listPersonalPixelLabels(request?: ZaloAdsListPersonalPixelLabelsRequest, options?: RequestOptions): Promise<ZaloAdsListPersonalPixelLabelsResponse>;
+    /** Lấy danh sách tài khoản Zalo Official Account (OA) có dữ liệu chuyển đổi (Lead Signal) (`GET /api/ad/audience/leadSignal/oas`). */
+    listLeadSignalOas(options?: RequestOptions): Promise<ZaloAdsListLeadSignalOasResponse>;
+    /** Lấy danh sách rút gọn gồm ID và tên của toàn bộ các sự kiện chuyển đổi (Conversion) đã tạo trên tài khoản quảng cáo Zalo Ads (`GET /api/conversion/names`). */
+    listConversionNames(request?: ZaloAdsListConversionNamesRequest, options?: RequestOptions): Promise<ZaloAdsListConversionNamesResponse>;
+    /** Alias cho `listConversionNames` (`GET /api/conversion/names`). */
+    getApiConversionNames(request?: ZaloAdsListConversionNamesRequest, options?: RequestOptions): Promise<ZaloAdsListConversionNamesResponse>;
+    /** Danh sách toàn bộ sự kiện chuyển đổi */
+    listConversions(...args: Parameters<this["getApiConversionAll"]>): ReturnType<this["getApiConversionAll"]>;
+    /** Danh sách sự kiện chuyển đổi tiêu chuẩn */
+    getConversionStandardEvents(...args: Parameters<this["getApiConversionStandardEvents"]>): ReturnType<this["getApiConversionStandardEvents"]>;
+}
 
-/** Zalo Ads API service. Each API explicitly selects its own request transport. */
+/**
+ * Dịch vụ Quản lý Quy tắc Tự động Zalo Ads (Automated Rules CRUD, Status, History).
+ */
 
-declare class ZaloAdsService {
-    private readonly client;
+declare class ZaloAutomatedRulesService {
+    protected readonly client: ZaloSdkHttpClient;
     constructor(client: ZaloSdkHttpClient);
-    updateVideoAd(request: ZaloAdsUpdateVideoAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateVideoAdResponse>;
-    createFlow(request: ZaloAdsCreateFlowRequest, options?: RequestOptions): Promise<ZaloAdsCreateFlowResponse>;
-    updateFlow(request: ZaloAdsUpdateFlowRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFlowResponse>;
-    listFlowsByOfficialAccount(request: ZaloAdsListFlowsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFlowsByOfficialAccountResponse>;
-    changeCampaignStatus(request: ZaloAdsChangeCampaignStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeCampaignStatusResponse>;
-    deleteCampaign(request: ZaloAdsDeleteCampaignRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCampaignResponse>;
-    createCustomAudience(request: ZaloAdsCreateCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateCustomAudienceResponse>;
-    createWebsiteCampaign(request: ZaloAdsCreateWebsiteCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateWebsiteCampaignResponse>;
-    updateWebsiteAd(request: ZaloAdsUpdateWebsiteAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateWebsiteAdResponse>;
-    createDisplayCampaign(request: ZaloAdsCreateDisplayCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateDisplayCampaignResponse>;
-    updateDisplayAd(request: ZaloAdsUpdateDisplayAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateDisplayAdResponse>;
-    createVideoCampaign(request: ZaloAdsCreateVideoCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateVideoCampaignResponse>;
-    createEcommerceCampaign(request: ZaloAdsCreateEcommerceCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateEcommerceCampaignResponse>;
-    /** Alias theo tên tool chuẩn `zalo_ads_create_commerce_campaign` trong Project Schema Zalo ADS (`campaignType = 22`). */
-    createCommerceCampaign(request: ZaloAdsCreateCommerceCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateCommerceCampaignResponse>;
-    createForm(request: ZaloAdsCreateFormRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormResponse>;
-    createFormCampaign(request: ZaloAdsCreateFormCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormCampaignResponse>;
-    createMessageCampaign(request: ZaloAdsCreateMessageCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageCampaignResponse>;
-    createOfficialAccountCampaign(request: ZaloAdsCreateOfficialAccountCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateOfficialAccountCampaignResponse>;
-    /** Alias theo tên tool chuẩn `zalo_ads_create_oa_campaign` trong Project Schema Zalo ADS (`campaignType = 3`). */
-    createOaCampaign(request: ZaloAdsCreateOaCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateOaCampaignResponse>;
-    createPostCampaign(request: ZaloAdsCreatePostCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreatePostCampaignResponse>;
-    /** Alias theo tên tool chuẩn `zalo_ads_create_article_campaign` trong Project Schema Zalo ADS (`campaignType = 4`). */
-    createArticleCampaign(request: ZaloAdsCreateArticleCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateArticleCampaignResponse>;
     listAutomatedRules(request?: ZaloAdsListAutomatedRulesRequest, options?: RequestOptions): Promise<ZaloAdsListAutomatedRulesResponse>;
     createAutomatedRule(request: ZaloAdsCreateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsCreateAutomatedRuleResponse>;
     updateAutomatedRule(request: ZaloAdsUpdateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsUpdateAutomatedRuleResponse>;
     changeAutomatedRuleStatus(request: ZaloAdsChangeAutomatedRuleStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeAutomatedRuleStatusResponse>;
     getAutomatedRuleHistory(request: ZaloAdsGetAutomatedRuleHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetAutomatedRuleHistoryResponse>;
     deleteAutomatedRule(request: ZaloAdsDeleteAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsDeleteAutomatedRuleResponse>;
-    createConversion(request: ZaloAdsCreateConversionRequest, options?: RequestOptions): Promise<ZaloAdsCreateConversionResponse>;
-    deleteConversion(request: ZaloAdsDeleteConversionRequest, options?: RequestOptions): Promise<ZaloAdsDeleteConversionResponse>;
-    deleteCustomAudience(request: ZaloAdsDeleteCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCustomAudienceResponse>;
-    getAdById(request?: ZaloAdsGetAdByIdRequest, options?: RequestOptions): Promise<ZaloAdsGetAdByIdResponse>;
-    getAdChangeLog(request: ZaloAdsGetAdChangeLogRequest, options?: RequestOptions): Promise<ZaloAdsGetAdChangeLogResponse>;
-    getApiAdGetlistadadvancetargeting(request?: ZaloAdsGetApiAdGetlistadadvancetargetingRequest, options?: RequestOptions): Promise<ZaloAdsGetApiAdGetlistadadvancetargetingResponse>;
-    getApiBaAccountAllaccessors(request?: ZaloAdsGetApiBaAccountAllaccessorsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllaccessorsResponse>;
-    getApiBaAccountAllgrantedmembers(request?: ZaloAdsGetApiBaAccountAllgrantedmembersRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllgrantedmembersResponse>;
-    getApiConversionAll(request?: ZaloAdsGetApiConversionAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionAllResponse>;
-    getApiConversionStandardEvents(request?: ZaloAdsGetApiConversionStandardEventsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionStandardEventsResponse>;
-    getApiCustomAudienceAll(request?: ZaloAdsGetApiCustomAudienceAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiCustomAudienceAllResponse>;
-    getApiFilegroups(request?: ZaloAdsGetApiFilegroupsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiFilegroupsResponse>;
-    getApiLpNews(request?: ZaloAdsGetApiLpNewsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiLpNewsResponse>;
+}
+
+/**
+ * Dịch vụ Quản lý Kịch bản Tin nhắn OA (Message Flows get/create/update).
+ */
+
+declare class ZaloFlowsService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    listFlowsByOfficialAccount(request: ZaloAdsListFlowsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFlowsByOfficialAccountResponse>;
+    createFlow(request: ZaloAdsCreateFlowRequest, options?: RequestOptions): Promise<ZaloAdsCreateFlowResponse>;
+    updateFlow(request: ZaloAdsUpdateFlowRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFlowResponse>;
+}
+
+/**
+ * Zalo Ads Media & Assets Service (`https://ads.zalo.me`).
+ * Quản lý kho hình ảnh, video, upload CDN, lưu thư viện Media, cắt ảnh (crop)
+ * và cung cấp các tiện ích upload+save trọn gói cùng bộ validation độc lập cho backend.
+ */
+
+declare class ZaloMediaService {
+    private readonly client;
+    constructor(client: ZaloSdkHttpClient);
+    /**
+     * Lấy danh sách ảnh, video trong thư viện Zalo Ads theo khoảng thời gian (`GET /api/media/items`).
+     */
     getApiMediaItems(request: ZaloAdsGetApiMediaItemsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMediaItemsResponse>;
+    /**
+     * Alias cho `getApiMediaItems`.
+     */
+    listMediaItems(request: ZaloAdsGetApiMediaItemsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMediaItemsResponse>;
+    /**
+     * Lấy các tệp do thành viên hiện tại quản lý trong tài khoản quảng cáo (`GET /api/member/files`).
+     */
     getApiMemberFiles(request?: ZaloAdsGetApiMemberFilesRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMemberFilesResponse>;
-    getApiNotifiesHeader(request?: ZaloAdsGetApiNotifiesHeaderRequest, options?: RequestOptions): Promise<ZaloAdsGetApiNotifiesHeaderResponse>;
-    getApiPaymentTransactionHistory(request: ZaloAdsGetApiPaymentTransactionHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPaymentTransactionHistoryResponse>;
-    getApiPlaceGetalldistricts(request?: ZaloAdsGetApiPlaceGetalldistrictsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPlaceGetalldistrictsResponse>;
-    getApiSpellCheckV2(request?: ZaloAdsGetApiSpellCheckV2Request, options?: RequestOptions): Promise<ZaloAdsGetApiSpellCheckV2Response>;
+    /**
+     * Alias cho `getApiMemberFiles`.
+     */
+    listMemberFiles(request?: ZaloAdsGetApiMemberFilesRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMemberFilesResponse>;
+    /**
+     * Lấy danh sách nhóm tệp trong kho media (`GET /api/filegroups`).
+     */
+    getApiFilegroups(request?: ZaloAdsGetApiFilegroupsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiFilegroupsResponse>;
+    /**
+     * Alias cho `getApiFilegroups`.
+     */
+    listFilegroups(request?: ZaloAdsGetApiFilegroupsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiFilegroupsResponse>;
+    /**
+     * Lưu tài nguyên media vào thư viện Zalo Ads sau khi đã có URL ảnh/video và metadata (`POST /api/media/save`).
+     * Phản hồi trả về `{ code: 0, data: <MediaId> }`.
+     */
+    postApiMediaSave(request: ZaloAdsPostApiMediaSaveRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMediaSaveResponse>;
+    /**
+     * Alias cho `postApiMediaSave`.
+     */
+    saveMedia(request: ZaloAdsPostApiMediaSaveRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMediaSaveResponse>;
+    /**
+     * Tải ảnh lên kho media của tài khoản quảng cáo (`POST /api/member/upload-image`).
+     * Sử dụng multipart/form-data với trường `File` (chữ hoa). Trả về URL CDN Adtima.
+     */
+    postApiMemberUploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
+    /**
+     * Alias cho `postApiMemberUploadImage`.
+     */
+    uploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
+    /**
+     * Tải video lên kho media của tài khoản quảng cáo (`POST /api/member/upload-video`).
+     * Định dạng chuẩn .MP4 (H.264), tối đa 150MB. Trả về URL video trên Adtima CDN.
+     */
+    uploadVideo(request: ZaloAdsUploadVideoRequest, options?: RequestOptions): Promise<ZaloAdsUploadVideoResponse>;
+    /**
+     * Tải ảnh và thiết lập vùng crop tạo asset dùng cho quảng cáo Zalo Ads (`POST /zaapi/UploadCrop`).
+     */
+    updateNewAds(request: ZaloAdsUpdateNewAdsRequest, options?: RequestOptions): Promise<ZaloAdsUpdateNewAdsResponse>;
+    /**
+     * Alias cho `updateNewAds` (`POST /zaapi/UploadCrop`).
+     */
+    uploadCrop(request: ZaloAdsUpdateNewAdsRequest, options?: RequestOptions): Promise<ZaloAdsUpdateNewAdsResponse>;
+    /**
+     * Method tiện ích trọn gói: Tự động tải ảnh lên CDN (`/api/member/upload-image`)
+     * VÀ lưu vào Thư viện Zalo Ads (`/api/media/save`) trong cùng 1 lời gọi duy nhất.
+     *
+     * Trả về MediaId, URL CDN và kích thước để gắn ngay vào Creative/Quảng cáo.
+     */
+    uploadAndSaveImage(request: ZaloUploadAndSaveImageRequest, options?: RequestOptions): Promise<ZaloUploadAndSaveImageResult>;
+    /**
+     * Method tiện ích trọn gói cho Video: Tự động tải video lên CDN (`/api/member/upload-video`)
+     * VÀ lưu vào Thư viện Zalo Ads (`/api/media/save`) để cấp MediaId.
+     */
+    uploadAndSaveVideo(request: ZaloUploadAndSaveVideoRequest, options?: RequestOptions): Promise<ZaloUploadAndSaveVideoResult>;
+    /**
+     * Kiểm tra tính hợp lệ của tệp Ảnh theo quy chuẩn Zalo Ads:
+     * - "No file chosen": Bắt buộc phải có tệp.
+     * - Dung lượng: Tối đa 2MB (2 * 1024 * 1024 bytes).
+     * - Kích thước: Tối thiểu 150x150 pixels.
+     * - Định dạng: Hỗ trợ .JPG, .JPEG, .PNG.
+     *
+     * Trả về `{ isValid: boolean, status: 'VALID' | 'INVALID', errors: string[], metadata: {...} }`.
+     */
+    validateImage(input: ValidateImageInput): MediaValidationResult;
+    /**
+     * Kiểm tra tính hợp lệ của tệp Video theo quy chuẩn Zalo Ads:
+     * - "No file chosen": Bắt buộc phải có tệp.
+     * - Định dạng: .MP4 H.264.
+     * - Dung lượng: Tối đa 150MB (150 * 1024 * 1024 bytes).
+     * - Thời lượng: Tối đa 60 giây.
+     * - Tỉ lệ khung hình: 16:9, 9:16 hoặc 1:1.
+     *
+     * Trả về `{ isValid: boolean, status: 'VALID' | 'INVALID', errors: string[], metadata: {...} }`.
+     */
+    validateVideo(input: ValidateVideoInput): MediaValidationResult;
+}
+
+/**
+ * Zalo Ads API facade service.
+ * Kế thừa toàn bộ API Chiến dịch & Quảng cáo từ `ZaloCampaignsService`,
+ * đồng thời tích hợp và điều phối các module chuyên biệt:
+ * - `account`: Quản lý tài khoản, phân quyền BA, thanh toán (`ZaloAccountService`)
+ * - `audiences`: Nhóm đối tượng tùy chỉnh, Lookalike, Event/Lead Audiences (`ZaloAudiencesService`)
+ * - `reports`: Báo cáo chiến dịch, quảng cáo, nhân khẩu học, báo cáo tùy chỉnh (`ZaloReportsService`)
+ * - `conversions`: Sự kiện chuyển đổi, Zalo Pixel (`ZaloConversionsService`)
+ * - `automatedRules`: Quy tắc tự động (`ZaloAutomatedRulesService`)
+ * - `flows`: Kịch bản tin nhắn OA (`ZaloFlowsService`)
+ * - `media`: Thư viện tài nguyên & tải lên ảnh/video (`ZaloMediaService`)
+ */
+
+declare class ZaloAdsService extends ZaloCampaignsService {
+    readonly account: ZaloAccountService;
+    readonly audiences: ZaloAudiencesService;
+    readonly targeting: ZaloAudiencesService;
+    readonly reports: ZaloReportsService;
+    readonly conversions: ZaloConversionsService;
+    readonly pixel: ZaloConversionsService;
+    readonly automatedRules: ZaloAutomatedRulesService;
+    readonly rules: ZaloAutomatedRulesService;
+    readonly flows: ZaloFlowsService;
+    readonly media: ZaloMediaService;
+    readonly campaigns: ZaloCampaignsService;
+    constructor(client: ZaloSdkHttpClient);
     getApiWhoami(request?: ZaloAdsGetApiWhoamiRequest, options?: RequestOptions): Promise<ZaloAdsGetApiWhoamiResponse>;
+    getApiPaymentTransactionHistory(request: ZaloAdsGetApiPaymentTransactionHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPaymentTransactionHistoryResponse>;
+    getApiBaAccountAllaccessors(request?: ZaloAdsGetApiBaAccountAllaccessorsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllaccessorsResponse>;
+    getApiBaAccountAllgrantedmembers(request?: ZaloAdsGetApiBaAccountAllgrantedmembersRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllgrantedmembersResponse>;
+    listAgencyCustomersWithBudget(request?: ZaloAdsListAgencyCustomersWithBudgetRequest, options?: RequestOptions): Promise<ZaloAdsListAgencyCustomersWithBudgetResponse>;
+    getApiNotifiesHeader(request?: ZaloAdsGetApiNotifiesHeaderRequest, options?: RequestOptions): Promise<ZaloAdsGetApiNotifiesHeaderResponse>;
+    getApiLpNews(request?: ZaloAdsGetApiLpNewsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiLpNewsResponse>;
+    postApiAdEstimateaudience(request: ZaloAdsPostApiAdEstimateaudienceRequest, options?: RequestOptions): Promise<ZaloAdsPostApiAdEstimateaudienceResponse>;
+    getApiAdGetlistadadvancetargeting(request?: ZaloAdsGetApiAdGetlistadadvancetargetingRequest, options?: RequestOptions): Promise<ZaloAdsGetApiAdGetlistadadvancetargetingResponse>;
+    getApiCustomAudienceAll(request?: ZaloAdsGetApiCustomAudienceAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiCustomAudienceAllResponse>;
+    createCustomAudience(request: ZaloAdsCreateCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateCustomAudienceResponse>;
+    deleteCustomAudience(request: ZaloAdsDeleteCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCustomAudienceResponse>;
+    uploadCustomAudiencePhoneList(request: ZaloAdsUploadCustomAudiencePhoneListRequest, options?: RequestOptions): Promise<ZaloAdsUploadCustomAudiencePhoneListResponse>;
+    /** Tạo mới 'Nhóm đối tượng đã lưu' (`caType = 1` - `DEFAULT`) trên Zalo Ads (`POST /api/ad/audience`). */
+    createSavedAudience(request: ZaloAdsCreateSavedAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateSavedAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ danh sách Số điện thoại (`caType = 3` - `PHONE_LIST`). */
+    createPhoneAudience(request: ZaloAdsCreatePhoneAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreatePhoneAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng tương tự Lookalike (`caType = 6` - `LOOKALIKE`). */
+    createLookalikeAudience(request: ZaloAdsCreateLookalikeAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateLookalikeAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Zalo Form (`caType = 12` - `FORM_EVENT_AUDIENCE`). */
+    createFormEventAudience(request: ZaloAdsCreateFormEventAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormEventAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn OA (`caType = 11` - `MESSAGE_AUDIENCE`). */
+    createMessageOaEventAudience(request: ZaloAdsCreateMessageOaEventAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageOaEventAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn cá nhân (`caType = 14` - `MESSAGE_PERSONAL_EVENT_AUDIENCE`). */
+    createMessagePersonalEventAudience(request: ZaloAdsCreateMessagePersonalEventAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessagePersonalEventAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Zalo Form (`caType = 10` - `FORM_AUDIENCE`). */
+    createFormLeadAudience(request: ZaloAdsCreateFormLeadAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormLeadAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Commerce Form (`caType = 15` - `COMMERCE_FORM_AUDIENCE`). */
+    createCommerceFormAudience(request: ZaloAdsCreateCommerceFormAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateCommerceFormAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Kịch bản Tin nhắn OA (`caType = 13` - `MESSAGE_OA_AUDIENCE`). */
+    createMessageOaLeadAudience(request: ZaloAdsCreateMessageOaLeadAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageOaLeadAudienceResponse>;
+    /** Tạo mới Nhóm đối tượng từ Dữ liệu chuyển đổi Lead Signal (`caType = 16` - `LEAD_SIGNAL_AUDIENCE`). */
+    createLeadSignalAudience(request: ZaloAdsCreateLeadSignalAudienceRequest, options?: RequestOptions): Promise<ZaloAdsCreateLeadSignalAudienceResponse>;
     getReportapiV2Ads(request: ZaloAdsGetReportapiV2AdsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2AdsResponse>;
     getReportapiV2Campaigns(request?: ZaloAdsGetReportapiV2CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2CampaignsResponse>;
-    getReportapiV2UniqueUser(request?: ZaloAdsGetReportapiV2UniqueUserRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2UniqueUserResponse>;
+    getReportapiV2UniqueUser(request: ZaloAdsGetReportapiV2UniqueUserRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2UniqueUserResponse>;
     getReportapiV3Campaigns(request: ZaloAdsGetReportapiV3CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV3CampaignsResponse>;
-    getZaapiCampaignReportcampaign(request?: ZaloAdsGetZaapiCampaignReportcampaignRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCampaignReportcampaignResponse>;
-    getZaapiCheckcamphasmanyads(request?: ZaloAdsGetZaapiCheckcamphasmanyadsRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCheckcamphasmanyadsResponse>;
-    getZaapiGetadsfromcampaignid(request?: ZaloAdsGetZaapiGetadsfromcampaignidRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetadsfromcampaignidResponse>;
-    getZaapiGetallpages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
-    getZaapiGetownedarticles(request?: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
-    getZaapiGetownedpages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
-    listAgencyCustomersWithBudget(request: ZaloAdsListAgencyCustomersWithBudgetRequest, options?: RequestOptions): Promise<ZaloAdsListAgencyCustomersWithBudgetResponse>;
+    getReportOverview(request: ZaloAdsGetReportOverviewRequest, options?: RequestOptions): Promise<ZaloAdsGetReportOverviewResponse>;
+    getDemographicsReport(request: ZaloAdsGetDemographicsReportRequest, options?: RequestOptions): Promise<ZaloAdsGetDemographicsReportResponse>;
+    getZaapiCampaignReportcampaign(request: ZaloAdsGetZaapiCampaignReportcampaignRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCampaignReportcampaignResponse>;
     listCustomReports(request?: ZaloAdsListCustomReportsRequest, options?: RequestOptions): Promise<ZaloAdsListCustomReportsResponse>;
-    listFormsByOfficialAccount(request: ZaloAdsListFormsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFormsByOfficialAccountResponse>;
-    listMiniPagesByTemplate(request: ZaloAdsListMiniPagesByTemplateRequest, options?: RequestOptions): Promise<ZaloAdsListMiniPagesByTemplateResponse>;
+    upsertCustomReport(request: ZaloAdsUpsertCustomReportRequest, options?: RequestOptions): Promise<ZaloAdsUpsertCustomReportResponse>;
+    deleteCustomReport(request: ZaloAdsDeleteCustomReportRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCustomReportResponse>;
+    listReportFilters(request: ZaloAdsListReportFiltersRequest, options?: RequestOptions): Promise<ZaloAdsListReportFiltersResponse>;
+    createConversion(request: ZaloAdsCreateConversionRequest, options?: RequestOptions): Promise<ZaloAdsCreateConversionResponse>;
+    deleteConversion(request: ZaloAdsDeleteConversionRequest, options?: RequestOptions): Promise<ZaloAdsDeleteConversionResponse>;
+    getApiConversionAll(request?: ZaloAdsGetApiConversionAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionAllResponse>;
+    getApiConversionStandardEvents(request?: ZaloAdsGetApiConversionStandardEventsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionStandardEventsResponse>;
     listPersonalPixelLabels(request?: ZaloAdsListPersonalPixelLabelsRequest, options?: RequestOptions): Promise<ZaloAdsListPersonalPixelLabelsResponse>;
-    postApiAdEstimateaudience(request: ZaloAdsPostApiAdEstimateaudienceRequest, options?: RequestOptions): Promise<ZaloAdsPostApiAdEstimateaudienceResponse>;
+    /** Lấy danh sách tài khoản Zalo Official Account (OA) có dữ liệu chuyển đổi (Lead Signal) (`GET /api/ad/audience/leadSignal/oas`). */
+    listLeadSignalOas(options?: RequestOptions): Promise<ZaloAdsListLeadSignalOasResponse>;
+    /** Lấy danh sách rút gọn gồm ID và tên của toàn bộ các sự kiện chuyển đổi (Conversion) đã tạo trên tài khoản quảng cáo Zalo Ads (`GET /api/conversion/names`). */
+    listConversionNames(request?: ZaloAdsListConversionNamesRequest, options?: RequestOptions): Promise<ZaloAdsListConversionNamesResponse>;
+    /** Alias cho `listConversionNames` (`GET /api/conversion/names`). */
+    getApiConversionNames(request?: ZaloAdsListConversionNamesRequest, options?: RequestOptions): Promise<ZaloAdsListConversionNamesResponse>;
+    listAutomatedRules(request?: ZaloAdsListAutomatedRulesRequest, options?: RequestOptions): Promise<ZaloAdsListAutomatedRulesResponse>;
+    createAutomatedRule(request: ZaloAdsCreateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsCreateAutomatedRuleResponse>;
+    updateAutomatedRule(request: ZaloAdsUpdateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsUpdateAutomatedRuleResponse>;
+    changeAutomatedRuleStatus(request: ZaloAdsChangeAutomatedRuleStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeAutomatedRuleStatusResponse>;
+    getAutomatedRuleHistory(request: ZaloAdsGetAutomatedRuleHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetAutomatedRuleHistoryResponse>;
+    deleteAutomatedRule(request: ZaloAdsDeleteAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsDeleteAutomatedRuleResponse>;
+    listFlowsByOfficialAccount(request: ZaloAdsListFlowsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFlowsByOfficialAccountResponse>;
+    createFlow(request: ZaloAdsCreateFlowRequest, options?: RequestOptions): Promise<ZaloAdsCreateFlowResponse>;
+    updateFlow(request: ZaloAdsUpdateFlowRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFlowResponse>;
+    getApiFilegroups(request?: ZaloAdsGetApiFilegroupsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiFilegroupsResponse>;
+    getApiMediaItems(request: ZaloAdsGetApiMediaItemsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMediaItemsResponse>;
+    getApiMemberFiles(request?: ZaloAdsGetApiMemberFilesRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMemberFilesResponse>;
     postApiMediaSave(request: ZaloAdsPostApiMediaSaveRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMediaSaveResponse>;
     postApiMemberUploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
-    postZaapiDeletead(request?: ZaloAdsPostZaapiDeleteadRequest, options?: RequestOptions): Promise<ZaloAdsPostZaapiDeleteadResponse>;
-    renameCampaign(request: ZaloAdsRenameCampaignRequest, options?: RequestOptions): Promise<ZaloAdsRenameCampaignResponse>;
-    updateEcommerceAd(request: ZaloAdsUpdateEcommerceAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateEcommerceAdResponse>;
-    /** Alias theo tên tool chuẩn `zalo_ads_update_commerce_ad` trong Project Schema Zalo ADS (`Type = 23`, gắn `MiniPageId`). */
-    updateCommerceAd(request: ZaloAdsUpdateCommerceAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateCommerceAdResponse>;
-    updateFormAd(request: ZaloAdsUpdateFormAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFormAdResponse>;
-    updateMessageAd(request: ZaloAdsUpdateMessageAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateMessageAdResponse>;
-    updateNewAds(request: ZaloAdsUpdateNewAdsRequest, options?: RequestOptions): Promise<ZaloAdsUpdateNewAdsResponse>;
-    updateOfficialAccountAd(request: ZaloAdsUpdateOfficialAccountAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateOfficialAccountAdResponse>;
-    /** Alias theo tên tool chuẩn `zalo_ads_update_oa_ad` trong Project Schema Zalo ADS (`Type = 2`, `Action = 6`). */
-    updateOaAd(request: ZaloAdsUpdateOaAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateOaAdResponse>;
-    updatePostAd(request: ZaloAdsUpdatePostAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdatePostAdResponse>;
-    /** Alias theo tên tool chuẩn `zalo_ads_update_article_ad` trong Project Schema Zalo ADS (`Type = 3`, gắn `ZaloFeedId`). */
-    updateArticleAd(request: ZaloAdsUpdateArticleAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateArticleAdResponse>;
-    uploadCustomAudiencePhoneList(request: ZaloAdsUploadCustomAudiencePhoneListRequest, options?: RequestOptions): Promise<ZaloAdsUploadCustomAudiencePhoneListResponse>;
+    /** Alias tiện lợi cho `postApiMemberUploadImage` (`POST /api/member/upload-image`). */
+    uploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
     uploadVideo(request: ZaloAdsUploadVideoRequest, options?: RequestOptions): Promise<ZaloAdsUploadVideoResponse>;
-    upsertCustomReport(request: ZaloAdsUpsertCustomReportRequest, options?: RequestOptions): Promise<ZaloAdsUpsertCustomReportResponse>;
+    /**
+     * Kiểm tra tính hợp lệ của tệp Ảnh theo quy chuẩn Zalo Ads (độc lập cho backend).
+     * Tiêu chí: Có file, Dung lượng tối đa 2MB, Kích thước tối thiểu 150x150, Định dạng JPG/PNG.
+     */
+    validateImage(input: ValidateImageInput): MediaValidationResult;
+    /**
+     * Kiểm tra tính hợp lệ của tệp Video theo quy chuẩn Zalo Ads (độc lập cho backend).
+     * Tiêu chí: Có file, Định dạng .MP4 H.264, Dung lượng tối đa 150MB, Thời lượng tối đa 60s, Tỉ lệ 16:9, 9:16 hoặc 1:1.
+     */
+    validateVideo(input: ValidateVideoInput): MediaValidationResult;
 }
 
 /** Lấy cấu hình kết nối chat widget của Zalo Official Account, gồm loại đăng nhập và các endpoint dịch vụ. Đây là auth-sensitive detail tool thuộc lane zalo-ads-chat; dùng khi đã có OA ID và cần cấu hình kết nối chat hợp lệ. Dữ liệu khóa đăng nhập dạng opaque trong phản hồi không được hiển thị hoặc lưu trữ ngoài luồng bảo mật. */
@@ -2780,15 +3980,23 @@ type ZaloFormsExportFormLeadReportResponse = {
     /** Tên tệp .xlsx lấy từ Content-Disposition, nếu executor cung cấp. */
     fileName?: string;
     contentType?: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-    [key: string]: unknown;
 };
-/** Lấy dữ liệu audience targeting có thể dùng để loại trừ cho một Official Account. Đây là helper tool thuộc lane zalo-ads-form; dùng trước khi cấu hình loại trừ đối tượng nếu giao diện form cần danh sách lựa chọn nguồn. Cấu trúc response chi tiết chưa có mẫu nên cần kiểm tra kết quả thực tế trước khi nối trường xuống bước sau. */
+/** Lấy dữ liệu audience targeting có thể dùng để loại trừ cho một Official Account. Đây là helper tool thuộc lane zalo-ads-form; dùng trước khi cấu hình loại trừ đối tượng nếu giao diện form cần danh sách lựa chọn nguồn. */
 type ZaloFormsListAudienceExclusionTargetingRequest = {
     /** ID Official Account cần lấy lựa chọn audience loại trừ. */
     oaId: string;
 };
+type ZaloFormsAudienceExclusionTargetingItem = {
+    id: string;
+    name: string;
+    oaId: string;
+    totalLeads?: number;
+    createdTime?: number;
+};
 type ZaloFormsListAudienceExclusionTargetingResponse = {
-    [key: string]: unknown;
+    msg: string;
+    code: number;
+    data: Array<ZaloFormsAudienceExclusionTargetingItem>;
 };
 /** Lấy lead phát sinh từ hội thoại theo OA, scene, trạng thái, thời gian và phân trang. Đây là entry tool thuộc lane zalo-ads-conversation-leads; dùng khi nguồn lead là hội thoại thay vì Zalo Form. Phân biệt với lead form: dùng sceneIds, không dùng formIds. */
 type ZaloFormsListConversationLeadsRequest = {
@@ -2811,8 +4019,26 @@ type ZaloFormsListConversationLeadsRequest = {
     /** Danh sách scene ID phân cách dấu phẩy, có thể bỏ trống. */
     sceneIds?: string;
 };
+type ZaloFormsConversationLeadItem = {
+    id: string;
+    oaId: string;
+    userId: string;
+    userName: string;
+    userAvatar?: string;
+    phone?: string;
+    status: number;
+    sceneId?: string;
+    sceneName?: string;
+    labelIds?: Array<string>;
+    note?: string;
+    createdTime: number;
+    updatedTime?: number;
+};
 type ZaloFormsListConversationLeadsResponse = {
-    [key: string]: unknown;
+    msg: string;
+    code: number;
+    total: number;
+    data: Array<ZaloFormsConversationLeadItem>;
 };
 /** Lấy lead được gửi từ Zalo Form theo OA, form, trạng thái, thời gian và phân trang. Đây là entry tool thuộc lane zalo-ads-form-leads; dùng khi cần tra cứu hoặc xử lý lead form. Truyền formIds là chuỗi ID form phân cách bằng dấu phẩy từ tool danh sách form; để trống để không lọc theo form. */
 type ZaloFormsListFormLeadsRequest = {
@@ -2839,15 +4065,33 @@ type ZaloFormsListFormLeadsRequest = {
     /** Chế độ commerce. */
     isCommerce: boolean;
 };
+type ZaloFormsLeadAnswerItem = {
+    questionId: string;
+    title: string;
+    value: string;
+};
+type ZaloFormsLeadItem = {
+    id: string;
+    formId: string;
+    formName?: string;
+    oaId: string;
+    userId?: string;
+    userName?: string;
+    phone?: string;
+    status: number;
+    labelIds?: Array<string>;
+    note?: string;
+    createdTime: number;
+    updatedTime?: number;
+    answers?: Array<ZaloFormsLeadAnswerItem>;
+};
 type ZaloFormsListFormLeadsResponse = {
     msg: string;
     /** 0 là thành công. */
     code: number;
-    /** Bản ghi upstream; chưa có mẫu không rỗng để mô tả trường chi tiết. */
-    data: Array<{
-        [key: string]: unknown;
-    }>;
-    [key: string]: unknown;
+    total?: number;
+    /** Danh sách bản ghi lead thu từ Zalo Form. */
+    data: Array<ZaloFormsLeadItem>;
 };
 /** Lấy danh sách Zalo Form quản trị theo Official Account và khoảng thời gian, kèm trạng thái cùng các chỉ số xem/gửi. Dùng oaId để tra cứu, không thay bằng formId; lấy data[].id trả về làm formId cho các thao tác Form management tiếp theo. data[].status: 1 = Tạo mới, 2 = Không chạy - Form chờ duyệt, 3 = Đang mở, 4 = Không chạy - Form bị từ chối. */
 type ZaloFormsListManagedFormsByOfficialAccountRequest = {
@@ -2903,23 +4147,21 @@ type ZaloFormsListManagedFormsByOfficialAccountResponse = {
         totalGetForm: string;
         /** Cờ upstream với đúng chữ hoa/thường, cho biết yêu cầu mỗi người trả lời chỉ gửi một phản hồi duy nhất. */
         RequiresUniqueResponse: boolean;
-        [key: string]: unknown;
     }>;
     /** Tổng số form khớp với OA và khoảng thời gian. */
     total: number;
-    [key: string]: unknown;
 };
-/** Lấy danh sách form có thể chọn của một Official Account theo thời gian, loại form và chế độ commerce. Đây là entry tool thuộc lane zalo-ads-form; dùng khi cần lấy data[].id làm formId để lọc lead. data[].status: 1 = Tạo mới, 2 = Không chạy - Form chờ duyệt, 3 = Đang mở, 4 = Không chạy - Form bị từ chối. */
+/** Lấy danh sách biểu mẫu (Zalo Form hoặc Commerce Form) của một Official Account theo khoảng thời gian, loại form (`type`) và chế độ thương mại (`isCommerce`). Phân loại: (1) Zalo Form: `type=1, isCommerce=false`; (2) Commerce Form: `type=5, isCommerce=true`. */
 type ZaloFormsListSimpleFormsByOfficialAccountRequest = {
-    /** ID Official Account, không phải formId. */
+    /** ID Official Account dạng mã hóa chuỗi trên form.ads.zalo.me (ví dụ: "J4UB9MRE497YDQKKK"). */
     oaId: string;
-    /** Mã lọc loại form upstream; đã quan sát giá trị 1, chưa xác minh mapping đầy đủ. */
-    type: number;
+    /** Mã phân loại biểu mẫu: 1 = Zalo Form (isCommerce=false), 5 = Commerce Form (isCommerce=true). */
+    type: 1 | 5 | number;
     /** Unix epoch giây, cuối khoảng. */
     toTime: number;
-    /** Unix epoch giây, đầu khoảng. */
+    /** Unix epoch giây, đầu khoảng (mặc định: 1588266000). */
     fromTime: number;
-    /** Chế độ lọc commerce. */
+    /** Chế độ lọc commerce: false cho Zalo Form (type=1), true cho Commerce Form (type=5). */
     isCommerce: boolean;
 };
 type ZaloFormsListSimpleFormsByOfficialAccountResponse = {
@@ -2927,7 +4169,7 @@ type ZaloFormsListSimpleFormsByOfficialAccountResponse = {
     /** 0 là thành công. */
     code: number;
     data: Array<{
-        /** ID form, dùng làm formIds khi lọc lead form. */
+        /** ID form, dùng làm formIds khi lọc lead form hoặc tạo nhóm đối tượng. */
         id: string;
         /** ID Official Account. */
         oaId: string;
@@ -2942,25 +4184,50 @@ type ZaloFormsListSimpleFormsByOfficialAccountResponse = {
         createAt: number;
         formName: string;
         oaAvatar: string;
-        /** Đã quan sát 0; chưa có mapping đáng tin cậy. */
+        /** Cờ cấu hình xét duyệt của biểu mẫu (mặc định là 0). */
         admission: number;
-        /** Chuỗi số. */
+        /** Chuỗi số tổng lượt xem. */
         totalView: string;
         /** Unix epoch giây. */
         updatedAt: number;
         coverPhoto: string;
         description: string;
         isAnonymous: boolean;
-        /** Chuỗi số. */
+        /** Chuỗi số tổng lượt gửi. */
         totalSubmit: string;
-        /** Chuỗi số. */
+        /** Chuỗi số tổng lượt nhận form. */
         totalGetForm: string;
         /** Giữ nguyên chữ hoa/thường của upstream. */
         RequiresUniqueResponse: boolean;
-        [key: string]: unknown;
+        /** Mã loại giao diện mẫu đối với Commerce Form (isCommerce=true, ví dụ: 7). */
+        templateType?: number;
+        /** Thời điểm gửi form gần nhất (Unix epoch giây). */
+        lastSubmitTime?: number;
     }>;
     total: number;
-    [key: string]: unknown;
+};
+/** Lấy danh sách kịch bản tin nhắn hội thoại (Conversation Scenarios) của một Official Account (`oaId`) trên hệ thống Lead Center (`form.ads.zalo.me`). */
+type ZaloFormsListScenariosByOfficialAccountRequest = {
+    /** ID Official Account dạng mã hóa chuỗi trên form.ads.zalo.me (ví dụ: "J4UB9MRE497YDQKKK"). */
+    oaId: string;
+};
+type ZaloFormsScenarioItem = {
+    /** ID định danh kịch bản tin nhắn (ví dụ: "bf34d907e142081c5153"). Dùng làm sceneIds khi lọc lead hội thoại. */
+    id: string;
+    /** ID Official Account sở hữu kịch bản. */
+    oaId: string;
+    /** Tên kịch bản tin nhắn hiển thị trên giao diện (ví dụ: "Kịch bản chào hỏi"). */
+    scenarioName: string;
+    /** Thời điểm tạo kịch bản (Unix epoch giây). */
+    createAt: number;
+    /** Thời điểm cập nhật kịch bản gần nhất (Unix epoch giây). */
+    updateAt: number;
+};
+type ZaloFormsListScenariosByOfficialAccountResponse = {
+    msg: string;
+    total?: number;
+    code: number;
+    data?: Array<ZaloFormsScenarioItem>;
 };
 /** Cập nhật chu kỳ thông báo lead cho một Zalo Form thuộc Official Account đã chọn. Đây là mutation tool thuộc lane zalo-ads-form; dùng khi cần đổi tần suất thông báo nhưng không thay đổi trạng thái bật/tắt, vì enable và disable là hai thao tác riêng. */
 type ZaloFormsUpdateFormLeadNotificationIntervalRequest = {
@@ -2987,9 +4254,7 @@ type ZaloFormsUpdateFormLeadNotificationIntervalResponse = {
         formName: string;
         /** Chu kỳ thông báo hiện tại sau cập nhật. Giá trị 0 xác nhận nhận thông báo ngay khi có lead. */
         interval: number;
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 };
 type ZaloFormsAuthSessionOaItem = {
     /** Mã vai trò trên OA (ví dụ: 1 = Admin). */
@@ -3008,7 +4273,6 @@ type ZaloFormsAuthSessionOaItem = {
     status?: number;
     apiUploadEnabled?: boolean;
     adMessageEnabled?: boolean;
-    [key: string]: unknown;
 };
 /** Lấy thông tin phiên đăng nhập và danh sách Official Accounts (kèm mapping giữa noisedOaId dạng số và oaId dạng mã hóa) trên form.ads.zalo.me. */
 type ZaloFormsGetAuthSessionResponse = {
@@ -3020,12 +4284,10 @@ type ZaloFormsGetAuthSessionResponse = {
         avatar: string;
         token: string;
         isInVN?: boolean;
-        roleWLReview?: unknown[];
+        roleWLReview?: string[];
         oaNotifyLead?: ZaloFormsAuthSessionOaItem;
         oas: ZaloFormsAuthSessionOaItem[];
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 };
 
 /** Zalo Forms API service. Each API explicitly selects its own request transport. */
@@ -3042,13 +4304,31 @@ declare class ZaloFormsService {
     listFormLeads(request: ZaloFormsListFormLeadsRequest, options?: RequestOptions): Promise<ZaloFormsListFormLeadsResponse>;
     listManagedFormsByOfficialAccount(request: ZaloFormsListManagedFormsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloFormsListManagedFormsByOfficialAccountResponse>;
     listSimpleFormsByOfficialAccount(request: ZaloFormsListSimpleFormsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloFormsListSimpleFormsByOfficialAccountResponse>;
+    listScenariosByOfficialAccount(request: ZaloFormsListScenariosByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloFormsListScenariosByOfficialAccountResponse>;
     updateFormLeadNotificationInterval(request: ZaloFormsUpdateFormLeadNotificationIntervalRequest, options?: RequestOptions): Promise<ZaloFormsUpdateFormLeadNotificationIntervalResponse>;
 }
 
-/** Zalo Instant Pages API service. Each API explicitly selects its own request transport. */
-
 declare class ZaloInstantPagesService {
     private readonly client;
+    /**
+     * Bộ công cụ kiểm tra tính hợp lệ dữ liệu (Standalone Validators) cho 13 API Instant Pages.
+     * Dùng ở backend (NestJS/Express/Fastify), middleware hoặc AI Agent để verify payload trước khi gọi SDK.
+     */
+    static readonly validator: {
+        validateCloneInstantPage: typeof validateCloneInstantPageRequest;
+        validateGetInstantPageDetail: typeof validateGetInstantPageDetailRequest;
+        validateGetInstantPageSharedUser: typeof validateGetInstantPageSharedUserRequest;
+        validateListInstantPageEditHistory: typeof validateListInstantPageEditHistoryRequest;
+        validateListInstantPageFormRecords: typeof validateListInstantPageFormRecordsRequest;
+        validateListInstantPageShares: typeof validateListInstantPageSharesRequest;
+        validateListInstantPageUsers: typeof validateListInstantPageUsersRequest;
+        validateListMiniPageTemplates: typeof validateListMiniPageTemplatesRequest;
+        validateSearchInstantPages: typeof validateSearchInstantPagesRequest;
+        validateUpdateInstantPage: typeof validateUpdateInstantPageRequest;
+        validateListInstantPageLeads: typeof validateListInstantPageLeadsRequest;
+        validateListOfficialAccounts: typeof validateListOfficialAccountsRequest;
+        validateUpsertInstantPageForm: typeof validateUpsertInstantPageFormRequest;
+    };
     constructor(client: ZaloSdkHttpClient);
     cloneInstantPage(request: ZaloInstantPagesCloneInstantPageRequest, options?: RequestOptions): Promise<ZaloInstantPagesCloneInstantPageResponse>;
     getInstantPageDetail(request: ZaloInstantPagesGetInstantPageDetailRequest, options?: RequestOptions): Promise<ZaloInstantPagesGetInstantPageDetailResponse>;
@@ -3067,42 +4347,77 @@ declare class ZaloInstantPagesService {
 
 /** DTOs for Zalo Profile Ads (`https://profile.ads.zalo.me`). Request fields are flattened; services route them automatically. */
 
-/** Khởi tạo mới trang Zalo Official Account (OA) cửa hàng hoặc doanh nghiệp trên hệ thống Zalo Ads Profile với đầy đủ danh mục, thông tin liên hệ, địa chỉ và ảnh nhận diện. Đây là mutation tool thuộc lane zalo-ads-page. Dùng sau khi đã tải lên ảnh đại diện lấy avatarId, ảnh bìa lấy coverId và xác nhận đầy đủ thông tin đăng ký trang OA. */
+/**
+ * Mã Danh mục hoạt động chi tiết (`subCategoryId` - 22 mã chuẩn trên `https://profile.ads.zalo.me/register`):
+ * - `10043`: Bất động sản
+ * - `10018`: Công nghệ & Thiết bị
+ * - `10097`: Dịch vụ tiện ích
+ * - `10020`: Du lịch & Lưu trú
+ * - `10021`: Giáo dục & Đào tạo
+ * - `10024`: Mua sắm & Bán lẻ
+ * - `10019`: Mỹ phẩm & Làm đẹp
+ * - `10014`: Nhà hàng & Quán
+ * - `10094`: Ô tô & Xe máy
+ * - `10098`: Sản xuất & Chế tạo
+ * - `10044`: Tài chính & Ngân hàng
+ * - `10099`: Thiết kế & Thi công
+ * - `10017`: Thời trang & May mặc
+ * - `10023`: Thực phẩm & Đồ uống
+ * - `10016`: Truyền thông & Giải trí
+ * - `10092`: Truyền thông nội bộ
+ * - `10101`: Tuyển dụng & Việc làm
+ * - `10100`: Tư vấn & Quản lý
+ * - `10095`: Vận tải
+ * - `10093`: Viễn thông
+ * - `10022`: Y tế & Dược phẩm
+ * - `10025`: Dịch vụ khác
+ */
+type ZaloProfileAdsSubCategoryId = 10043 | 10018 | 10097 | 10020 | 10021 | 10024 | 10019 | 10014 | 10094 | 10098 | 10044 | 10099 | 10017 | 10023 | 10016 | 10092 | 10101 | 10100 | 10095 | 10093 | 10022 | 10025 | (number & {});
+/**
+ * Mã 34 Tỉnh/Thành phố chuẩn trên `https://profile.ads.zalo.me/ajax/get-province`:
+ * - `1`: Thành phố Hà Nội | `79`: Thành phố Hồ Chí Minh | `48`: Thành phố Đà Nẵng | `31`: Thành phố Hải Phòng | `92`: Thành phố Cần Thơ | `46`: Thành phố Huế
+ * - `91`: Tỉnh An Giang | `24`: Tỉnh Bắc Ninh | `96`: Tỉnh Cà Mau | `4`: Tỉnh Cao Bằng | `66`: Tỉnh Đắk Lắk | `11`: Tỉnh Điện Biên | `75`: Tỉnh Đồng Nai | `82`: Tỉnh Đồng Tháp
+ * - `52`: Tỉnh Gia Lai | `42`: Tỉnh Hà Tĩnh | `33`: Tỉnh Hưng Yên | `56`: Tỉnh Khánh Hòa | `12`: Tỉnh Lai Châu | `20`: Tỉnh Lạng Sơn | `15`: Tỉnh Lào Cai | `68`: Tỉnh Lâm Đồng
+ * - `40`: Tỉnh Nghệ An | `37`: Tỉnh Ninh Bình | `25`: Tỉnh Phú Thọ | `51`: Tỉnh Quảng Ngãi | `22`: Tỉnh Quảng Ninh | `44`: Tỉnh Quảng Trị | `14`: Tỉnh Sơn La | `80`: Tỉnh Tây Ninh
+ * - `19`: Tỉnh Thái Nguyên | `38`: Tỉnh Thanh Hóa | `8`: Tỉnh Tuyên Quang | `86`: Tỉnh Vĩnh Long
+ */
+type ZaloProfileAdsProvinceId = 1 | 4 | 8 | 11 | 12 | 14 | 15 | 19 | 20 | 22 | 24 | 25 | 31 | 33 | 37 | 38 | 40 | 42 | 44 | 46 | 48 | 51 | 52 | 56 | 66 | 68 | 75 | 79 | 80 | 82 | 86 | 91 | 92 | 96 | (number & {});
+/** Khởi tạo mới trang Zalo Official Account (OA) / Hồ sơ quảng cáo cửa hàng hoặc doanh nghiệp trên hệ thống Zalo Ads Profile với đầy đủ danh mục, thông tin liên hệ, địa chỉ và ảnh nhận diện. Đây là mutation tool thuộc lane zalo-ads-page. Dùng sau khi đã tải lên ảnh đại diện lấy avatarId, ảnh bìa lấy coverId và xác nhận đầy đủ thông tin đăng ký trang OA. */
 type ZaloProfileAdsCreateOaPageRequest = {
     /** Hành động tạo mới trang Official Account, cố định là "createpage" (SDK tự gán mặc định nếu bỏ qua). */
     option?: "createpage";
     /** Mã CSRF token của phiên làm việc Zalo Ads Profile hiện tại (lưu ý đúng chính tả tham số upstream là `crsf-token`). Nếu sử dụng `zpsid` / `ZaloAuthManager`, SDK sẽ tự động trích xuất từ `https://profile.ads.zalo.me/` nếu bỏ qua. */
     "crsf-token"?: string;
-    /** Hạng tài khoản OA khi khởi tạo (mặc định: 0). */
-    tier: number;
-    /** Tên hiển thị của trang Zalo Official Account cần tạo (tối đa 100 ký tự). */
+    /** Mã loại hình tài khoản OA. Giá trị chuẩn cố định là `2` (Tài khoản OA Doanh nghiệp / Cửa hàng / Hồ sơ quảng cáo; SDK tự gán mặc định `2` nếu bỏ qua). */
+    typeId?: number;
+    /** Định danh chuỗi loại tài khoản OA tương ứng với `typeId = 2`. Giá trị chuẩn cố định là `"store"` (SDK tự gán mặc định `"store"` nếu bỏ qua). */
+    typeName?: string;
+    /** Hạng tài khoản OA khi khởi tạo: `0` = Tài khoản Phổ thông / Hồ sơ quảng cáo mới tạo (`certified: false`, mặc định `0`); `1` = Tài khoản OA Xác thực (`certified: true`). */
+    tier?: number;
+    /** Mã danh mục gốc (Parent Category) được Zalo hardcode cố định là `10003` cho toàn bộ Hồ sơ quảng cáo (SDK tự gán mặc định `10003` nếu bỏ qua). */
+    categoryId?: number;
+    /** Mã Danh mục hoạt động chi tiết (1 trong 22 mã chuẩn `ZaloProfileAdsSubCategoryId`, ví dụ: `10018` = Công nghệ & Thiết bị, `10043` = Bất động sản). */
+    subCategoryId: ZaloProfileAdsSubCategoryId;
+    /** Tên hiển thị của Hồ sơ quảng cáo / Trang Zalo Official Account cần tạo (tối đa 40 ký tự, chữ cái đầu viết hoa). */
     oaName: string;
-    /** Mã loại hình tài khoản OA (ví dụ: 2 là Cửa hàng/Doanh nghiệp). */
-    typeId: number;
-    /** Địa chỉ chi tiết của doanh nghiệp hoặc cửa hàng. */
-    address: string;
-    /** Mã fileId của ảnh bìa nhận được từ công cụ tải ảnh bìa (`uploadOaCover`). */
-    coverId: string;
-    /** Mã fileId của ảnh đại diện nhận được từ công cụ tải ảnh đại diện (`uploadOaAvatar`). */
-    avatarId: string;
-    /** Mã quận/huyện/phường tương ứng (ví dụ: 9556). */
-    district: number;
-    /** Mã tỉnh/thành phố nơi đặt địa chỉ hoạt động (ví dụ: 1 là Thành phố Hà Nội). */
-    province: number;
-    /** Tên định danh loại tài khoản OA (ví dụ: 'store'). */
-    typeName: string;
-    /** Xác nhận đồng ý điều khoản sử dụng Zalo Official Account (luôn là true). */
-    agreeTerm: boolean;
-    /** Mã danh mục chính của trang OA (ví dụ: 10003). */
-    categoryId: number;
+    /** Thông tin giới thiệu về hoạt động hoặc các dịch vụ và sản phẩm mà hồ sơ sẽ quảng cáo (bắt buộc tối thiểu 20 ký tự, tối đa 500 ký tự). */
+    description: string;
     /** Họ và tên người liên hệ phụ trách trang OA. */
     contactName: string;
-    /** Mô tả giới thiệu ngắn về trang Zalo Official Account. */
-    description: string;
-    /** Số điện thoại người liên hệ (định dạng chuỗi số, ví dụ: '84383826333'). */
+    /** Số điện thoại người liên hệ (định dạng chuỗi số, ví dụ: '84384473007'). */
     contactPhone: string;
-    /** Mã danh mục phụ của trang OA (ví dụ: 10018). */
-    subCategoryId: number;
+    /** Mã fileId của ảnh đại diện nhận được từ công cụ tải ảnh đại diện (`uploadOaAvatar`). */
+    avatarId: string;
+    /** Mã fileId của ảnh bìa nhận được từ công cụ tải ảnh bìa (`uploadOaCover`). */
+    coverId: string;
+    /** Mã Tỉnh/Thành phố nơi đặt địa chỉ hoạt động (1 trong 34 mã `ZaloProfileAdsProvinceId` lấy từ `getProvinces`, ví dụ: `1` = Thành phố Hà Nội, `79` = Thành phố Hồ Chí Minh). */
+    province: ZaloProfileAdsProvinceId;
+    /** Mã Phường/Xã tương ứng thuộc Tỉnh/Thành phố đã chọn (lấy từ `getDistricts({ provinceId })`, ví dụ tại Hà Nội `province=1`: `637` = Phường Đại Mỗ, `9556` = Phường Hà Đông). */
+    district: number;
+    /** Địa chỉ chi tiết của doanh nghiệp hoặc cửa hàng (ví dụ: 'Số 40/74 đường Hữu Hưng, Phường Đại Mỗ, Thành phố Hà Nội'). */
+    address: string;
+    /** Xác nhận đồng ý điều khoản sử dụng Zalo Official Account (luôn là `true`, SDK tự gán mặc định `true` nếu bỏ qua). */
+    agreeTerm?: boolean;
 };
 type ZaloProfileAdsCreateOaPageResponse = {
     /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là tạo trang thành công). */
@@ -3115,9 +4430,7 @@ type ZaloProfileAdsCreateOaPageResponse = {
         name: string;
         /** Mã định danh Zalo Official Account ID (OA ID) vừa được khởi tạo. */
         oaid: string;
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 };
 /** Tải lên ảnh đại diện (avatar) cho trang Zalo Official Account trên hệ thống Zalo Ads Profile để nhận mã fileId phục vụ khởi tạo hoặc cập nhật OA. Đây là mutation tool thuộc lane zalo-ads-page. Dùng trước bước tạo mới trang OA khi đã có URL tệp ảnh đại diện hợp lệ cần tải lên. */
 type ZaloProfileAdsUploadOaAvatarRequest = {
@@ -3125,7 +4438,7 @@ type ZaloProfileAdsUploadOaAvatarRequest = {
     option?: "update";
     /** Cờ xác nhận tải ảnh cho OA mới, truyền 'true' khi tạo trang OA mới (mặc định: "true"). */
     "is-new"?: "true" | "false";
-    /** URL HTTP(S), signed URL hoặc Blob/Buffer của tệp ảnh đại diện cần tải lên; hệ thống tự động tải và đính kèm dạng multipart/form-data vào trường `avatar-file`. */
+    /** URL HTTP(S), signed URL hoặc Blob/Buffer của tệp ảnh đại diện cần tải lên (JPG/PNG, tối thiểu 150x150px, tối đa 15MB); hệ thống tự động tải và đính kèm dạng multipart/form-data vào trường `avatar-file`. */
     "avatar-file": FileInput;
 };
 type ZaloProfileAdsUploadOaAvatarResponse = {
@@ -3135,7 +4448,6 @@ type ZaloProfileAdsUploadOaAvatarResponse = {
     msg: string;
     /** Mã định danh tệp ảnh đại diện đã tải lên, dùng để truyền vào trường `avatarId` khi tạo hoặc cập nhật OA. */
     fileId: string;
-    [key: string]: unknown;
 };
 /** Tải lên ảnh bìa (cover) cho trang Zalo Official Account trên hệ thống Zalo Ads Profile để nhận mã fileId phục vụ khởi tạo hoặc cập nhật OA. Đây là mutation tool thuộc lane zalo-ads-page. Dùng trước bước tạo mới trang OA khi đã có URL tệp ảnh bìa hợp lệ cần tải lên. */
 type ZaloProfileAdsUploadOaCoverRequest = {
@@ -3143,7 +4455,7 @@ type ZaloProfileAdsUploadOaCoverRequest = {
     option?: "update";
     /** Cờ xác nhận tải ảnh bìa cho OA mới, truyền 'true' khi tạo trang OA mới (mặc định: "true"). */
     "is-new"?: "true" | "false";
-    /** URL HTTP(S), signed URL hoặc Blob/Buffer của tệp ảnh bìa cần tải lên; hệ thống tự động tải và đính kèm dạng multipart/form-data vào trường `cover-file`. */
+    /** URL HTTP(S), signed URL hoặc Blob/Buffer của tệp ảnh bìa cần tải lên (JPG/PNG, tối thiểu 320x180px, tối đa 15MB); hệ thống tự động tải và đính kèm dạng multipart/form-data vào trường `cover-file`. */
     "cover-file": FileInput;
 };
 type ZaloProfileAdsUploadOaCoverResponse = {
@@ -3153,7 +4465,36 @@ type ZaloProfileAdsUploadOaCoverResponse = {
     msg: string;
     /** Mã định danh tệp ảnh bìa đã tải lên, dùng để truyền vào trường `coverId` khi tạo hoặc cập nhật OA. */
     fileId: string;
-    [key: string]: unknown;
+};
+/** Phần tử Tỉnh/Thành phố hoặc Phường/Xã trên Zalo Ads Profile (`https://profile.ads.zalo.me`). */
+type ZaloProfileAdsAdministrativeItem = {
+    /** Mã định danh Tỉnh/Thành phố (`province`) hoặc Phường/Xã (`district`). */
+    id: number;
+    /** Tên hiển thị của Tỉnh/Thành phố hoặc Phường/Xã. */
+    value: string;
+};
+/** Kết quả lấy danh sách 34 Tỉnh/Thành phố chuẩn trên Zalo Ads Profile (`GET /ajax/get-province`). */
+type ZaloProfileAdsGetProvincesResponse = {
+    /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là thành công). */
+    err: number;
+    /** Thông điệp kết quả xử lý (ví dụ: 'Lấy dữ liệu thành công.'). */
+    msg: string;
+    /** Danh sách 34 Tỉnh/Thành phố. */
+    data: ZaloProfileAdsAdministrativeItem[];
+};
+/** Tham số truy vấn danh sách Phường/Xã theo Tỉnh/Thành phố trên Zalo Ads Profile (`GET /ajax/get-district?provinceId=...`). */
+type ZaloProfileAdsGetDistrictsRequest = {
+    /** Mã Tỉnh/Thành phố lấy từ `getProvinces()` (ví dụ: `1` = Thành phố Hà Nội, `79` = Thành phố Hồ Chí Minh). */
+    provinceId: ZaloProfileAdsProvinceId;
+};
+/** Kết quả lấy danh sách Phường/Xã theo Tỉnh/Thành phố trên Zalo Ads Profile (`GET /ajax/get-district?provinceId=...`). */
+type ZaloProfileAdsGetDistrictsResponse = {
+    /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là thành công). */
+    err: number;
+    /** Thông điệp kết quả xử lý (ví dụ: 'Lấy dữ liệu thành công.'). */
+    msg: string;
+    /** Danh sách Phường/Xã thuộc Tỉnh/Thành phố được truy vấn. */
+    data: ZaloProfileAdsAdministrativeItem[];
 };
 
 /** Zalo Profile Ads API service (`https://profile.ads.zalo.me`). Each API explicitly selects its own request transport. */
@@ -3164,6 +4505,8 @@ declare class ZaloProfileAdsService {
     createOaPage(request: ZaloProfileAdsCreateOaPageRequest, options?: RequestOptions): Promise<ZaloProfileAdsCreateOaPageResponse>;
     uploadOaAvatar(request: ZaloProfileAdsUploadOaAvatarRequest, options?: RequestOptions): Promise<ZaloProfileAdsUploadOaAvatarResponse>;
     uploadOaCover(request: ZaloProfileAdsUploadOaCoverRequest, options?: RequestOptions): Promise<ZaloProfileAdsUploadOaCoverResponse>;
+    getProvinces(options?: RequestOptions): Promise<ZaloProfileAdsGetProvincesResponse>;
+    getDistricts(request: ZaloProfileAdsGetDistrictsRequest, options?: RequestOptions): Promise<ZaloProfileAdsGetDistrictsResponse>;
 }
 
 /** Lấy thông tin công khai của Zalo Official Account theo OA ID, gồm tên, mô tả, ảnh đại diện và cấu trúc menu. Đây là detail tool thuộc lane zalo-ads-page; dùng khi đã có OA ID và cần xác thực hoặc hiển thị thông tin OA trước khi liên kết với luồng quảng cáo. */
@@ -3314,6 +4657,17 @@ declare class ZaloWidgetApiService {
 declare class ZaloAdsSdk {
     private readonly client;
     readonly ads: ZaloAdsService;
+    readonly campaigns: ZaloCampaignsService;
+    readonly account: ZaloAccountService;
+    readonly audiences: ZaloAudiencesService;
+    readonly targeting: ZaloAudiencesService;
+    readonly reports: ZaloReportsService;
+    readonly conversions: ZaloConversionsService;
+    readonly pixel: ZaloConversionsService;
+    readonly automatedRules: ZaloAutomatedRulesService;
+    readonly rules: ZaloAutomatedRulesService;
+    readonly flows: ZaloFlowsService;
+    readonly media: ZaloMediaService;
     readonly forms: ZaloFormsService;
     readonly instantPages: ZaloInstantPagesService;
     readonly profileAds: ZaloProfileAdsService;
@@ -3474,4 +4828,51 @@ declare class ZaloAdsIntegrationManager {
     get poolSize(): number;
 }
 
-export { ALL_ZALO_ADS_DOMAINS, type BodyType, type FileDownloadResponse, type FileInput, type HttpMethod, MemoryZaloSessionStore, type MemoryZaloSessionStoreOptions, type OperationDefinition, RedisZaloSessionStore, type RedisZaloSessionStoreOptions, type RequestOptions, TieredZaloSessionStore, type TieredZaloSessionStoreOptions, ZaloAdsIntegrationManager as ZaloAdsAccountPool, type ZaloAdsChangeAutomatedRuleStatusRequest, type ZaloAdsChangeAutomatedRuleStatusResponse, type ZaloAdsChangeCampaignStatusRequest, type ZaloAdsChangeCampaignStatusResponse, type ZaloAdsClientRequest, type ZaloAdsCreateArticleCampaignRequest, type ZaloAdsCreateArticleCampaignResponse, type ZaloAdsCreateAutomatedRuleRequest, type ZaloAdsCreateAutomatedRuleResponse, type ZaloAdsCreateCommerceCampaignRequest, type ZaloAdsCreateCommerceCampaignResponse, type ZaloAdsCreateConversionRequest, type ZaloAdsCreateConversionResponse, type ZaloAdsCreateCustomAudienceRequest, type ZaloAdsCreateCustomAudienceResponse, type ZaloAdsCreateDisplayCampaignRequest, type ZaloAdsCreateDisplayCampaignResponse, type ZaloAdsCreateEcommerceCampaignRequest, type ZaloAdsCreateEcommerceCampaignResponse, ZaloAdsCreateFlowRequest, ZaloAdsCreateFlowResponse, type ZaloAdsCreateFormCampaignRequest, type ZaloAdsCreateFormCampaignResponse, type ZaloAdsCreateFormRequest, type ZaloAdsCreateFormResponse, type ZaloAdsCreateMessageCampaignRequest, type ZaloAdsCreateMessageCampaignResponse, type ZaloAdsCreateOaCampaignRequest, type ZaloAdsCreateOaCampaignResponse, type ZaloAdsCreateOfficialAccountCampaignRequest, type ZaloAdsCreateOfficialAccountCampaignResponse, ZaloAdsCreatePostCampaignRequest, ZaloAdsCreatePostCampaignResponse, type ZaloAdsCreateVideoCampaignRequest, type ZaloAdsCreateVideoCampaignResponse, type ZaloAdsCreateWebsiteCampaignRequest, type ZaloAdsCreateWebsiteCampaignResponse, type ZaloAdsDeleteAutomatedRuleRequest, type ZaloAdsDeleteAutomatedRuleResponse, type ZaloAdsDeleteCampaignRequest, type ZaloAdsDeleteCampaignResponse, type ZaloAdsDeleteConversionRequest, type ZaloAdsDeleteConversionResponse, type ZaloAdsDeleteCustomAudienceRequest, type ZaloAdsDeleteCustomAudienceResponse, type ZaloAdsDomain, ZaloAdsFlowButtonDto, ZaloAdsFlowChildMessageDto, ZaloAdsFlowMessageDto, type ZaloAdsGetAdByIdRequest, type ZaloAdsGetAdByIdResponse, type ZaloAdsGetAdChangeLogRequest, type ZaloAdsGetAdChangeLogResponse, type ZaloAdsGetApiAdGetlistadadvancetargetingRequest, type ZaloAdsGetApiAdGetlistadadvancetargetingResponse, type ZaloAdsGetApiBaAccountAllaccessorsRequest, type ZaloAdsGetApiBaAccountAllaccessorsResponse, type ZaloAdsGetApiBaAccountAllgrantedmembersRequest, type ZaloAdsGetApiBaAccountAllgrantedmembersResponse, type ZaloAdsGetApiConversionAllRequest, type ZaloAdsGetApiConversionAllResponse, type ZaloAdsGetApiConversionStandardEventsRequest, type ZaloAdsGetApiConversionStandardEventsResponse, type ZaloAdsGetApiCustomAudienceAllRequest, type ZaloAdsGetApiCustomAudienceAllResponse, type ZaloAdsGetApiFilegroupsRequest, type ZaloAdsGetApiFilegroupsResponse, type ZaloAdsGetApiLpNewsRequest, type ZaloAdsGetApiLpNewsResponse, type ZaloAdsGetApiMediaItemsRequest, type ZaloAdsGetApiMediaItemsResponse, type ZaloAdsGetApiMemberFilesRequest, type ZaloAdsGetApiMemberFilesResponse, type ZaloAdsGetApiNotifiesHeaderRequest, type ZaloAdsGetApiNotifiesHeaderResponse, type ZaloAdsGetApiPaymentTransactionHistoryRequest, type ZaloAdsGetApiPaymentTransactionHistoryResponse, type ZaloAdsGetApiPlaceGetalldistrictsRequest, type ZaloAdsGetApiPlaceGetalldistrictsResponse, type ZaloAdsGetApiSpellCheckV2Request, type ZaloAdsGetApiSpellCheckV2Response, type ZaloAdsGetApiWhoamiRequest, type ZaloAdsGetApiWhoamiResponse, type ZaloAdsGetAutomatedRuleHistoryRequest, type ZaloAdsGetAutomatedRuleHistoryResponse, type ZaloAdsGetReportapiV2AdsRequest, type ZaloAdsGetReportapiV2AdsResponse, type ZaloAdsGetReportapiV2CampaignsRequest, type ZaloAdsGetReportapiV2CampaignsResponse, type ZaloAdsGetReportapiV2UniqueUserRequest, type ZaloAdsGetReportapiV2UniqueUserResponse, type ZaloAdsGetReportapiV3CampaignsRequest, type ZaloAdsGetReportapiV3CampaignsResponse, type ZaloAdsGetZaapiCampaignReportcampaignRequest, type ZaloAdsGetZaapiCampaignReportcampaignResponse, type ZaloAdsGetZaapiCheckcamphasmanyadsRequest, type ZaloAdsGetZaapiCheckcamphasmanyadsResponse, type ZaloAdsGetZaapiGetadsfromcampaignidRequest, type ZaloAdsGetZaapiGetadsfromcampaignidResponse, type ZaloAdsGetZaapiGetallpagesRequest, type ZaloAdsGetZaapiGetallpagesResponse, type ZaloAdsGetZaapiGetownedarticlesRequest, type ZaloAdsGetZaapiGetownedarticlesResponse, type ZaloAdsGetZaapiGetownedpagesRequest, type ZaloAdsGetZaapiGetownedpagesResponse, ZaloAdsIntegrationManager, type ZaloAdsIntegrationManagerOptions, type ZaloAdsListAgencyCustomersWithBudgetRequest, type ZaloAdsListAgencyCustomersWithBudgetResponse, type ZaloAdsListAutomatedRulesRequest, type ZaloAdsListAutomatedRulesResponse, type ZaloAdsListCustomReportsRequest, type ZaloAdsListCustomReportsResponse, type ZaloAdsListFlowsByOfficialAccountRequest, type ZaloAdsListFlowsByOfficialAccountResponse, type ZaloAdsListFormsByOfficialAccountRequest, type ZaloAdsListFormsByOfficialAccountResponse, type ZaloAdsListMiniPagesByTemplateRequest, type ZaloAdsListMiniPagesByTemplateResponse, type ZaloAdsListPersonalPixelLabelsRequest, type ZaloAdsListPersonalPixelLabelsResponse, ZaloAdsMessageAdUpdateDataDto, type ZaloAdsPostApiAdEstimateaudienceRequest, type ZaloAdsPostApiAdEstimateaudienceResponse, type ZaloAdsPostApiMediaSaveRequest, type ZaloAdsPostApiMediaSaveResponse, type ZaloAdsPostApiMemberUploadImageRequest, type ZaloAdsPostApiMemberUploadImageResponse, type ZaloAdsPostZaapiDeleteadRequest, type ZaloAdsPostZaapiDeleteadResponse, type ZaloAdsRenameCampaignRequest, type ZaloAdsRenameCampaignResponse, ZaloAdsSdk, type ZaloAdsSdkOptions, ZaloAdsService, type ZaloAdsUpdateArticleAdRequest, type ZaloAdsUpdateArticleAdResponse, type ZaloAdsUpdateAutomatedRuleRequest, type ZaloAdsUpdateAutomatedRuleResponse, type ZaloAdsUpdateCommerceAdRequest, type ZaloAdsUpdateCommerceAdResponse, type ZaloAdsUpdateDisplayAdRequest, type ZaloAdsUpdateDisplayAdResponse, type ZaloAdsUpdateEcommerceAdRequest, type ZaloAdsUpdateEcommerceAdResponse, type ZaloAdsUpdateFlowRequest, type ZaloAdsUpdateFlowResponse, type ZaloAdsUpdateFormAdRequest, type ZaloAdsUpdateFormAdResponse, ZaloAdsUpdateMessageAdRequest, ZaloAdsUpdateMessageAdResponse, type ZaloAdsUpdateNewAdsRequest, type ZaloAdsUpdateNewAdsResponse, type ZaloAdsUpdateOaAdRequest, type ZaloAdsUpdateOaAdResponse, type ZaloAdsUpdateOfficialAccountAdRequest, type ZaloAdsUpdateOfficialAccountAdResponse, type ZaloAdsUpdatePostAdRequest, type ZaloAdsUpdatePostAdResponse, ZaloAdsUpdateVideoAdRequest, ZaloAdsUpdateVideoAdResponse, type ZaloAdsUpdateWebsiteAdRequest, type ZaloAdsUpdateWebsiteAdResponse, type ZaloAdsUploadCustomAudiencePhoneListRequest, type ZaloAdsUploadCustomAudiencePhoneListResponse, type ZaloAdsUploadVideoRequest, type ZaloAdsUploadVideoResponse, type ZaloAdsUpsertCustomReportRequest, type ZaloAdsUpsertCustomReportResponse, type ZaloAdsWhoamiProfile, type ZaloAuthDomain, ZaloAuthManager, type ZaloChatWidgetGetChatWidgetLoginConfigRequest, type ZaloChatWidgetGetChatWidgetLoginConfigResponse, type ZaloChatWidgetGetLoginConfigRequest, type ZaloChatWidgetGetLoginConfigResponse, ZaloChatWidgetService, type ZaloDomainSession, type ZaloFormSessionProfile, type ZaloFormsAuthSessionOaItem, type ZaloFormsDisableFormLeadNotificationRequest, type ZaloFormsDisableFormLeadNotificationResponse, type ZaloFormsEnableFormLeadNotificationRequest, type ZaloFormsEnableFormLeadNotificationResponse, type ZaloFormsExportFormLeadReportRequest, type ZaloFormsExportFormLeadReportResponse, type ZaloFormsGetAuthSessionResponse, type ZaloFormsListAudienceExclusionTargetingRequest, type ZaloFormsListAudienceExclusionTargetingResponse, type ZaloFormsListConversationLeadsRequest, type ZaloFormsListConversationLeadsResponse, type ZaloFormsListFormLeadsRequest, type ZaloFormsListFormLeadsResponse, type ZaloFormsListManagedFormsByOfficialAccountRequest, type ZaloFormsListManagedFormsByOfficialAccountResponse, type ZaloFormsListSimpleFormsByOfficialAccountRequest, type ZaloFormsListSimpleFormsByOfficialAccountResponse, ZaloFormsService, type ZaloFormsUpdateFormLeadNotificationIntervalRequest, type ZaloFormsUpdateFormLeadNotificationIntervalResponse, type ZaloInstantPagesCloneInstantPageRequest, type ZaloInstantPagesCloneInstantPageResponse, type ZaloInstantPagesGetInstantPageDetailRequest, type ZaloInstantPagesGetInstantPageDetailResponse, type ZaloInstantPagesGetInstantPageSharedUserRequest, type ZaloInstantPagesGetInstantPageSharedUserResponse, type ZaloInstantPagesListInstantPageEditHistoryRequest, type ZaloInstantPagesListInstantPageEditHistoryResponse, type ZaloInstantPagesListInstantPageFormRecordsRequest, type ZaloInstantPagesListInstantPageFormRecordsResponse, type ZaloInstantPagesListInstantPageLeadsRequest, type ZaloInstantPagesListInstantPageLeadsResponse, type ZaloInstantPagesListInstantPageSharesRequest, type ZaloInstantPagesListInstantPageSharesResponse, type ZaloInstantPagesListInstantPageUsersRequest, type ZaloInstantPagesListInstantPageUsersResponse, type ZaloInstantPagesListMiniPageTemplatesRequest, type ZaloInstantPagesListMiniPageTemplatesResponse, type ZaloInstantPagesListOfficialAccountsRequest, type ZaloInstantPagesListOfficialAccountsResponse, type ZaloInstantPagesOfficialAccountItem, type ZaloInstantPagesSearchInstantPagesRequest, type ZaloInstantPagesSearchInstantPagesResponse, ZaloInstantPagesService, type ZaloInstantPagesUpdateInstantPageRequest, type ZaloInstantPagesUpdateInstantPageResponse, type ZaloInstantPagesUpsertInstantPageFormRequest, type ZaloInstantPagesUpsertInstantPageFormResponse, type ZaloIntegrationCredentials, type ZaloIntegrationVerificationResult, type ZaloPlaySessionPayload, type ZaloProfileAdsCreateOaPageRequest, type ZaloProfileAdsCreateOaPageResponse, ZaloProfileAdsService, type ZaloProfileAdsUploadOaAvatarRequest, type ZaloProfileAdsUploadOaAvatarResponse, type ZaloProfileAdsUploadOaCoverRequest, type ZaloProfileAdsUploadOaCoverResponse, type ZaloRedisLikeClient, type ZaloSdkAuth, type ZaloSdkAuthContext, ZaloSdkError, ZaloSdkHttpClient, type ZaloSessionStore, type ZaloSsoAuthOptions, type ZaloWidgetAPIGetOfficialAccountInfoRequest, type ZaloWidgetAPIGetOfficialAccountInfoResponse, type ZaloWidgetAPIGetWidgetUserProfileRequest, type ZaloWidgetAPIGetWidgetUserProfileResponse, type ZaloWidgetAPIListStickerCategoriesRequest, type ZaloWidgetAPIListStickerCategoriesResponse, type ZaloWidgetAPIListStickersByCategoryRequest, type ZaloWidgetAPIListStickersByCategoryResponse, ZaloWidgetApiService, computeZpsidFingerprint, createZaloSsoAuth, decodePlaySessionJwt, ZaloAdsSdk as default, defaultSharedMemorySessionStore, deriveAccountKeyFromZpsid, parseZaloCookieInput };
+/**
+ * Bộ kiểm tra tính hợp lệ dữ liệu (Request Validators) cho 13 API Zalo Instant Pages.
+ * Được thiết kế để xuất ra ngoài cho backend (NestJS/Express/Fastify), middleware hoặc AI Agent
+ * sử dụng để xác thực dữ liệu đầu vào trước khi lưu trữ hoặc gọi API Zalo Ads.
+ *
+ * Lưu ý: Các hàm validate này là độc lập (pure functions), KHÔNG bị nhúng cứng bên trong
+ * các hàm gọi HTTP của ZaloInstantPagesService, giúp giữ cho Service gọn gàng và unopinionated.
+ */
+
+/** Kết quả xác thực dữ liệu đầu vào của API. */
+interface ValidationResult<T = unknown> {
+    /** True nếu dữ liệu hợp lệ và thỏa mãn quy chuẩn; False nếu có ít nhất 1 lỗi. */
+    isValid: boolean;
+    /** Danh sách các thông báo lỗi chi tiết. Rỗng nếu isValid = true. */
+    errors: string[];
+    /** Dữ liệu sau khi làm sạch và ép kiểu chuẩn (nếu hợp lệ). */
+    data?: T;
+}
+declare function validateCloneInstantPageRequest(input: unknown): ValidationResult<ZaloInstantPagesCloneInstantPageRequest>;
+declare function validateGetInstantPageDetailRequest(input: unknown): ValidationResult<ZaloInstantPagesGetInstantPageDetailRequest>;
+declare function validateGetInstantPageSharedUserRequest(input: unknown): ValidationResult<ZaloInstantPagesGetInstantPageSharedUserRequest>;
+declare function validateListInstantPageEditHistoryRequest(input: unknown): ValidationResult<ZaloInstantPagesListInstantPageEditHistoryRequest>;
+declare function validateListInstantPageFormRecordsRequest(input: unknown): ValidationResult<ZaloInstantPagesListInstantPageFormRecordsRequest>;
+declare function validateListInstantPageSharesRequest(input: unknown): ValidationResult<ZaloInstantPagesListInstantPageSharesRequest>;
+declare function validateListInstantPageUsersRequest(input?: unknown): ValidationResult<ZaloInstantPagesListInstantPageUsersRequest>;
+declare function validateListMiniPageTemplatesRequest(input?: unknown): ValidationResult<ZaloInstantPagesListMiniPageTemplatesRequest>;
+declare function validateSearchInstantPagesRequest(input?: unknown): ValidationResult<ZaloInstantPagesSearchInstantPagesRequest>;
+declare function validateUpdateInstantPageRequest(input: unknown): ValidationResult<ZaloInstantPagesUpdateInstantPageRequest>;
+declare function validateListInstantPageLeadsRequest(input: unknown): ValidationResult<ZaloInstantPagesListInstantPageLeadsRequest>;
+declare function validateListOfficialAccountsRequest(input?: unknown): ValidationResult<ZaloInstantPagesListOfficialAccountsRequest>;
+declare function validateUpsertInstantPageFormRequest(input: unknown): ValidationResult<ZaloInstantPagesUpsertInstantPageFormRequest>;
+declare const ZaloInstantPagesValidator: {
+    validateCloneInstantPage: typeof validateCloneInstantPageRequest;
+    validateGetInstantPageDetail: typeof validateGetInstantPageDetailRequest;
+    validateGetInstantPageSharedUser: typeof validateGetInstantPageSharedUserRequest;
+    validateListInstantPageEditHistory: typeof validateListInstantPageEditHistoryRequest;
+    validateListInstantPageFormRecords: typeof validateListInstantPageFormRecordsRequest;
+    validateListInstantPageShares: typeof validateListInstantPageSharesRequest;
+    validateListInstantPageUsers: typeof validateListInstantPageUsersRequest;
+    validateListMiniPageTemplates: typeof validateListMiniPageTemplatesRequest;
+    validateSearchInstantPages: typeof validateSearchInstantPagesRequest;
+    validateUpdateInstantPage: typeof validateUpdateInstantPageRequest;
+    validateListInstantPageLeads: typeof validateListInstantPageLeadsRequest;
+    validateListOfficialAccounts: typeof validateListOfficialAccountsRequest;
+    validateUpsertInstantPageForm: typeof validateUpsertInstantPageFormRequest;
+};
+
+export { ALL_ZALO_ADS_DOMAINS, type BodyType, type FileDownloadResponse, type FileInput, type HttpMethod, type MediaValidationResult, MemoryZaloSessionStore, type MemoryZaloSessionStoreOptions, type OperationDefinition, RedisZaloSessionStore, type RedisZaloSessionStoreOptions, type RequestOptions, TieredZaloSessionStore, type TieredZaloSessionStoreOptions, type ValidateImageInput, type ValidateVideoInput, type ValidationResult, ZaloAccountService, type ZaloAdsAccessorItemDto, type ZaloAdsAccountAgencyInfoDto, ZaloAdsIntegrationManager as ZaloAdsAccountPool, type ZaloAdsAdAppInfoSettingsDto, type ZaloAdsAdImageSettingsDto, type ZaloAdsAdInfoSettingsDto, type ZaloAdsAdMultiImageItemDto, type ZaloAdsAdMutationResultDto, type ZaloAdsAdPriceSettingsDto, type ZaloAdsAdReportItemDto, type ZaloAdsAdSettingsDto, type ZaloAdsAdTargetingSettingsDto, type ZaloAdsAdUpdatePayloadDto, type ZaloAdsAdZVideoSettingsDto, type ZaloAdsAutomatedRuleActionDto, type ZaloAdsAutomatedRuleConditionDto, type ZaloAdsAutomatedRuleScheduleDto, type ZaloAdsCampaignCreatePayloadDto, type ZaloAdsCampaignReportItemDto, type ZaloAdsChangeAutomatedRuleStatusRequest, type ZaloAdsChangeAutomatedRuleStatusResponse, type ZaloAdsChangeCampaignStatusRequest, type ZaloAdsChangeCampaignStatusResponse, type ZaloAdsClientRequest, type ZaloAdsCommerceFormAudienceTargetingDto, type ZaloAdsConversionElementSelectorDto, type ZaloAdsConversionItemDto, type ZaloAdsConversionNameItemDto, type ZaloAdsCreateArticleCampaignRequest, type ZaloAdsCreateArticleCampaignResponse, type ZaloAdsCreateAutomatedRuleRequest, type ZaloAdsCreateAutomatedRuleResponse, type ZaloAdsCreateCommerceCampaignRequest, type ZaloAdsCreateCommerceCampaignResponse, type ZaloAdsCreateCommerceFormAudienceRequest, type ZaloAdsCreateCommerceFormAudienceResponse, type ZaloAdsCreateConversionRequest, type ZaloAdsCreateConversionResponse, type ZaloAdsCreateCustomAudienceRequest, type ZaloAdsCreateCustomAudienceResponse, type ZaloAdsCreateDisplayCampaignRequest, type ZaloAdsCreateDisplayCampaignResponse, type ZaloAdsCreateEcommerceCampaignRequest, type ZaloAdsCreateEcommerceCampaignResponse, ZaloAdsCreateFlowRequest, ZaloAdsCreateFlowResponse, type ZaloAdsCreateFormCampaignRequest, type ZaloAdsCreateFormCampaignResponse, type ZaloAdsCreateFormEventAudienceRequest, type ZaloAdsCreateFormEventAudienceResponse, type ZaloAdsCreateFormLeadAudienceRequest, type ZaloAdsCreateFormLeadAudienceResponse, type ZaloAdsCreateFormPayloadDto, type ZaloAdsCreateFormRequest, type ZaloAdsCreateFormResponse, type ZaloAdsCreateLeadSignalAudienceRequest, type ZaloAdsCreateLeadSignalAudienceResponse, type ZaloAdsCreateLookalikeAudienceRequest, type ZaloAdsCreateLookalikeAudienceResponse, type ZaloAdsCreateMessageCampaignRequest, type ZaloAdsCreateMessageCampaignResponse, type ZaloAdsCreateMessageOaEventAudienceRequest, type ZaloAdsCreateMessageOaEventAudienceResponse, type ZaloAdsCreateMessageOaLeadAudienceRequest, type ZaloAdsCreateMessageOaLeadAudienceResponse, type ZaloAdsCreateMessagePersonalEventAudienceRequest, type ZaloAdsCreateMessagePersonalEventAudienceResponse, type ZaloAdsCreateOaCampaignRequest, type ZaloAdsCreateOaCampaignResponse, type ZaloAdsCreateOfficialAccountCampaignRequest, type ZaloAdsCreateOfficialAccountCampaignResponse, type ZaloAdsCreatePhoneAudienceRequest, type ZaloAdsCreatePhoneAudienceResponse, ZaloAdsCreatePostCampaignRequest, ZaloAdsCreatePostCampaignResponse, type ZaloAdsCreateSavedAudienceRequest, type ZaloAdsCreateSavedAudienceResponse, type ZaloAdsCreateVideoCampaignRequest, type ZaloAdsCreateVideoCampaignResponse, type ZaloAdsCreateWebsiteCampaignRequest, type ZaloAdsCreateWebsiteCampaignResponse, type ZaloAdsDeleteAutomatedRuleRequest, type ZaloAdsDeleteAutomatedRuleResponse, type ZaloAdsDeleteCampaignRequest, type ZaloAdsDeleteCampaignResponse, type ZaloAdsDeleteConversionRequest, type ZaloAdsDeleteConversionResponse, type ZaloAdsDeleteCustomAudienceRequest, type ZaloAdsDeleteCustomAudienceResponse, type ZaloAdsDeleteCustomReportRequest, type ZaloAdsDeleteCustomReportResponse, type ZaloAdsDomain, type ZaloAdsFileGroupItemDto, ZaloAdsFlowButtonDto, ZaloAdsFlowChildMessageDto, ZaloAdsFlowMessageDto, type ZaloAdsFormAnswerDto, type ZaloAdsFormEventAudienceTargetingDto, type ZaloAdsFormLeadAudienceTargetingDto, type ZaloAdsFormQuestionDto, type ZaloAdsFormQuestionUiDto, type ZaloAdsFormSectionContentDto, type ZaloAdsFormSectionDto, type ZaloAdsFormSectionImageItemDto, type ZaloAdsFormSectionTableItemDto, type ZaloAdsGetAdByIdRequest, type ZaloAdsGetAdByIdResponse, type ZaloAdsGetAdChangeLogRequest, type ZaloAdsGetAdChangeLogResponse, type ZaloAdsGetApiAdGetlistadadvancetargetingRequest, type ZaloAdsGetApiAdGetlistadadvancetargetingResponse, type ZaloAdsGetApiBaAccountAllaccessorsRequest, type ZaloAdsGetApiBaAccountAllaccessorsResponse, type ZaloAdsGetApiBaAccountAllgrantedmembersRequest, type ZaloAdsGetApiBaAccountAllgrantedmembersResponse, type ZaloAdsGetApiConversionAllRequest, type ZaloAdsGetApiConversionAllResponse, type ZaloAdsGetApiConversionStandardEventsRequest, type ZaloAdsGetApiConversionStandardEventsResponse, type ZaloAdsGetApiCustomAudienceAllRequest, type ZaloAdsGetApiCustomAudienceAllResponse, type ZaloAdsGetApiFilegroupsRequest, type ZaloAdsGetApiFilegroupsResponse, type ZaloAdsGetApiLpNewsRequest, type ZaloAdsGetApiLpNewsResponse, type ZaloAdsGetApiMediaItemsRequest, type ZaloAdsGetApiMediaItemsResponse, type ZaloAdsGetApiMemberFilesRequest, type ZaloAdsGetApiMemberFilesResponse, type ZaloAdsGetApiNotifiesHeaderRequest, type ZaloAdsGetApiNotifiesHeaderResponse, type ZaloAdsGetApiPaymentTransactionHistoryRequest, type ZaloAdsGetApiPaymentTransactionHistoryResponse, type ZaloAdsGetApiPlaceGetalldistrictsRequest, type ZaloAdsGetApiPlaceGetalldistrictsResponse, type ZaloAdsGetApiSpellCheckV2Request, type ZaloAdsGetApiSpellCheckV2Response, type ZaloAdsGetApiWhoamiRequest, type ZaloAdsGetApiWhoamiResponse, type ZaloAdsGetAutomatedRuleHistoryRequest, type ZaloAdsGetAutomatedRuleHistoryResponse, type ZaloAdsGetDemographicsReportRequest, type ZaloAdsGetDemographicsReportResponse, type ZaloAdsGetReportOverviewRequest, type ZaloAdsGetReportOverviewResponse, type ZaloAdsGetReportapiV2AdsRequest, type ZaloAdsGetReportapiV2AdsResponse, type ZaloAdsGetReportapiV2CampaignsRequest, type ZaloAdsGetReportapiV2CampaignsResponse, type ZaloAdsGetReportapiV2UniqueUserRequest, type ZaloAdsGetReportapiV2UniqueUserResponse, type ZaloAdsGetReportapiV3CampaignsRequest, type ZaloAdsGetReportapiV3CampaignsResponse, type ZaloAdsGetZaapiCampaignReportcampaignRequest, type ZaloAdsGetZaapiCampaignReportcampaignResponse, type ZaloAdsGetZaapiCheckcamphasmanyadsRequest, type ZaloAdsGetZaapiCheckcamphasmanyadsResponse, type ZaloAdsGetZaapiGetadsfromcampaignidRequest, type ZaloAdsGetZaapiGetadsfromcampaignidResponse, type ZaloAdsGetZaapiGetallpagesRequest, type ZaloAdsGetZaapiGetallpagesResponse, type ZaloAdsGetZaapiGetownedarticlesRequest, type ZaloAdsGetZaapiGetownedarticlesResponse, type ZaloAdsGetZaapiGetownedpagesRequest, type ZaloAdsGetZaapiGetownedpagesResponse, type ZaloAdsGrantedMemberItemDto, ZaloAdsIntegrationManager, type ZaloAdsIntegrationManagerOptions, type ZaloAdsLeadSignalAudienceTargetingDto, type ZaloAdsLeadSignalOaItem, type ZaloAdsListAgencyCustomersWithBudgetRequest, type ZaloAdsListAgencyCustomersWithBudgetResponse, type ZaloAdsListAutomatedRulesRequest, type ZaloAdsListAutomatedRulesResponse, type ZaloAdsListConversionNamesRequest, type ZaloAdsListConversionNamesResponse, type ZaloAdsListCustomReportsRequest, type ZaloAdsListCustomReportsResponse, type ZaloAdsListFlowsByOfficialAccountRequest, type ZaloAdsListFlowsByOfficialAccountResponse, type ZaloAdsListFormsByOfficialAccountRequest, type ZaloAdsListFormsByOfficialAccountResponse, type ZaloAdsListLeadSignalOasResponse, type ZaloAdsListMiniPagesByTemplateRequest, type ZaloAdsListMiniPagesByTemplateResponse, type ZaloAdsListPersonalPixelLabelsRequest, type ZaloAdsListPersonalPixelLabelsResponse, type ZaloAdsListReportFiltersRequest, type ZaloAdsListReportFiltersResponse, type ZaloAdsLookalikeAudienceTargetingDto, type ZaloAdsLpNewsButtonDto, type ZaloAdsLpNewsItemDto, type ZaloAdsMediaSavePayloadDto, type ZaloAdsMediaSaveSettingsDto, type ZaloAdsMemberFileItemDto, ZaloAdsMessageAdUpdateDataDto, type ZaloAdsMessageOaEventAudienceTargetingDto, type ZaloAdsMessageOaLeadAudienceTargetingDto, type ZaloAdsMessagePersonalEventAudienceTargetingDto, type ZaloAdsNotifyHeaderItemDto, type ZaloAdsOwnedArticleItemDto, type ZaloAdsOwnedPageExtraInfoDto, type ZaloAdsOwnedPageItemDto, type ZaloAdsOwnedPageLocationDto, type ZaloAdsPageConfigDto, type ZaloAdsPaymentTransactionItemDto, type ZaloAdsPhoneAudienceTargetingDto, type ZaloAdsPostApiAdEstimateaudienceRequest, type ZaloAdsPostApiAdEstimateaudienceResponse, type ZaloAdsPostApiMediaSaveRequest, type ZaloAdsPostApiMediaSaveResponse, type ZaloAdsPostApiMemberUploadImageRequest, type ZaloAdsPostApiMemberUploadImageResponse, type ZaloAdsPostZaapiDeleteadRequest, type ZaloAdsPostZaapiDeleteadResponse, type ZaloAdsRenameCampaignRequest, type ZaloAdsRenameCampaignResponse, ZaloAdsSdk, type ZaloAdsSdkOptions, ZaloAdsService, type ZaloAdsSpellCheckIssueDto, type ZaloAdsStandardEventItemDto, type ZaloAdsUniqueUserReportDataDto, type ZaloAdsUpdateArticleAdRequest, type ZaloAdsUpdateArticleAdResponse, type ZaloAdsUpdateAutomatedRuleRequest, type ZaloAdsUpdateAutomatedRuleResponse, type ZaloAdsUpdateCommerceAdRequest, type ZaloAdsUpdateCommerceAdResponse, type ZaloAdsUpdateDisplayAdRequest, type ZaloAdsUpdateDisplayAdResponse, type ZaloAdsUpdateEcommerceAdRequest, type ZaloAdsUpdateEcommerceAdResponse, type ZaloAdsUpdateFlowRequest, type ZaloAdsUpdateFlowResponse, type ZaloAdsUpdateFormAdRequest, type ZaloAdsUpdateFormAdResponse, ZaloAdsUpdateMessageAdRequest, ZaloAdsUpdateMessageAdResponse, type ZaloAdsUpdateNewAdsRequest, type ZaloAdsUpdateNewAdsResponse, type ZaloAdsUpdateOaAdRequest, type ZaloAdsUpdateOaAdResponse, type ZaloAdsUpdateOfficialAccountAdRequest, type ZaloAdsUpdateOfficialAccountAdResponse, type ZaloAdsUpdatePostAdRequest, type ZaloAdsUpdatePostAdResponse, ZaloAdsUpdateVideoAdRequest, ZaloAdsUpdateVideoAdResponse, type ZaloAdsUpdateWebsiteAdRequest, type ZaloAdsUpdateWebsiteAdResponse, type ZaloAdsUploadCustomAudiencePhoneListRequest, type ZaloAdsUploadCustomAudiencePhoneListResponse, type ZaloAdsUploadVideoRequest, type ZaloAdsUploadVideoResponse, type ZaloAdsUpsertCustomReportRequest, type ZaloAdsUpsertCustomReportResponse, type ZaloAdsWhoamiProfile, type ZaloAdsZaapiCampaignReportItemDto, ZaloAudiencesService, type ZaloAuthDomain, ZaloAuthManager, ZaloAutomatedRulesService, ZaloCampaignsService, type ZaloChatWidgetGetChatWidgetLoginConfigRequest, type ZaloChatWidgetGetChatWidgetLoginConfigResponse, type ZaloChatWidgetGetLoginConfigRequest, type ZaloChatWidgetGetLoginConfigResponse, ZaloChatWidgetService, ZaloConversionsService, type ZaloDomainSession, ZaloFlowsService, type ZaloFormSessionProfile, type ZaloFormsAudienceExclusionTargetingItem, type ZaloFormsAuthSessionOaItem, type ZaloFormsConversationLeadItem, type ZaloFormsDisableFormLeadNotificationRequest, type ZaloFormsDisableFormLeadNotificationResponse, type ZaloFormsEnableFormLeadNotificationRequest, type ZaloFormsEnableFormLeadNotificationResponse, type ZaloFormsExportFormLeadReportRequest, type ZaloFormsExportFormLeadReportResponse, type ZaloFormsGetAuthSessionResponse, type ZaloFormsLeadAnswerItem, type ZaloFormsLeadItem, type ZaloFormsListAudienceExclusionTargetingRequest, type ZaloFormsListAudienceExclusionTargetingResponse, type ZaloFormsListConversationLeadsRequest, type ZaloFormsListConversationLeadsResponse, type ZaloFormsListFormLeadsRequest, type ZaloFormsListFormLeadsResponse, type ZaloFormsListManagedFormsByOfficialAccountRequest, type ZaloFormsListManagedFormsByOfficialAccountResponse, type ZaloFormsListScenariosByOfficialAccountRequest, type ZaloFormsListScenariosByOfficialAccountResponse, type ZaloFormsListSimpleFormsByOfficialAccountRequest, type ZaloFormsListSimpleFormsByOfficialAccountResponse, type ZaloFormsScenarioItem, ZaloFormsService, type ZaloFormsUpdateFormLeadNotificationIntervalRequest, type ZaloFormsUpdateFormLeadNotificationIntervalResponse, type ZaloInstantPageActive, ZaloInstantPageBlockType, type ZaloInstantPageStatus, type ZaloInstantPagesCloneInstantPageRequest, type ZaloInstantPagesCloneInstantPageResponse, type ZaloInstantPagesFormRecordItem, type ZaloInstantPagesGetInstantPageDetailRequest, type ZaloInstantPagesGetInstantPageDetailResponse, type ZaloInstantPagesGetInstantPageSharedUserRequest, type ZaloInstantPagesGetInstantPageSharedUserResponse, type ZaloInstantPagesListInstantPageEditHistoryRequest, type ZaloInstantPagesListInstantPageEditHistoryResponse, type ZaloInstantPagesListInstantPageFormRecordsRequest, type ZaloInstantPagesListInstantPageFormRecordsResponse, type ZaloInstantPagesListInstantPageLeadsRequest, type ZaloInstantPagesListInstantPageLeadsResponse, type ZaloInstantPagesListInstantPageSharesRequest, type ZaloInstantPagesListInstantPageSharesResponse, type ZaloInstantPagesListInstantPageUsersRequest, type ZaloInstantPagesListInstantPageUsersResponse, type ZaloInstantPagesListMiniPageTemplatesRequest, type ZaloInstantPagesListMiniPageTemplatesResponse, type ZaloInstantPagesListOfficialAccountsRequest, type ZaloInstantPagesListOfficialAccountsResponse, type ZaloInstantPagesOfficialAccountItem, type ZaloInstantPagesSearchInstantPagesRequest, type ZaloInstantPagesSearchInstantPagesResponse, ZaloInstantPagesService, type ZaloInstantPagesUpdateInstantPageRequest, type ZaloInstantPagesUpdateInstantPageResponse, type ZaloInstantPagesUpsertInstantPageFormRequest, type ZaloInstantPagesUpsertInstantPageFormResponse, ZaloInstantPagesValidator, type ZaloIntegrationCredentials, type ZaloIntegrationVerificationResult, ZaloMediaService, type ZaloPlaySessionPayload, type ZaloProfileAdsAdministrativeItem, type ZaloProfileAdsCreateOaPageRequest, type ZaloProfileAdsCreateOaPageResponse, type ZaloProfileAdsGetDistrictsRequest, type ZaloProfileAdsGetDistrictsResponse, type ZaloProfileAdsGetProvincesResponse, type ZaloProfileAdsProvinceId, ZaloProfileAdsService, type ZaloProfileAdsSubCategoryId, type ZaloProfileAdsUploadOaAvatarRequest, type ZaloProfileAdsUploadOaAvatarResponse, type ZaloProfileAdsUploadOaCoverRequest, type ZaloProfileAdsUploadOaCoverResponse, type ZaloRedisLikeClient, ZaloReportsService, type ZaloSdkAuth, type ZaloSdkAuthContext, ZaloSdkError, ZaloSdkHttpClient, type ZaloSessionStore, type ZaloSsoAuthOptions, type ZaloUploadAndSaveImageRequest, type ZaloUploadAndSaveImageResult, type ZaloUploadAndSaveVideoRequest, type ZaloUploadAndSaveVideoResult, type ZaloWidgetAPIGetOfficialAccountInfoRequest, type ZaloWidgetAPIGetOfficialAccountInfoResponse, type ZaloWidgetAPIGetWidgetUserProfileRequest, type ZaloWidgetAPIGetWidgetUserProfileResponse, type ZaloWidgetAPIListStickerCategoriesRequest, type ZaloWidgetAPIListStickerCategoriesResponse, type ZaloWidgetAPIListStickersByCategoryRequest, type ZaloWidgetAPIListStickersByCategoryResponse, ZaloWidgetApiService, computeZpsidFingerprint, createZaloSsoAuth, decodePlaySessionJwt, ZaloAdsSdk as default, defaultSharedMemorySessionStore, deriveAccountKeyFromZpsid, parseZaloCookieInput, validateCloneInstantPageRequest, validateGetInstantPageDetailRequest, validateGetInstantPageSharedUserRequest, validateListInstantPageEditHistoryRequest, validateListInstantPageFormRecordsRequest, validateListInstantPageLeadsRequest, validateListInstantPageSharesRequest, validateListInstantPageUsersRequest, validateListMiniPageTemplatesRequest, validateListOfficialAccountsRequest, validateSearchInstantPagesRequest, validateUpdateInstantPageRequest, validateUpsertInstantPageFormRequest };