@redonvn/zalo-ads-sdk 0.2.2 → 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. */
@@ -606,7 +662,7 @@ type ZaloInstantPagesFormRecordItem = {
         value: string;
     }>;
 };
-type ZaloInstantPagesListInstantPageFormRecordsResponse = {
+type ZaloInstantPagesListInstantPageFormRecordsResponse = Blob | {
     data: {
         items: Array<ZaloInstantPagesFormRecordItem>;
         total: number;
@@ -691,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. */
@@ -707,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;
@@ -721,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;
@@ -729,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 = {
@@ -821,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. */
@@ -2026,12 +2101,21 @@ interface ZaloAdsUniqueUserReportDataDto {
     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. Đâ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>;
+/** 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 = {
     code: number;
     msg?: string;
-    data: ZaloAdsUniqueUserReportDataDto;
+    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 = {
@@ -2053,15 +2137,27 @@ type ZaloAdsGetReportapiV3CampaignsResponse = {
     code: 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;
 };
 type ZaloAdsGetZaapiCampaignReportcampaignResponse = {
     code: number;
     msg?: string;
-    data?: ZaloAdsCampaignReportItemDto;
+    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 = {
@@ -2899,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 = {
@@ -2940,19 +3039,434 @@ 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;
+}>;
 
-/** Zalo Ads API service. Each API explicitly selects its own request transport. */
+/**
+ * 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;
+}
 
-declare class ZaloAdsService {
-    private readonly client;
+/**
+ * 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>;
-    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>;
@@ -2970,37 +3484,10 @@ declare class ZaloAdsService {
     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>;
-    getApiMediaItems(request: ZaloAdsGetApiMediaItemsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMediaItemsResponse>;
-    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>;
-    getApiWhoami(request?: ZaloAdsGetApiWhoamiRequest, options?: RequestOptions): Promise<ZaloAdsGetApiWhoamiResponse>;
-    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>;
-    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>;
@@ -3009,16 +3496,8 @@ declare class ZaloAdsService {
     getOwnedArticles(request: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
     getZaapiGetownedpages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
     getOwnedPages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
-    listAgencyCustomersWithBudget(request?: ZaloAdsListAgencyCustomersWithBudgetRequest, options?: RequestOptions): Promise<ZaloAdsListAgencyCustomersWithBudgetResponse>;
-    listCustomReports(request?: ZaloAdsListCustomReportsRequest, options?: RequestOptions): Promise<ZaloAdsListCustomReportsResponse>;
     listFormsByOfficialAccount(request: ZaloAdsListFormsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFormsByOfficialAccountResponse>;
     listMiniPagesByTemplate(request: ZaloAdsListMiniPagesByTemplateRequest, options?: RequestOptions): Promise<ZaloAdsListMiniPagesByTemplateResponse>;
-    listPersonalPixelLabels(request?: ZaloAdsListPersonalPixelLabelsRequest, options?: RequestOptions): Promise<ZaloAdsListPersonalPixelLabelsResponse>;
-    postApiAdEstimateaudience(request: ZaloAdsPostApiAdEstimateaudienceRequest, options?: RequestOptions): Promise<ZaloAdsPostApiAdEstimateaudienceResponse>;
-    postApiMediaSave(request: ZaloAdsPostApiMediaSaveRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMediaSaveResponse>;
-    postApiMemberUploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
-    /** Alias tiện lợi cho `postApiMemberUploadImage` (`POST /api/member/upload-image`). */
-    uploadImage(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>;
@@ -3033,9 +3512,371 @@ declare class ZaloAdsService {
     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"]>;
+}
+
+/**
+ * Dịch vụ Quản lý Quy tắc Tự động Zalo Ads (Automated Rules CRUD, Status, History).
+ */
+
+declare class ZaloAutomatedRulesService {
+    protected readonly client: ZaloSdkHttpClient;
+    constructor(client: ZaloSdkHttpClient);
+    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>;
+}
+
+/**
+ * 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>;
+    /**
+     * 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>;
+    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>;
+    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>;
+    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>;
+    /** 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>;
+    /**
+     * 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. */
@@ -3310,17 +4151,17 @@ type ZaloFormsListManagedFormsByOfficialAccountResponse = {
     /** Tổng số form khớp với OA và khoảng thời gian. */
     total: number;
 };
-/** 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 = {
@@ -3328,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;
@@ -3343,24 +4184,51 @@ 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;
+        /** 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;
 };
+/** 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 = {
     /** ID Official Account sở hữu Form; không thay bằng formId. */
@@ -3436,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>;
@@ -3771,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;
@@ -3931,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, 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 ZaloAdsConversionElementSelectorDto, type ZaloAdsConversionItemDto, 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 ZaloAdsCreateFormPayloadDto, 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, type ZaloAdsFileGroupItemDto, ZaloAdsFlowButtonDto, ZaloAdsFlowChildMessageDto, ZaloAdsFlowMessageDto, type ZaloAdsFormAnswerDto, 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 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 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, type ZaloAdsLpNewsButtonDto, type ZaloAdsLpNewsItemDto, type ZaloAdsMediaSavePayloadDto, type ZaloAdsMediaSaveSettingsDto, type ZaloAdsMemberFileItemDto, ZaloAdsMessageAdUpdateDataDto, type ZaloAdsNotifyHeaderItemDto, type ZaloAdsOwnedArticleItemDto, type ZaloAdsOwnedPageExtraInfoDto, type ZaloAdsOwnedPageItemDto, type ZaloAdsOwnedPageLocationDto, type ZaloAdsPageConfigDto, type ZaloAdsPaymentTransactionItemDto, 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 ZaloAuthDomain, ZaloAuthManager, type ZaloChatWidgetGetChatWidgetLoginConfigRequest, type ZaloChatWidgetGetChatWidgetLoginConfigResponse, type ZaloChatWidgetGetLoginConfigRequest, type ZaloChatWidgetGetLoginConfigResponse, ZaloChatWidgetService, type ZaloDomainSession, 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 ZaloFormsListSimpleFormsByOfficialAccountRequest, type ZaloFormsListSimpleFormsByOfficialAccountResponse, ZaloFormsService, type ZaloFormsUpdateFormLeadNotificationIntervalRequest, type ZaloFormsUpdateFormLeadNotificationIntervalResponse, 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, type ZaloIntegrationCredentials, type ZaloIntegrationVerificationResult, 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, 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 };