@redonvn/zalo-ads-sdk 0.1.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -429,7 +429,7 @@ interface ZaloAdsSdkOptions {
429
429
  auth?: ZaloSdkAuth;
430
430
  authByHost?: Record<string, ZaloSdkAuth>;
431
431
  fetch?: typeof fetch;
432
- baseUrls?: Partial<Record<"ads" | "forms" | "instantPages" | "widget" | "chatWidget", string>>;
432
+ baseUrls?: Partial<Record<"ads" | "forms" | "instantPages" | "profileAds" | "widget" | "chatWidget", string>>;
433
433
  }
434
434
  interface RequestOptions {
435
435
  signal?: AbortSignal;
@@ -577,7 +577,6 @@ type ZaloInstantPagesListInstantPageEditHistoryResponse = {
577
577
  created: number;
578
578
  /** Tên hiển thị của người dùng thực hiện thao tác. */
579
579
  userName: string;
580
- [key: string]: unknown;
581
580
  }>;
582
581
  metadata: {
583
582
  /** Giới hạn bản ghi của trang đã trả về. */
@@ -586,19 +585,32 @@ type ZaloInstantPagesListInstantPageEditHistoryResponse = {
586
585
  total: number;
587
586
  /** Vị trí bắt đầu của trang đã trả về. */
588
587
  offset: number;
589
- [key: string]: unknown;
590
588
  };
591
- [key: string]: unknown;
592
589
  };
593
- [key: string]: unknown;
594
590
  };
595
- /** Lấy danh sách bản ghi gửi form của một Instant Page. Đây là detail tool thuộc lane zalo-ads-content; dùng khi cần xem dữ liệu khách hàng đã gửi từ form gắn với trang cụ thể. Schema chi tiết từng bản ghi chưa được xác minh do chưa có response mẫu. */
591
+ /** Lấy danh sách bản ghi gửi form của một Instant Page. Đây là detail tool thuộc lane zalo-ads-content; dùng khi cần xem dữ liệu khách hàng đã gửi từ form gắn với trang cụ thể. */
596
592
  type ZaloInstantPagesListInstantPageFormRecordsRequest = {
597
593
  /** ID Instant Page có form cần lấy bản ghi gửi. */
598
594
  instantPageId: number;
599
595
  };
596
+ type ZaloInstantPagesFormRecordItem = {
597
+ id: string;
598
+ pageId: number;
599
+ userId?: string;
600
+ userName?: string;
601
+ phone?: string;
602
+ created: number;
603
+ answers: Array<{
604
+ questionId: string;
605
+ title: string;
606
+ value: string;
607
+ }>;
608
+ };
600
609
  type ZaloInstantPagesListInstantPageFormRecordsResponse = {
601
- [key: string]: unknown;
610
+ data: {
611
+ items: Array<ZaloInstantPagesFormRecordItem>;
612
+ total: number;
613
+ };
602
614
  };
603
615
  /** Lấy danh sách người dùng được chia sẻ quyền truy cập một Instant Page, gồm quyền trên trang và quyền Official Account. Đây là detail tool thuộc lane zalo-ads-content; dùng để kiểm tra quyền cộng tác trước khi chia sẻ, chỉnh sửa hoặc thu hồi quyền. Mỗi phần tử xác định người dùng bằng userId và thông tin hiển thị. */
604
616
  type ZaloInstantPagesListInstantPageSharesRequest = {
@@ -771,6 +783,99 @@ type ZaloInstantPagesListOfficialAccountsResponse = {
771
783
  data: ZaloInstantPagesOfficialAccountItem[];
772
784
  [key: string]: unknown;
773
785
  };
786
+ /** Cấu hình hoặc cập nhật biểu mẫu thu thập thông tin và đặt hàng gắn liền với một Instant Page, bao gồm danh sách câu hỏi, lựa chọn trả lời và điều khoản bảo vệ dữ liệu cá nhân. Đây là mutation tool thuộc lane zalo-ads-content. Dùng khi đã có instantPageId cùng oaId và cần lưu cấu trúc câu hỏi biểu mẫu trước khi gắn ID câu hỏi vào block nội dung của Instant Page. */
787
+ type ZaloInstantPagesUpsertInstantPageFormRequest = {
788
+ /** ID nội bộ của Instant Page cần cấu hình biểu mẫu (lấy từ công cụ tìm kiếm, chi tiết hoặc sao chép Instant Page). */
789
+ instantPageId: number;
790
+ /** ID Zalo Official Account liên kết với biểu mẫu của Instant Page (chuỗi số định danh dài). */
791
+ oaId: string;
792
+ /** Tên biểu mẫu gắn với Instant Page (ví dụ: 'Trang sản phẩm - 14/10/2026 18:51'). */
793
+ formName: string;
794
+ /** Danh sách các câu hỏi và trường thông tin trong biểu mẫu của Instant Page. */
795
+ questions: Array<{
796
+ /** Mã định danh câu hỏi (tùy chọn khi cập nhật câu hỏi đã tồn tại). */
797
+ id?: string;
798
+ /** Loại câu hỏi: 1 là câu hỏi nhập liệu (số lượng, họ tên, số điện thoại, địa chỉ), 2 là câu hỏi lựa chọn phương án (phiên bản, kích thước, combo). */
799
+ type: 1 | 2 | number;
800
+ /** Tiêu đề câu hỏi hiển thị trên biểu mẫu. */
801
+ title: string;
802
+ /** Danh sách các phương án lựa chọn hoặc cấu hình ô nhập liệu của câu hỏi. */
803
+ answers: Array<{
804
+ /** Mã định danh phương án trả lời (tùy chọn khi cập nhật phương án đã tồn tại). */
805
+ id?: string;
806
+ /** Loại ô trả lời: 1 là lựa chọn cố định (option), 5 là số lượng, 7 là họ và tên, 13 là số điện thoại, 15 là địa chỉ. */
807
+ type: 1 | 5 | 7 | 13 | 15 | number;
808
+ /** Giá trị phương án trả lời (dùng cho câu hỏi lựa chọn type=2, để chuỗi rỗng với ô nhập liệu). */
809
+ value?: string;
810
+ /** Thứ tự ưu tiên của phương án trả lời (bắt đầu từ 0). */
811
+ priority: number;
812
+ /** Văn bản gợi ý trong ô nhập liệu (dùng cho họ tên, số điện thoại, địa chỉ). */
813
+ placeHolder?: string;
814
+ }>;
815
+ /** Trạng thái vô hiệu hóa câu hỏi (false là đang kích hoạt). */
816
+ disable: boolean;
817
+ /** Thứ tự ưu tiên hiển thị của câu hỏi (bắt đầu từ 0). */
818
+ priority: number;
819
+ /** Bắt buộc người dùng trả lời câu hỏi này hay không. */
820
+ isRequired: boolean;
821
+ /** Mô tả phụ của câu hỏi (có thể để chuỗi rỗng). */
822
+ description: string;
823
+ }>;
824
+ /** Sử dụng cấu hình điều khoản đồng ý tùy chỉnh hay mặc định. */
825
+ useCustomConsent: boolean;
826
+ /** 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. */
827
+ consentConfig: {
828
+ /** Địa chỉ liên hệ của bên kiểm soát hoặc sở hữu dữ liệu. */
829
+ address: string;
830
+ /** Tên cá nhân hoặc đơn vị sở hữu dữ liệu. */
831
+ ownerName: string;
832
+ /** Email liên hệ của bên kiểm soát hoặc sở hữu dữ liệu. */
833
+ ownerEmail: string;
834
+ /** Số điện thoại liên hệ của bên sở hữu dữ liệu (ví dụ: '84977682707'). */
835
+ ownerPhone: string;
836
+ /** Danh sách mã loại dữ liệu cá nhân cơ bản thu thập (ví dụ: [0,1,2,3,4,5]). */
837
+ regularDataTypes: Array<number>;
838
+ /** Danh sách mã mục đích xử lý dữ liệu (ví dụ: [0,1,2,3]). */
839
+ dataUsagePurposes: Array<number>;
840
+ /** Danh sách mã loại dữ liệu cá nhân nhạy cảm thu thập (ví dụ: [0,1]). */
841
+ sensitiveDataTypes: Array<number>;
842
+ };
843
+ };
844
+ type ZaloInstantPagesUpsertInstantPageFormResponse = {
845
+ /** Danh sách câu hỏi và phương án trả lời của biểu mẫu Instant Page sau khi đã lưu kèm mã định danh (id) do hệ thống sinh ra. */
846
+ data: Array<{
847
+ /** Mã định danh câu hỏi do hệ thống sinh ra (ví dụ: '6VUZYGPQ66KYVG796M'), dùng để gắn vào cấu hình block form của Instant Page. */
848
+ id: string;
849
+ /** Loại câu hỏi (1: nhập liệu, 2: lựa chọn). */
850
+ type: number;
851
+ /** Tiêu đề câu hỏi. */
852
+ title: string;
853
+ /** Danh sách phương án trả lời hoặc ô nhập liệu của câu hỏi. */
854
+ answers: Array<{
855
+ /** Mã định danh phương án trả lời do hệ thống sinh ra (ví dụ: 'ERUR9ZVA9ZAQ8RQEQ'). */
856
+ id: string;
857
+ /** Loại ô trả lời (1: lựa chọn, 5: số lượng, 7: họ tên, 13: số điện thoại, 15: địa chỉ). */
858
+ type: number;
859
+ /** Giá trị của phương án lựa chọn. */
860
+ value?: string;
861
+ /** Thứ tự hiển thị của phương án trả lời (bắt đầu từ 0). */
862
+ priority: number;
863
+ /** Văn bản gợi ý hiển thị trong ô nhập liệu. */
864
+ placeHolder?: string;
865
+ [key: string]: unknown;
866
+ }>;
867
+ /** Trạng thái vô hiệu hóa câu hỏi. */
868
+ disable: boolean;
869
+ /** Thứ tự hiển thị của câu hỏi trên biểu mẫu. */
870
+ priority: number;
871
+ /** Cờ bắt buộc trả lời câu hỏi. */
872
+ isRequired: boolean;
873
+ /** Mô tả phụ của câu hỏi. */
874
+ description: string;
875
+ [key: string]: unknown;
876
+ }>;
877
+ [key: string]: unknown;
878
+ };
774
879
 
775
880
  type BodyType = "json" | "urlencoded" | "multipart" | "none";
776
881
  interface OperationDefinition {
@@ -820,22 +925,26 @@ declare class ZaloAdsFlowChildMessageDto {
820
925
  }
821
926
  /** Nút hành động trong một tin nhắn kịch bản. */
822
927
  declare class ZaloAdsFlowButtonDto {
823
- /** 3: mở nhánh tin nhắn; 12: gọi hotline. */
824
- type: 3 | 12;
928
+ /** 3 = Gửi tin nhắn vào nhánh hội thoại; 10 = Mở website; 12 = Thực hiện cuộc gọi. */
929
+ type: 3 | 10 | 12 | number;
825
930
  /** Nhãn nút hiển thị cho người dùng. */
826
931
  text: string;
932
+ /** URL website; bắt buộc với type 10. */
933
+ url?: string;
934
+ /** Cờ của nút website; dùng true với type 10. */
935
+ editable?: boolean;
827
936
  /** Số hotline, bắt buộc khi type là 12. */
828
937
  phone?: string;
829
- /** Nhánh tin nhắn, bắt buộc khi type là 3. */
830
- messages?: ZaloAdsFlowChildMessageDto[];
938
+ /** Nhánh tin nhắn, bắt buộc khi type là 3. Với type 10 hoặc 12, để null hoặc bỏ qua. */
939
+ messages?: ZaloAdsFlowChildMessageDto[] | null;
831
940
  }
832
941
  /** Một bước tin nhắn trong kịch bản. */
833
942
  declare class ZaloAdsFlowMessageDto {
834
- /** Mẫu đã xác minh dùng 1 cho tin nhắn văn bản chính. */
943
+ /** 1 = Tin nhắn văn bản; 2 = Tin nhắn kèm hình ảnh. */
835
944
  type: number;
836
- /** Nội dung tin nhắn; có thể dùng biến {{user_name}}. */
945
+ /** Nội dung tin nhắn, tối đa 1961 ký tự. Hỗ trợ biến: {{user_name}}, {{page_name}}, {{user_gender}}, {{user_id}}, {{page_id}}, {{date}}, {{datetime}}. */
837
946
  text: string;
838
- /** URL media hoặc null với tin nhắn văn bản thuần. */
947
+ /** URL media hoặc null với tin nhắn văn bản thuần. Bắt buộc và không được null khi type = 2. */
839
948
  url?: string | null;
840
949
  /** Các nút đi kèm tin nhắn. */
841
950
  buttons?: ZaloAdsFlowButtonDto[];
@@ -859,55 +968,207 @@ declare class ZaloAdsCreateFlowResponse {
859
968
  id: number;
860
969
  };
861
970
  }
971
+ /** Cập nhật kịch bản tin nhắn có sẵn của Official Account, gồm tin nhắn văn bản hoặc ảnh, các biến động và nút tương tác. Đây là mutation tool thuộc lane zalo-ads-message; dùng khi đã có Flow ID và cần thay đổi nội dung mà vẫn giữ liên kết quảng cáo. */
972
+ type ZaloAdsUpdateFlowRequest = {
973
+ /** ID Flow cần cập nhật. */
974
+ id: number;
975
+ /** Tên kịch bản; giao diện hiện giới hạn tối đa 27 ký tự. */
976
+ name: string;
977
+ /** ID Official Account sở hữu kịch bản. */
978
+ oaId: number;
979
+ /** Chuỗi tin nhắn của kịch bản. */
980
+ messages: ZaloAdsFlowMessageDto[];
981
+ };
982
+ type ZaloAdsUpdateFlowResponse = {
983
+ code: number;
984
+ msg?: string;
985
+ data?: {
986
+ id?: number;
987
+ };
988
+ };
989
+ interface ZaloAdsAdPriceSettingsDto {
990
+ Bid: number;
991
+ Type: number;
992
+ Limit: number;
993
+ LimitType: number;
994
+ SpendingMethod: number;
995
+ }
996
+ interface ZaloAdsAdMultiImageItemDto {
997
+ Url: string;
998
+ Title?: string;
999
+ Description?: string;
1000
+ TargetUrl?: string;
1001
+ }
1002
+ interface ZaloAdsAdImageSettingsDto {
1003
+ LogoUrl?: string;
1004
+ LandscapeCoverUrl?: string;
1005
+ SquareCoverUrl?: string;
1006
+ VideoUrl?: string;
1007
+ VideoDuration?: number;
1008
+ MediaId?: number;
1009
+ MultiImages?: Array<ZaloAdsAdMultiImageItemDto>;
1010
+ }
1011
+ interface ZaloAdsAdInfoSettingsDto {
1012
+ Title?: string;
1013
+ Description?: string;
1014
+ Caption?: string;
1015
+ Action?: number;
1016
+ ButtonText?: string;
1017
+ MoreInfo?: string;
1018
+ TargetUrl?: string;
1019
+ Phone?: string;
1020
+ Address?: string;
1021
+ }
1022
+ interface ZaloAdsAdAppInfoSettingsDto {
1023
+ AppType?: number;
1024
+ OsType?: number;
1025
+ StoreUrl?: string;
1026
+ }
1027
+ interface ZaloAdsAdTargetingSettingsDto {
1028
+ Gender?: number;
1029
+ AgeRanges?: Array<number>;
1030
+ Locations?: string;
1031
+ Provinces?: Array<number>;
1032
+ DistrictsTargeting?: string;
1033
+ WardsTargeting?: string;
1034
+ Platforms?: Array<number>;
1035
+ NetworkTypes?: Array<number>;
1036
+ OsTypes?: Array<number>;
1037
+ AdvanceTargetings?: Array<number>;
1038
+ CustomAudiences?: Array<number>;
1039
+ ExcludeCustomAudiences?: Array<number>;
1040
+ }
1041
+ interface ZaloAdsAdZVideoSettingsDto {
1042
+ Url: string;
1043
+ Duration: number;
1044
+ Src: number;
1045
+ Thumbnail: string;
1046
+ Description: string;
1047
+ ChannelName: string;
1048
+ ChannelAvt: string;
1049
+ VideoThumbnail: string;
1050
+ ThumbnailIndex: number | null;
1051
+ }
1052
+ interface ZaloAdsAdSettingsDto {
1053
+ Image: ZaloAdsAdImageSettingsDto;
1054
+ Price: ZaloAdsAdPriceSettingsDto;
1055
+ AdInfo: ZaloAdsAdInfoSettingsDto;
1056
+ AppInfo?: ZaloAdsAdAppInfoSettingsDto;
1057
+ Targeting: ZaloAdsAdTargetingSettingsDto;
1058
+ ZVideo?: ZaloAdsAdZVideoSettingsDto;
1059
+ VideoPlatform?: number;
1060
+ Rating?: number;
1061
+ NewFeatures?: Array<number>;
1062
+ CreatedClientVersion?: number;
1063
+ }
1064
+ interface ZaloAdsAdUpdatePayloadDto {
1065
+ AdId: number;
1066
+ CampaignId: number;
1067
+ MemberId: number;
1068
+ RowVersion: number;
1069
+ AdName: string;
1070
+ Type: number;
1071
+ Settings: ZaloAdsAdSettingsDto;
1072
+ Status: number;
1073
+ StartDate: number;
1074
+ EndDate: number;
1075
+ ZaloFlowId?: number;
1076
+ ZaloPageId?: number;
1077
+ ZaloFormId?: string;
1078
+ ZaloFeedId?: string | number;
1079
+ MiniPageId?: number;
1080
+ UseConversion?: 0 | 1;
1081
+ ConversionId?: number;
1082
+ Report?: Record<string, number>;
1083
+ }
1084
+ interface ZaloAdsAdMutationResultDto {
1085
+ AdId?: number;
1086
+ CampaignId?: number;
1087
+ Status?: number;
1088
+ RowVersion?: number;
1089
+ }
1090
+ interface ZaloAdsCampaignCreatePayloadDto {
1091
+ name: string;
1092
+ campaignType: number;
1093
+ pageId: number;
1094
+ productId: number;
1095
+ targetUrl?: string;
1096
+ articleId?: number;
1097
+ adtype: number;
1098
+ budgetType: number;
1099
+ budgetlimit: number;
1100
+ limitType: number;
1101
+ campaignObjective: number;
1102
+ campaignId: number;
1103
+ adId: number;
1104
+ }
1105
+ interface ZaloAdsFormSectionTableItemDto {
1106
+ key: string;
1107
+ value: string;
1108
+ }
1109
+ interface ZaloAdsFormSectionImageItemDto {
1110
+ url: string;
1111
+ title?: string;
1112
+ caption?: string;
1113
+ }
1114
+ interface ZaloAdsFormSectionContentDto {
1115
+ title?: string;
1116
+ description?: string;
1117
+ table?: Array<ZaloAdsFormSectionTableItemDto>;
1118
+ images?: Array<ZaloAdsFormSectionImageItemDto>;
1119
+ }
1120
+ interface ZaloAdsFormSectionDto {
1121
+ type: "0" | "1" | "2" | "3" | "4" | number;
1122
+ title: string;
1123
+ expand: boolean;
1124
+ disable: boolean;
1125
+ content: ZaloAdsFormSectionContentDto;
1126
+ }
1127
+ interface ZaloAdsFormQuestionUiDto {
1128
+ icon?: string;
1129
+ title?: string;
1130
+ removable?: boolean;
1131
+ }
1132
+ interface ZaloAdsFormAnswerDto {
1133
+ id?: string;
1134
+ type: "2" | "7" | "13" | number;
1135
+ value?: string | null;
1136
+ priority?: number;
1137
+ placeHolder?: string;
1138
+ }
1139
+ interface ZaloAdsFormQuestionDto {
1140
+ id?: string;
1141
+ ui?: ZaloAdsFormQuestionUiDto;
1142
+ type: "1" | number;
1143
+ title: string;
1144
+ answers: Array<ZaloAdsFormAnswerDto>;
1145
+ groupIdx?: number;
1146
+ priority?: number;
1147
+ isRequired: boolean;
1148
+ editDisabled?: boolean;
1149
+ }
1150
+ interface ZaloAdsCreateFormPayloadDto {
1151
+ id?: string;
1152
+ oaId: string;
1153
+ formName: string;
1154
+ title?: string;
1155
+ description?: string;
1156
+ coverPhoto?: string;
1157
+ thanks?: string;
1158
+ gotoText?: string;
1159
+ gotoActionType?: number;
1160
+ website?: string;
1161
+ phone?: string;
1162
+ submitTitle?: string;
1163
+ reviewSubmit?: boolean;
1164
+ oaConsentWidget?: boolean;
1165
+ useCustomConsent?: boolean;
1166
+ sections?: Array<ZaloAdsFormSectionDto>;
1167
+ questions: Array<ZaloAdsFormQuestionDto>;
1168
+ }
862
1169
  /** Cập nhật quảng cáo Video; service tự JSON.stringify data rồi gửi form-urlencoded. */
863
1170
  declare class ZaloAdsUpdateVideoAdRequest {
864
- data: {
865
- AdId: number;
866
- CampaignId: number;
867
- MemberId: number;
868
- RowVersion: number;
869
- AdName: string;
870
- /** 11 = Quảng cáo Video. */
871
- Type: 11;
872
- Settings: {
873
- Image: {
874
- LogoUrl: string;
875
- LandscapeCoverUrl: string;
876
- VideoUrl: string;
877
- VideoDuration: number;
878
- [key: string]: unknown;
879
- };
880
- Price: {
881
- Bid: number;
882
- Type: 1;
883
- Limit: number;
884
- LimitType: 1;
885
- SpendingMethod: 0;
886
- };
887
- AdInfo: Record<string, unknown>;
888
- AppInfo: Record<string, unknown>;
889
- Targeting: Record<string, unknown>;
890
- ZVideo: {
891
- Url: string;
892
- Duration: number;
893
- Src: 2;
894
- Thumbnail: string;
895
- Description: string;
896
- ChannelName: string;
897
- ChannelAvt: string;
898
- VideoThumbnail: string;
899
- ThumbnailIndex: number | null;
900
- };
901
- VideoPlatform: 1;
902
- [key: string]: unknown;
903
- };
904
- Status: number;
905
- StartDate: number;
906
- EndDate: number;
907
- ZaloFlowId: number;
908
- UseConversion: 0 | 1;
909
- [key: string]: unknown;
910
- };
1171
+ data: ZaloAdsAdUpdatePayloadDto | string;
911
1172
  est?: string;
912
1173
  isBoostAd?: 0 | 1;
913
1174
  stt?: number;
@@ -915,7 +1176,7 @@ declare class ZaloAdsUpdateVideoAdRequest {
915
1176
  declare class ZaloAdsUpdateVideoAdResponse {
916
1177
  code: number;
917
1178
  msg: string;
918
- data?: unknown;
1179
+ data?: ZaloAdsAdMutationResultDto;
919
1180
  }
920
1181
  /** Lấy danh sách hoặc Flow cụ thể của một Official Account. Dùng flowId khi cần đọc một Flow trước khi cập nhật, hoặc offset và limit khi duyệt danh sách. */
921
1182
  type ZaloAdsListFlowsByOfficialAccountRequest = {
@@ -946,20 +1207,20 @@ type ZaloAdsListFlowsByOfficialAccountResponse = {
946
1207
  text: string;
947
1208
  editable: boolean;
948
1209
  url: string;
949
- messages: Array<unknown>;
1210
+ messages: Array<ZaloAdsFlowChildMessageDto>;
1211
+ }>;
1212
+ elements: Array<{
1213
+ type?: number;
1214
+ title?: string;
1215
+ url?: string;
950
1216
  }>;
951
- elements: Array<unknown>;
952
1217
  stepId: number;
953
- [key: string]: unknown;
954
1218
  }>;
955
- [key: string]: unknown;
956
1219
  }>;
957
1220
  extend: {
958
1221
  total: number;
959
1222
  index?: number;
960
- [key: string]: unknown;
961
1223
  };
962
- [key: string]: unknown;
963
1224
  };
964
1225
  /** Thay đổi trạng thái của một chiến dịch Zalo Ads theo mã trạng thái được chỉ định. Đây là destructive mutation tool thuộc lane quản lý chiến dịch; dùng khi cần dừng, hủy hoặc chuyển trạng thái chiến dịch và phải xác minh rõ mã trạng thái trước khi gọi. Giá trị -2 trong request đã ghi nhận sẽ xóa chiến dịch. */
965
1226
  type ZaloAdsChangeCampaignStatusRequest = {
@@ -1017,7 +1278,7 @@ type ZaloAdsCreateCustomAudienceResponse = {
1017
1278
  /** Tạo chiến dịch quảng cáo E-commerce (Commerce) trên Zalo Ads (campaignType = 9). Service tự JSON.stringify nếu truyền object. */
1018
1279
  type ZaloAdsCreateEcommerceCampaignRequest = {
1019
1280
  /** Cấu hình chiến dịch Commerce (object hoặc chuỗi JSON): { name, campaignType: 9, pageId, productId, targetUrl, adtype: -1, budgetType: 1, budgetlimit, limitType: 2, campaignObjective: 0, campaignId: 0, adId: 0 }. */
1020
- data: Record<string, unknown> | string;
1281
+ data: ZaloAdsCampaignCreatePayloadDto | string;
1021
1282
  };
1022
1283
  type ZaloAdsCreateEcommerceCampaignResponse = {
1023
1284
  msg: string;
@@ -1030,8 +1291,8 @@ type ZaloAdsCreateEcommerceCampaignResponse = {
1030
1291
  };
1031
1292
  /** Tạo form gắn Official Account, câu hỏi thu thập thông tin, nội dung section và màn hình cảm ơn. Đây là thao tác mutation; form mới sẽ xuất hiện trong danh sách biểu mẫu của OA. */
1032
1293
  type ZaloAdsCreateFormRequest = {
1033
- /** Chuỗi JSON.stringify(CreateFormPayload), sau đó form-url-encode. Đây là field form duy nhất đã capture. */
1034
- data: string | Record<string, unknown>;
1294
+ /** Cấu hình biểu mẫu thu thập thông tin khách hàng hoặc chuỗi JSON.stringify(CreateFormPayload). */
1295
+ data: ZaloAdsCreateFormPayloadDto | string;
1035
1296
  };
1036
1297
  type ZaloAdsCreateFormResponse = {
1037
1298
  code: "0" | 0;
@@ -1045,57 +1306,8 @@ type ZaloAdsCreateFormResponse = {
1045
1306
  /** Unix epoch giây. */
1046
1307
  createAt: number;
1047
1308
  formName: string;
1048
- sections: Array<{
1049
- /** 0=tổng quan; 1=thông tin chi tiết; 2=bảng; 3=ưu điểm; 4=ưu đãi. */
1050
- type: "0" | "1" | "2" | "3" | "4";
1051
- title: string;
1052
- /** Mở rộng section khi hiển thị. */
1053
- expand: boolean;
1054
- content: {
1055
- table?: Array<{
1056
- key: string;
1057
- value: string;
1058
- }>;
1059
- title?: string;
1060
- images?: Array<{
1061
- url: string;
1062
- title?: string;
1063
- caption?: string;
1064
- }>;
1065
- videos?: Array<Record<string, never>>;
1066
- description?: string;
1067
- };
1068
- /** Ẩn/vô hiệu section. */
1069
- disable: boolean;
1070
- }>;
1071
- questions: Array<{
1072
- /** ID câu hỏi. Không cần khi tạo thông thường; được backend trả về và được gửi lại khi chỉnh sửa/logic. */
1073
- id?: string;
1074
- ui?: {
1075
- icon?: string;
1076
- title?: string;
1077
- removable?: boolean;
1078
- };
1079
- /** Loại câu hỏi đã capture. */
1080
- type: "1";
1081
- /** Nhãn câu hỏi. UI báo lỗi ngoài khoảng 2–180 ký tự. */
1082
- title: string;
1083
- answers: Array<{
1084
- /** ID đáp án do backend cấp. Chỉ cần gửi khi dùng logic câu hỏi/chỉnh sửa; tạo mới thông thường có thể không có. */
1085
- id?: string;
1086
- /** 2=số điện thoại phụ; 7=họ tên; 13=số điện thoại chuẩn. */
1087
- type: "2" | "7" | "13";
1088
- /** Request mẫu gửi null cho đáp án chuẩn; không thấy ở số điện thoại phụ. */
1089
- value?: string | null;
1090
- /** Placeholder do backend trả về sau khi tạo. */
1091
- placeHolder?: string;
1092
- }>;
1093
- /** Chỉ số trang của câu hỏi trong form nhiều trang, bắt đầu từ 0. Không gửi field này trong form một trang. */
1094
- groupIdx?: number;
1095
- isRequired: boolean;
1096
- /** Khóa việc sửa câu hỏi chuẩn. */
1097
- editDisabled?: boolean;
1098
- }>;
1309
+ sections: Array<ZaloAdsFormSectionDto>;
1310
+ questions: Array<ZaloAdsFormQuestionDto>;
1099
1311
  /** Unix epoch giây. */
1100
1312
  updatedAt: number;
1101
1313
  description?: string;
@@ -1104,7 +1316,7 @@ type ZaloAdsCreateFormResponse = {
1104
1316
  /** Tạo chiến dịch quảng cáo biểu mẫu (Form) trên Zalo Ads (campaignType = 8). Service tự JSON.stringify nếu truyền object. */
1105
1317
  type ZaloAdsCreateFormCampaignRequest = {
1106
1318
  /** Cấu hình chiến dịch biểu mẫu (object hoặc chuỗi JSON). */
1107
- data: Record<string, unknown> | string;
1319
+ data: ZaloAdsCampaignCreatePayloadDto | string;
1108
1320
  };
1109
1321
  type ZaloAdsCreateFormCampaignResponse = {
1110
1322
  msg: string;
@@ -1117,7 +1329,7 @@ type ZaloAdsCreateFormCampaignResponse = {
1117
1329
  /** Tạo chiến dịch quảng cáo Tin nhắn trên Zalo Ads (campaignType = 10). Service tự JSON.stringify nếu truyền object. */
1118
1330
  type ZaloAdsCreateMessageCampaignRequest = {
1119
1331
  /** Cấu hình chiến dịch Tin nhắn (object hoặc chuỗi JSON). */
1120
- data: Record<string, unknown> | string;
1332
+ data: ZaloAdsCampaignCreatePayloadDto | string;
1121
1333
  };
1122
1334
  type ZaloAdsCreateMessageCampaignResponse = {
1123
1335
  code?: number;
@@ -1133,7 +1345,7 @@ type ZaloAdsCreateMessageCampaignResponse = {
1133
1345
  /** Tạo chiến dịch quảng cáo Zalo Official Account (campaignType = 2). Service tự JSON.stringify nếu truyền object. */
1134
1346
  type ZaloAdsCreateOfficialAccountCampaignRequest = {
1135
1347
  /** Cấu hình chiến dịch Official Account (object hoặc chuỗi JSON). */
1136
- data: Record<string, unknown> | string;
1348
+ data: ZaloAdsCampaignCreatePayloadDto | string;
1137
1349
  };
1138
1350
  type ZaloAdsCreateOfficialAccountCampaignResponse = {
1139
1351
  msg: string;
@@ -1147,27 +1359,7 @@ type ZaloAdsCreateOfficialAccountCampaignResponse = {
1147
1359
  /** Tạo chiến dịch quảng cáo Bài viết trên Zalo Ads (campaignType = 4). Service tự JSON.stringify payload này vào field form data. */
1148
1360
  declare class ZaloAdsCreatePostCampaignRequest {
1149
1361
  /** Cấu hình chiến dịch Bài viết (object hoặc chuỗi JSON). */
1150
- data: {
1151
- name: string;
1152
- /** 4 = Quảng cáo Bài viết. */
1153
- campaignType: 4;
1154
- /** ID Official Account/trang chứa bài viết. */
1155
- pageId: number;
1156
- /** Mẫu Bài viết dùng -1. */
1157
- productId: -1;
1158
- /** ID bài viết Zalo cần quảng cáo. */
1159
- articleId: number;
1160
- adtype: -1;
1161
- budgetType: number;
1162
- budgetlimit: number;
1163
- limitType: number;
1164
- campaignObjective: number;
1165
- /** Đặt 0 để tạo chiến dịch mới. */
1166
- campaignId: 0;
1167
- /** Đặt 0 để tạo quảng cáo mới. */
1168
- adId: 0;
1169
- [key: string]: unknown;
1170
- } | string;
1362
+ data: ZaloAdsCampaignCreatePayloadDto | string;
1171
1363
  }
1172
1364
  declare class ZaloAdsCreatePostCampaignResponse {
1173
1365
  code: number;
@@ -1178,6 +1370,43 @@ declare class ZaloAdsCreatePostCampaignResponse {
1178
1370
  campaignId: number;
1179
1371
  };
1180
1372
  }
1373
+ interface ZaloAdsConversionElementSelectorDto {
1374
+ class?: Array<string>;
1375
+ id?: string;
1376
+ tag?: string;
1377
+ }
1378
+ /** Tạo conversion để đo lường hành động trên trang đích Zalo Ads. Đây là mutation tool thuộc lane zalo-ads-conversion; dùng sau khi đã xác định nhãn conversion, URL trang đích và quy tắc sự kiện click hoặc URL. Chỉ gọi khi cần tạo mới vì mỗi lần gọi sẽ phát sinh một conversion trong tài khoản quảng cáo. */
1379
+ type ZaloAdsCreateConversionRequest = {
1380
+ /** Tên conversion, phải duy nhất trong tài khoản quảng cáo (2–180 ký tự). */
1381
+ name: string;
1382
+ /** Nhãn conversion: 10 khách hàng tiềm năng, 11 mua hàng, 5 liên hệ, 4 đăng ký, 9 bắt đầu thanh toán, 2 thêm giỏ hàng, 19 khác. */
1383
+ labelId: 2 | 4 | 5 | 9 | 10 | 11 | 19 | number;
1384
+ /** Kiểu khớp URL: 1 hoặc 2. */
1385
+ urlType: 1 | 2 | number;
1386
+ /** Bộ chọn phần tử click; ví dụ [{"class":["btn"]}]. Dùng mảng rỗng khi không áp dụng. */
1387
+ elements: Array<ZaloAdsConversionElementSelectorDto>;
1388
+ /** Từ khóa URL cần ghi nhận; dùng mảng rỗng khi không áp dụng. */
1389
+ keywords: Array<string>;
1390
+ /** Danh sách ID nút theo cấu hình click; dùng mảng rỗng khi không áp dụng. */
1391
+ buttonIds: Array<string>;
1392
+ /** URL trang đích có Zalo Pixel. */
1393
+ landingPage: string;
1394
+ };
1395
+ interface ZaloAdsConversionItemDto {
1396
+ conversionId: number;
1397
+ name: string;
1398
+ labelId: number;
1399
+ urlType?: number;
1400
+ landingPage?: string;
1401
+ status?: number;
1402
+ created?: number;
1403
+ memberId?: number;
1404
+ }
1405
+ type ZaloAdsCreateConversionResponse = {
1406
+ code: number;
1407
+ msg?: string;
1408
+ data?: ZaloAdsConversionItemDto | number;
1409
+ };
1181
1410
  /** Xóa một conversion đã cấu hình trên Zalo Ads. Đây là destructive tool thuộc lane zalo-ads-conversion; chỉ dùng sau khi đối chiếu ID từ danh sách conversion và xác nhận cần dừng ghi nhận dữ liệu mới. Không dùng để tạm dừng hoặc chỉnh sửa conversion vì thao tác không thể khôi phục. */
1182
1411
  type ZaloAdsDeleteConversionRequest = {
1183
1412
  /** ID conversion cần xóa, lấy từ ZaloAds_getApiConversionAll hoặc trang chi tiết conversion. Thao tác không thể khôi phục. */
@@ -1187,8 +1416,7 @@ type ZaloAdsDeleteConversionResponse = {
1187
1416
  /** Thông báo trạng thái từ Zalo Ads. */
1188
1417
  msg: string;
1189
1418
  /** Mã thành công đã capture: 0. */
1190
- code: 0;
1191
- [key: string]: unknown;
1419
+ code: 0 | number;
1192
1420
  };
1193
1421
  /** Xóa một audience tùy chỉnh theo ID trên Zalo Ads. Đây là destructive tool thuộc lane zalo-ads-audience; chỉ dùng sau khi xác nhận đúng audience và hệ quả không thể hoàn tác. Dùng CustomAudienceId từ tool danh sách hoặc tạo audience. */
1194
1422
  type ZaloAdsDeleteCustomAudienceRequest = {
@@ -1202,9 +1430,32 @@ type ZaloAdsDeleteCustomAudienceResponse = {
1202
1430
  code: number;
1203
1431
  };
1204
1432
  /** Lấy chi tiết một quảng cáo theo ID. Đây là detail tool thuộc lane zalo-ads-ad; dùng khi cần payload hiện tại trước khi phân tích hoặc cập nhật quảng cáo. */
1205
- type ZaloAdsGetAdByIdRequest = Record<string, never>;
1433
+ type ZaloAdsGetAdByIdRequest = {
1434
+ /** ID mẫu quảng cáo cần lấy chi tiết (query param `adId`). */
1435
+ adId?: number | string;
1436
+ };
1206
1437
  type ZaloAdsGetAdByIdResponse = {
1207
- [key: string]: unknown;
1438
+ code?: number;
1439
+ msg?: string;
1440
+ data?: ZaloAdsAdUpdatePayloadDto;
1441
+ AdId?: number;
1442
+ CampaignId?: number;
1443
+ MemberId?: number;
1444
+ RowVersion?: number;
1445
+ AdName?: string;
1446
+ Type?: number;
1447
+ Settings?: ZaloAdsAdSettingsDto;
1448
+ Status?: number;
1449
+ StartDate?: number;
1450
+ EndDate?: number;
1451
+ ZaloFlowId?: number;
1452
+ ZaloPageId?: number;
1453
+ ZaloFormId?: string;
1454
+ ZaloFeedId?: string | number;
1455
+ MiniPageId?: number;
1456
+ UseConversion?: 0 | 1;
1457
+ ConversionId?: number;
1458
+ Report?: Record<string, number>;
1208
1459
  };
1209
1460
  /** Lấy lịch sử thao tác và các hạng mục thay đổi của một quảng cáo Zalo Ads. Đây là detail tool thuộc lane quản lý quảng cáo; dùng để kiểm tra ai đã tạo hoặc điều chỉnh nội dung, đối tượng, hình/video và conversion. Mỗi bản ghi nêu người thực hiện, thời điểm và danh sách thay đổi chính hoặc bổ sung. */
1210
1461
  type ZaloAdsGetAdChangeLogRequest = {
@@ -1250,25 +1501,96 @@ type ZaloAdsGetApiAdGetlistadadvancetargetingResponse = {
1250
1501
  displayName: string;
1251
1502
  }>;
1252
1503
  };
1253
- /** Lấy danh sách tài khoản hoặc thành viên được phép truy cập tài khoản quảng cáo hiện tại. Đây là entry tool thuộc lane zalo-ads-account; dùng khi cần xác định người có quyền vận hành tài khoản. */
1254
- type ZaloAdsGetApiBaAccountAllaccessorsRequest = Record<string, never>;
1504
+ interface ZaloAdsAccessorItemDto {
1505
+ /** ID định danh của thành viên trên Zalo Ads (ví dụ: 257887336). */
1506
+ memberId: number;
1507
+ /** Tên hiển thị của thành viên. */
1508
+ memberName: string;
1509
+ /** Số điện thoại của thành viên (định dạng 84...). */
1510
+ memberPhone?: string;
1511
+ /** URL ảnh đại diện của thành viên. */
1512
+ memberAvatar?: string;
1513
+ /** Cấp độ quyền truy cập (0 = Chủ tài khoản gốc). */
1514
+ accessLevel: number;
1515
+ }
1516
+ interface ZaloAdsAccountAgencyInfoDto {
1517
+ /** Mã định danh của Agency (ví dụ: 277596648). */
1518
+ agencyId: number;
1519
+ /** ID tài khoản chủ sở hữu Agency (ví dụ: 257887336). */
1520
+ ownerId: number;
1521
+ /** Tên pháp nhân hoặc tên hiển thị của Agency. */
1522
+ agencyName: string;
1523
+ /** Thời điểm khởi tạo Agency, định dạng Unix timestamp tính bằng giây. */
1524
+ created?: number;
1525
+ /** Cấp độ quyền của tài khoản hiện tại trong Agency (ví dụ: 9 = Chủ sở hữu Agency). */
1526
+ accessLevel: number;
1527
+ }
1528
+ /** Lấy danh sách tài khoản hoặc thành viên có quyền truy cập/tạo chiến dịch trên tài khoản quảng cáo hiện tại (dùng cho bộ lọc người tạo hoặc chuyển đổi ngữ cảnh tài khoản). Đây là entry tool thuộc lane zalo-ads-account; hỗ trợ tham số isShowAll (0 hoặc 1) và trả về danh sách personalAccessors, agencyInfo, agencyAccessors. */
1529
+ type ZaloAdsGetApiBaAccountAllaccessorsRequest = {
1530
+ /** Cờ hiển thị toàn bộ danh sách người truy cập (0 = Chỉ hiển thị mặc định/đang hoạt động, 1 = Hiển thị tất cả). Mặc định giao diện Zalo Ads truyền 0. */
1531
+ isShowAll?: 0 | 1 | number;
1532
+ };
1255
1533
  type ZaloAdsGetApiBaAccountAllaccessorsResponse = {
1256
- [key: string]: unknown;
1534
+ /** Mã kết quả (0 = Thành công). */
1535
+ code: number;
1536
+ /** Thông điệp trạng thái (ví dụ: 'success'). */
1537
+ msg?: string;
1538
+ data: {
1539
+ /** Danh sách thành viên truy cập cấp tài khoản cá nhân (bao gồm chủ tài khoản với accessLevel = 0). */
1540
+ personalAccessors: Array<ZaloAdsAccessorItemDto>;
1541
+ /** Thông tin Agency liên kết (nếu có). */
1542
+ agencyInfo?: ZaloAdsAccountAgencyInfoDto;
1543
+ /** Danh sách thành viên thuộc Agency có quyền truy cập tài khoản khách hàng này (nếu có). */
1544
+ agencyAccessors?: Array<ZaloAdsAccessorItemDto>;
1545
+ };
1257
1546
  };
1258
- /** Lấy các thành viên đã được cấp quyền trong tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-account; dùng để kiểm tra phạm vi phân quyền trước khi phối hợp quản trị. */
1547
+ interface ZaloAdsGrantedMemberItemDto {
1548
+ /** ID định danh của thành viên trên Zalo Ads (ví dụ: 330114198). */
1549
+ memberId: number;
1550
+ /** Tên hiển thị của thành viên. */
1551
+ memberName: string;
1552
+ /** Số điện thoại liên hệ của thành viên (định dạng 84...). */
1553
+ memberPhone?: string;
1554
+ /** URL ảnh đại diện của thành viên. */
1555
+ memberAvatar?: string;
1556
+ /** Cấp độ phân quyền truy cập của thành viên (ví dụ: 1 = Quản trị viên, 2 = Nhà quảng cáo, 3 = Người phân tích/Xem báo cáo). */
1557
+ accessLevel: number;
1558
+ }
1559
+ /** Lấy danh sách toàn bộ thành viên đã được cấp quyền truy cập trong tài khoản quảng cáo cá nhân và Agency hiện tại. Đây là entry tool thuộc lane zalo-ads-account; dùng để kiểm tra thông tin Agency (agencyInfo), danh sách thành viên được cấp quyền cấp cá nhân (personalGrantedAccessMembers) và cấp Agency (agencyGrantedAccessMembers) trước khi phối hợp quản trị. */
1259
1560
  type ZaloAdsGetApiBaAccountAllgrantedmembersRequest = Record<string, never>;
1260
1561
  type ZaloAdsGetApiBaAccountAllgrantedmembersResponse = {
1261
- [key: string]: unknown;
1562
+ /** Mã kết quả (0 = Thành công). */
1563
+ code: number;
1564
+ /** Thông điệp trạng thái (ví dụ: 'success'). */
1565
+ msg?: string;
1566
+ data: {
1567
+ /** Danh sách thành viên được cấp quyền truy cập ở cấp tài khoản cá nhân. */
1568
+ personalGrantedAccessMembers: Array<ZaloAdsGrantedMemberItemDto>;
1569
+ /** Thông tin đơn vị Agency quản lý tài khoản (nếu tài khoản là Agency hoặc thuộc Agency). */
1570
+ agencyInfo?: ZaloAdsAccountAgencyInfoDto;
1571
+ /** Danh sách nhân sự/thành viên thuộc Agency được cấp quyền truy cập. */
1572
+ agencyGrantedAccessMembers: Array<ZaloAdsGrantedMemberItemDto>;
1573
+ };
1262
1574
  };
1263
1575
  /** Lấy danh sách nguồn hoặc sự kiện chuyển đổi đã cấu hình. Đây là entry tool thuộc lane zalo-ads-conversion; dùng khi chọn conversion để đo lường hoặc tối ưu chiến dịch. */
1264
1576
  type ZaloAdsGetApiConversionAllRequest = Record<string, never>;
1265
1577
  type ZaloAdsGetApiConversionAllResponse = {
1266
- [key: string]: unknown;
1578
+ code: number;
1579
+ msg?: string;
1580
+ data: Array<ZaloAdsConversionItemDto>;
1267
1581
  };
1582
+ interface ZaloAdsStandardEventItemDto {
1583
+ id: number;
1584
+ name: string;
1585
+ code?: string;
1586
+ description?: string;
1587
+ }
1268
1588
  /** Lấy danh mục sự kiện chuyển đổi chuẩn mà Zalo Ads hỗ trợ. Đây là helper tool thuộc lane zalo-ads-conversion; dùng khi ánh xạ mục tiêu đo lường vào event chuẩn. */
1269
1589
  type ZaloAdsGetApiConversionStandardEventsRequest = Record<string, never>;
1270
1590
  type ZaloAdsGetApiConversionStandardEventsResponse = {
1271
- [key: string]: unknown;
1591
+ code: number;
1592
+ msg?: string;
1593
+ data: Array<ZaloAdsStandardEventItemDto>;
1272
1594
  };
1273
1595
  /** Lấy danh sách audience tùy chỉnh có thể dùng để nhắm chọn. Đây là entry tool thuộc lane zalo-ads-audience; dùng để chọn, kiểm tra hoặc lấy CustomAudienceId trước khi liên kết hay xóa audience. */
1274
1596
  type ZaloAdsGetApiCustomAudienceAllRequest = {
@@ -1304,15 +1626,57 @@ type ZaloAdsGetApiCustomAudienceAllResponse = {
1304
1626
  CustomAudienceId: number;
1305
1627
  }>;
1306
1628
  };
1629
+ interface ZaloAdsFileGroupItemDto {
1630
+ id: number;
1631
+ name: string;
1632
+ memberId?: number;
1633
+ created?: number;
1634
+ totalFiles?: number;
1635
+ }
1307
1636
  /** Lấy các nhóm tệp media hiện có trong tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-media; dùng để tìm nơi chứa tài nguyên trước khi chọn ảnh hoặc video. */
1308
1637
  type ZaloAdsGetApiFilegroupsRequest = Record<string, never>;
1309
1638
  type ZaloAdsGetApiFilegroupsResponse = {
1310
- [key: string]: unknown;
1311
- };
1312
- /** Lấy danh sách nội dung landing page hoặc tin tức có thể dùng trong quảng cáo. Đây là entry tool thuộc lane zalo-ads-content; dùng khi cần chọn nội dung đích cho chiến dịch. */
1639
+ code: number;
1640
+ msg?: string;
1641
+ data: Array<ZaloAdsFileGroupItemDto>;
1642
+ };
1643
+ interface ZaloAdsLpNewsButtonDto {
1644
+ /** Nhãn nút (ví dụ: 'Xem thêm', 'Xem ngay', 'Quảng cáo ngay'). */
1645
+ label: string;
1646
+ /** Đường dẫn URL đích khi nhấn nút. */
1647
+ linkUrl: string;
1648
+ /** Loại điều hướng (1 = Mở tab mới, 2 = Route nội bộ). */
1649
+ type: number;
1650
+ /** Cờ bật/tắt hiển thị nút (dùng cho secondaryButton). */
1651
+ isDisplayed?: boolean;
1652
+ }
1653
+ interface ZaloAdsLpNewsItemDto {
1654
+ /** Tiêu đề tin tức/sự kiện. */
1655
+ title: string;
1656
+ /** Mô tả ngắn của tin tức/sự kiện. */
1657
+ description: string;
1658
+ /** URL hình ảnh banner của tin tức. */
1659
+ imageUrl: string;
1660
+ /** Cờ cho biết tin tức có hiển thị trên trang Tổng quan (Dashboard) hay không. */
1661
+ displayOnHomePage?: boolean;
1662
+ /** Cờ cho biết tin tức có hiển thị trên trang chủ Landing Page hay không. */
1663
+ displayOnLandingPage?: boolean;
1664
+ /** Cấu hình nút hành động chính trên Dashboard. */
1665
+ primaryButton?: ZaloAdsLpNewsButtonDto;
1666
+ /** Cấu hình nút hành động phụ trên Dashboard. */
1667
+ secondaryButton?: ZaloAdsLpNewsButtonDto;
1668
+ /** Cấu hình nút hành động hiển thị trên popup Landing Page. */
1669
+ landingPageButton?: ZaloAdsLpNewsButtonDto;
1670
+ }
1671
+ /** Lấy thông tin tin tức/sự kiện nổi bật hiển thị dạng popup nổi (balloon) trên trang chủ Landing Page của Zalo Ads. Đây là entry tool thuộc lane zalo-ads-content; trả về đối tượng tin tức trong data (khi code = 0) hoặc thông báo "Landing page new is empty" (khi code = 1). */
1313
1672
  type ZaloAdsGetApiLpNewsRequest = Record<string, never>;
1314
1673
  type ZaloAdsGetApiLpNewsResponse = {
1315
- [key: string]: unknown;
1674
+ /** Mã trạng thái (0 = Có tin tức trả về trong data, 1 = Không có tin tức nào đang hiển thị trên Landing Page). */
1675
+ code: number;
1676
+ /** Thông báo trạng thái (ví dụ: 'Landing page new is empty' khi code = 1). */
1677
+ msg?: string;
1678
+ /** Chi tiết bài viết/tin tức nổi bật hiển thị trên Landing Page (chỉ có mặt khi code = 0). */
1679
+ data?: ZaloAdsLpNewsItemDto;
1316
1680
  };
1317
1681
  /** Lấy danh sách ảnh, video hoặc tài nguyên media theo khoảng thời gian. Đây là entry tool thuộc lane zalo-ads-media; dùng khi cần chọn asset đã tải lên cho mẫu quảng cáo. */
1318
1682
  type ZaloAdsGetApiMediaItemsRequest = {
@@ -1340,32 +1704,82 @@ type ZaloAdsGetApiMediaItemsResponse = {
1340
1704
  CreatedBy: number;
1341
1705
  }>;
1342
1706
  };
1707
+ interface ZaloAdsMemberFileItemDto {
1708
+ id: number;
1709
+ name: string;
1710
+ fileUrl: string;
1711
+ status?: number;
1712
+ lineNumber?: number;
1713
+ created?: number;
1714
+ memberId?: number;
1715
+ }
1343
1716
  /** Lấy các tệp do thành viên hiện tại quản lý trong tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-media; dùng để tra cứu asset theo quyền sở hữu hoặc trạng thái. */
1344
1717
  type ZaloAdsGetApiMemberFilesRequest = Record<string, never>;
1345
1718
  type ZaloAdsGetApiMemberFilesResponse = {
1346
- [key: string]: unknown;
1719
+ code: number;
1720
+ msg?: string;
1721
+ data: Array<ZaloAdsMemberFileItemDto>;
1347
1722
  };
1348
- /** Lấy thông tin thông báo hiển thị ở đầu trang Zalo Ads. Đây là helper tool thuộc lane zalo-ads-notification; dùng khi cần phát hiện cảnh báo hoặc thay đổi cần xử lý. */
1723
+ interface ZaloAdsNotifyHeaderItemDto {
1724
+ /** ID định danh của thông báo (ví dụ: 1). */
1725
+ id: number;
1726
+ /** Nội dung chi tiết của thông báo hiển thị trên đầu trang. */
1727
+ text: string;
1728
+ }
1729
+ /** Lấy danh sách thông báo quan trọng hiển thị trên thanh tiêu đề (header announcements) của trình quản lý Zalo Ads. Đây là helper tool thuộc lane zalo-ads-notification; dùng khi cần kiểm tra các cảnh báo hệ thống hoặc nhắc nhở quan tâm OA Hỗ trợ quảng cáo Zalo Ads. */
1349
1730
  type ZaloAdsGetApiNotifiesHeaderRequest = Record<string, never>;
1350
1731
  type ZaloAdsGetApiNotifiesHeaderResponse = {
1351
- [key: string]: unknown;
1732
+ /** Mã kết quả (0 = Thành công). */
1733
+ code: number;
1734
+ /** Thông điệp trạng thái (ví dụ: 'success'). */
1735
+ msg?: string;
1736
+ /** Danh sách các thông báo hiển thị ở đầu trang (header banner). */
1737
+ announcements: Array<ZaloAdsNotifyHeaderItemDto>;
1352
1738
  };
1353
- /** Lấy lịch sử giao dịch thanh toán của tài khoản quảng cáo. Đây là entry tool thuộc lane zalo-ads-billing; dùng khi đối soát nạp tiền, chi tiêu hoặc giao dịch trong một khoảng thời gian xác định. */
1739
+ /** Lấy lịch sử nạp tiền (charge/payment transaction history) của tài khoản quảng cáo Zalo Ads trong khoảng thời gian tối đa 31 ngày. Đây là entry tool thuộc lane zalo-ads-billing; dùng khi đối soát các giao dịch nạp tiền, ngân hàng, kênh nạp, trạng thái và xuất hóa đơn theo khoảng thời gian xác định. */
1354
1740
  type ZaloAdsGetApiPaymentTransactionHistoryRequest = {
1355
- /** Mốc kết thúc khoảng thời gian, Unix timestamp theo giây. */
1741
+ /** Mốc thời gian kết thúc khoảng tra cứu, định dạng Unix timestamp tính bằng giây (khoảng cách giữa from và to tối đa 31 ngày). */
1356
1742
  to: number;
1357
- /** Mốc bắt đầu khoảng thời gian, Unix timestamp theo giây. */
1743
+ /** Mốc thời gian bắt đầu khoảng tra cứu, định dạng Unix timestamp tính bằng giây (khoảng cách giữa from và to tối đa 31 ngày). */
1358
1744
  from: number;
1359
- /** ID thành viên cần đối soát. Capture đã quan sát giá trị 0; có thể đại diện ngữ cảnh tài khoản hiện tại. */
1745
+ /** ID tài khoản/thành viên cần tra cứu lịch sử nạp tiền. Truyền 0 để lấy theo tài khoản hiện tại đang đăng nhập hoặc truyền ID thành viên cụ thể (ví dụ: 257887336). */
1360
1746
  memberId: number;
1361
1747
  };
1748
+ interface ZaloAdsPaymentTransactionItemDto {
1749
+ /** Số tiền nạp (VNĐ), ví dụ: 1000000. */
1750
+ amount: number;
1751
+ /** Tên ngân hàng hoặc nguồn nạp (ví dụ: 'Ngân hàng TMCP Hàng Hải Việt Nam', 'Voucher'). */
1752
+ bankName: string;
1753
+ /** Kênh nạp tiền (ví dụ: 'Chuyển khoản', 'ZaloPay', 'Thẻ ATM', 'Voucher'). */
1754
+ channel: string;
1755
+ /** Nội dung/ghi chú giao dịch nạp tiền. */
1756
+ content: string;
1757
+ /** Thời điểm phát sinh giao dịch nạp tiền, định dạng Unix timestamp tính bằng giây. */
1758
+ date: number;
1759
+ /** ID người hoặc hệ thống thực hiện nạp tiền (ví dụ: 257887336). */
1760
+ createdId: number;
1761
+ /** Tên người hoặc hệ thống thực hiện nạp tiền (ví dụ: 'Zalo Ads'). */
1762
+ createdName: string;
1763
+ /** Tên phụ của đơn vị/người nạp hộ (nếu có). */
1764
+ secondaryName?: string;
1765
+ /** ID tài khoản quảng cáo thụ hưởng số tiền nạp. */
1766
+ memberId: number;
1767
+ /** Cờ đánh dấu giao dịch có xuất hóa đơn (true = Có, false = Không). */
1768
+ receipt: boolean;
1769
+ /** Trạng thái giao dịch nạp tiền (ví dụ: 'Thành công'). */
1770
+ status: string;
1771
+ }
1362
1772
  type ZaloAdsGetApiPaymentTransactionHistoryResponse = {
1363
- /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
1773
+ /** Mã trạng thái phản hồi (0 = Thành công, 1 = Lỗi tham số hoặc vượt quá 31 ngày). */
1364
1774
  code: number;
1365
- /** Các giao dịch. Cấu trúc từng giao dịch chưa được quan sát vì response mẫu rỗng. */
1366
- data: Array<{
1367
- [key: string]: unknown;
1368
- }>;
1775
+ /** Thông báo trạng thái hoặc chi tiết lỗi từ hệ thống. */
1776
+ msg?: string;
1777
+ /** Danh sách các giao dịch nạp tiền trong khoảng thời gian đã chọn. */
1778
+ data: Array<ZaloAdsPaymentTransactionItemDto>;
1779
+ /** Thông tin bổ sung của tài khoản được tra cứu (khi xem theo memberId). */
1780
+ extend?: {
1781
+ name?: string;
1782
+ };
1369
1783
  };
1370
1784
  /** Lấy danh mục vùng miền, tỉnh thành và ID quận huyện phục vụ nhắm chọn theo vị trí. Đây là helper tool thuộc lane zalo-ads-targeting; dùng khi xây dựng điều kiện địa lý chi tiết. */
1371
1785
  type ZaloAdsGetApiPlaceGetalldistrictsRequest = Record<string, never>;
@@ -1398,10 +1812,46 @@ type ZaloAdsGetApiPlaceGetalldistrictsResponse = {
1398
1812
  };
1399
1813
  };
1400
1814
  };
1401
- /** Kiểm tra chính tả cho nội dung quảng cáo trước khi sử dụng. Đây là helper tool thuộc lane zalo-ads-content; dùng để phát hiện lỗi câu chữ trong tiêu đề hoặc mô tả. */
1402
- type ZaloAdsGetApiSpellCheckV2Request = Record<string, never>;
1815
+ interface ZaloAdsSpellCheckIssueDto {
1816
+ /** Mã quy tắc lỗi ('111'/'278' = Lỗi chính tả, '113' = Lỗi lạm dụng kí tự, '121' = Lỗi viết hoa, '236'/'237' = Lỗi sử dụng URL/SĐT). */
1817
+ code?: string;
1818
+ /** Nhãn mô tả loại lỗi hiển thị cho người dùng. */
1819
+ label?: string;
1820
+ /** Vị trí ký tự bắt đầu của cụm từ lỗi (0-indexed). */
1821
+ start: number;
1822
+ /** Vị trí ký tự kết thúc của cụm từ lỗi. */
1823
+ end: number;
1824
+ /** Cụm từ gốc bị phát hiện lỗi trong văn bản đầu vào. */
1825
+ originalText: string;
1826
+ /** Cụm từ gợi ý thay thế (chuỗi rỗng nếu gợi ý xóa bỏ). */
1827
+ text: string;
1828
+ /** Cờ đánh dấu gợi ý là xóa bỏ cụm từ lỗi (true khi text rỗng). */
1829
+ isRemoval?: boolean;
1830
+ /** Mã phân loại diff (mặc định: 0). */
1831
+ type?: number;
1832
+ }
1833
+ /** Kiểm tra chính tả và quy định nội dung quảng cáo (viết hoa, lạm dụng ký tự, SĐT/URL) bằng AI cho văn bản quảng cáo (tiêu đề hoặc chú thích). Đây là helper tool thuộc lane zalo-ads-content; bắt buộc truyền query param text và trả về danh sách vị trí lỗi kèm gợi ý chỉnh sửa trong trường data.diffs. */
1834
+ type ZaloAdsGetApiSpellCheckV2Request = {
1835
+ /** Nội dung văn bản cần kiểm tra chính tả và quy chuẩn quảng cáo (ví dụ: tiêu đề hoặc chú thích mẫu quảng cáo). */
1836
+ text: string;
1837
+ };
1403
1838
  type ZaloAdsGetApiSpellCheckV2Response = {
1404
- [key: string]: unknown;
1839
+ /** Mã kết quả HTTP/API (0 = Thành công). */
1840
+ code: number;
1841
+ /** Thông báo trạng thái (nếu có). */
1842
+ msg?: string;
1843
+ data: {
1844
+ /** UUID định danh phiên yêu cầu AI kiểm tra chính tả (dùng để gắn vào tracking request_ai_id khi lưu quảng cáo). */
1845
+ requestAiId: string;
1846
+ /** Văn bản đầu ra hoàn chỉnh sau khi AI gợi ý chỉnh sửa. */
1847
+ aiOutput: string;
1848
+ /** Thời gian xử lý của AI tính bằng mili giây (ms). */
1849
+ elapsedTime: number;
1850
+ /** Mã trạng thái dịch vụ AI (0 = SUCCESS, -1 = AI_SERVER_FAILURE, -2 = AI_REQUEST_TIMEOUT). */
1851
+ error: number;
1852
+ /** Danh sách các lỗi chính tả hoặc vi phạm quy định từ ngữ phát hiện được trong văn bản. */
1853
+ diffs: Array<ZaloAdsSpellCheckIssueDto>;
1854
+ };
1405
1855
  };
1406
1856
  /** Lấy thông tin tài khoản Zalo Ads hiện được xác thực, gồm ngân sách, hạn mức và các khả năng được cấp. Đây là auth-sensitive entry tool thuộc lane zalo-ads-account; dùng để xác nhận đúng ngữ cảnh tài khoản trước thao tác khác. Dữ liệu cá nhân, hợp đồng và định danh phiên chỉ được xử lý trong phạm vi được ủy quyền. */
1407
1857
  type ZaloAdsGetApiWhoamiRequest = Record<string, never>;
@@ -1447,6 +1897,21 @@ type ZaloAdsGetApiWhoamiResponse = {
1447
1897
  usedSimplifiedVersion?: boolean;
1448
1898
  canUseMiniPageMessageAd?: boolean;
1449
1899
  canUseOptimizeUniversalPixel?: boolean;
1900
+ /** Cho phép dùng kiểm tra chính tả AI (/api/spell-check/v2). */
1901
+ canUseSpellCheck?: boolean;
1902
+ /** Cho phép dùng tính năng tạo nhiều ảnh bằng AI. */
1903
+ canUseMultiImageAi?: boolean;
1904
+ /** Cho phép dùng công cụ tạo video. */
1905
+ canUseVideoCreationTool?: boolean;
1906
+ };
1907
+ /** Thông tin Agency quản lý tài khoản; chỉ xuất hiện khi tài khoản thuộc một Agency. */
1908
+ agencyInfo?: {
1909
+ /** ID Agency. */
1910
+ agencyId?: number;
1911
+ /** Tên Agency. */
1912
+ agencyName?: string;
1913
+ /** Cấp quyền của tài khoản trong Agency (quan sát được: 7, 9). */
1914
+ level?: number;
1450
1915
  };
1451
1916
  /** Tài khoản gốc liên quan; chứa dữ liệu cá nhân. */
1452
1917
  rootMember?: {
@@ -1479,205 +1944,276 @@ type ZaloAdsGetReportapiV2AdsRequest = {
1479
1944
  /** Bắt đầu khoảng báo cáo, Unix epoch giây. */
1480
1945
  startDate: number;
1481
1946
  };
1947
+ interface ZaloAdsAdReportItemDto {
1948
+ /** ID quảng cáo; dùng làm adId cho thao tác chi tiết/cập nhật. */
1949
+ id: number;
1950
+ name: string;
1951
+ /** Mã loại quảng cáo upstream; đã quan sát 28. */
1952
+ adType: number;
1953
+ /** Mã trạng thái. Khi lọc dùng Value chuỗi, ví dụ "3" hoặc "4", trong filter. */
1954
+ status: number;
1955
+ /** Unix epoch giây. */
1956
+ endDate: number;
1957
+ /** URL ảnh bìa. */
1958
+ coverUrl?: string;
1959
+ memberId: number;
1960
+ /** Unix epoch giây. */
1961
+ modified?: number;
1962
+ /** Mã read-only upstream; đã quan sát -1, không phải boolean. */
1963
+ readOnly?: number;
1964
+ viewType?: number;
1965
+ createdBy?: number;
1966
+ /** Unix epoch giây. */
1967
+ startDate: number;
1968
+ /** ID chiến dịch chứa quảng cáo. */
1969
+ campaignId: number;
1970
+ memberName?: string;
1971
+ /** Mã loại giá thầu upstream. */
1972
+ adPriceType?: number;
1973
+ /** Metric động; key là mã chỉ số Zalo Ads. */
1974
+ reportTotal: Record<string, number>;
1975
+ campaignName: string;
1976
+ campaignType?: number;
1977
+ conversionId?: number;
1978
+ reportByDate?: Record<string, Record<string, number>>;
1979
+ reportBySubId?: Record<string, Record<string, number>>;
1980
+ adtimaBookingId?: number;
1981
+ reportTotalByTemplate?: Record<string, Record<string, number>>;
1982
+ reportBySubIdThenByDate?: Record<string, Record<string, Record<string, number>>>;
1983
+ reportByTemplateThenByDate?: Record<string, Record<string, Record<string, number>>>;
1984
+ }
1482
1985
  type ZaloAdsGetReportapiV2AdsResponse = {
1483
1986
  msg: string;
1484
1987
  /** 0 là thành công. */
1485
1988
  code: number;
1486
- data: Array<{
1487
- /** ID quảng cáo; dùng làm adId cho thao tác chi tiết/cập nhật. */
1488
- id: number;
1489
- name: string;
1490
- /** Mã loại quảng cáo upstream; đã quan sát 28. */
1491
- adType: number;
1492
- /** Mã trạng thái. Khi lọc dùng Value chuỗi, ví dụ "3" hoặc "4", trong filter. */
1493
- status: number;
1494
- /** Unix epoch giây. */
1495
- endDate: number;
1496
- /** URL ảnh bìa. */
1497
- coverUrl?: string;
1498
- memberId: number;
1499
- /** Unix epoch giây. */
1500
- modified?: number;
1501
- /** Mã read-only upstream; đã quan sát -1, không phải boolean. */
1502
- readOnly?: number;
1503
- viewType?: number;
1504
- createdBy?: number;
1505
- /** Unix epoch giây. */
1506
- startDate: number;
1507
- /** ID chiến dịch chứa quảng cáo. */
1508
- campaignId: number;
1509
- memberName?: string;
1510
- /** Mã loại giá thầu upstream. */
1511
- adPriceType?: number;
1512
- /** Metric động; key là mã chỉ số Zalo Ads. */
1513
- reportTotal: {
1514
- [key: string]: number;
1515
- };
1516
- campaignName: string;
1517
- campaignType?: number;
1518
- conversionId?: number;
1519
- reportByDate?: {
1520
- [key: string]: {
1521
- [key: string]: number;
1522
- };
1523
- };
1524
- reportBySubId?: {
1525
- [key: string]: {
1526
- [key: string]: number;
1527
- };
1528
- };
1529
- adtimaBookingId?: number;
1530
- reportTotalByTemplate?: {
1531
- [key: string]: {
1532
- [key: string]: number;
1533
- };
1534
- };
1535
- reportBySubIdThenByDate?: {
1536
- [key: string]: {
1537
- [key: string]: {
1538
- [key: string]: number;
1539
- };
1540
- };
1541
- };
1542
- reportByTemplateThenByDate?: {
1543
- [key: string]: {
1544
- [key: string]: {
1545
- [key: string]: number;
1546
- };
1547
- };
1548
- };
1549
- }>;
1989
+ data: Array<ZaloAdsAdReportItemDto>;
1550
1990
  };
1991
+ interface ZaloAdsCampaignReportItemDto {
1992
+ id: number;
1993
+ name: string;
1994
+ status: number;
1995
+ endDate: number;
1996
+ memberId: number;
1997
+ readOnly: number;
1998
+ viewType: number;
1999
+ startDate: number;
2000
+ memberName?: string;
2001
+ /** Metric động; key là mã chỉ số Zalo Ads. */
2002
+ reportTotal: Record<string, number>;
2003
+ campaignType: number;
2004
+ adtimaCampaignId: number;
2005
+ reportByDate?: Record<string, Record<string, number>>;
2006
+ }
1551
2007
  /** Lấy báo cáo chi tiết của một chiến dịch đã biết. Đây là detail tool thuộc lane zalo-ads-reporting; dùng khi đã có campaign ID và cần xem chỉ số hiệu quả của chiến dịch đó. */
1552
- type ZaloAdsGetReportapiV2CampaignsRequest = Record<string, never>;
2008
+ type ZaloAdsGetReportapiV2CampaignsRequest = {
2009
+ /** ID chiến dịch cần xem báo cáo. */
2010
+ campaignId?: number | string;
2011
+ /** Ngày bắt đầu báo cáo, Unix timestamp theo giây. */
2012
+ startDate?: number;
2013
+ /** Ngày kết thúc báo cáo, Unix timestamp theo giây. */
2014
+ endDate?: number;
2015
+ /** Mốc làm mới truy vấn, Unix timestamp mili giây. */
2016
+ refresh?: number | string;
2017
+ };
1553
2018
  type ZaloAdsGetReportapiV2CampaignsResponse = {
1554
- [key: string]: unknown;
2019
+ code: number;
2020
+ msg?: string;
2021
+ data: Array<ZaloAdsCampaignReportItemDto>;
1555
2022
  };
2023
+ interface ZaloAdsUniqueUserReportDataDto {
2024
+ totalUniqueUsers: number;
2025
+ totalReach?: number;
2026
+ frequency?: number;
2027
+ byDate?: Record<string, number>;
2028
+ }
1556
2029
  /** 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ị. */
1557
2030
  type ZaloAdsGetReportapiV2UniqueUserRequest = Record<string, never>;
1558
2031
  type ZaloAdsGetReportapiV2UniqueUserResponse = {
1559
- [key: string]: unknown;
2032
+ code: number;
2033
+ msg?: string;
2034
+ data: ZaloAdsUniqueUserReportDataDto;
1560
2035
  };
1561
2036
  /** 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. */
1562
2037
  type ZaloAdsGetReportapiV3CampaignsRequest = {
2038
+ /** Chuỗi JSON biểu diễn các bộ lọc Campaigns; dùng "[]" khi không có bộ lọc. */
2039
+ filter?: string;
1563
2040
  /** Ngày kết thúc báo cáo, Unix timestamp theo giây. */
1564
2041
  endDate: number;
1565
- /** Mốc refresh truy vấn, Unix timestamp mili giây theo capture. */
1566
- refresh: number;
2042
+ /** Mốc làm mới truy vấn khi upstream yêu cầu, Unix timestamp mili giây. */
2043
+ refresh?: number;
2044
+ /** ID agency quản lý tài khoản; dùng 0 khi không thuộc agency. */
2045
+ agencyId?: number;
2046
+ /** ID người tạo chiến dịch dùng để lọc danh sách campaign. */
2047
+ createdBy?: number;
1567
2048
  /** Ngày bắt đầu báo cáo, Unix timestamp theo giây. */
1568
2049
  startDate: number;
1569
2050
  };
1570
2051
  type ZaloAdsGetReportapiV3CampaignsResponse = {
1571
2052
  msg: string;
1572
2053
  code: number;
1573
- data: Array<{
1574
- id: number;
1575
- name: string;
1576
- status: number;
1577
- endDate: number;
1578
- memberId: number;
1579
- readOnly: number;
1580
- viewType: number;
1581
- startDate: number;
1582
- memberName?: string;
1583
- /** Metric động; key là mã chỉ số Zalo Ads. */
1584
- reportTotal: {
1585
- [key: string]: number;
1586
- };
1587
- campaignType: number;
1588
- adtimaCampaignId: number;
1589
- }>;
2054
+ data: Array<ZaloAdsCampaignReportItemDto>;
1590
2055
  };
1591
2056
  /** 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. */
1592
- type ZaloAdsGetZaapiCampaignReportcampaignRequest = Record<string, never>;
2057
+ type ZaloAdsGetZaapiCampaignReportcampaignRequest = {
2058
+ campaignId?: number | string;
2059
+ campId?: number | string;
2060
+ };
1593
2061
  type ZaloAdsGetZaapiCampaignReportcampaignResponse = {
1594
- [key: string]: unknown;
2062
+ code: number;
2063
+ msg?: string;
2064
+ data?: ZaloAdsCampaignReportItemDto;
1595
2065
  };
1596
2066
  /** 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. */
1597
- type ZaloAdsGetZaapiCheckcamphasmanyadsRequest = Record<string, never>;
2067
+ type ZaloAdsGetZaapiCheckcamphasmanyadsRequest = {
2068
+ campaignId?: number | string;
2069
+ campId?: number | string;
2070
+ };
1598
2071
  type ZaloAdsGetZaapiCheckcamphasmanyadsResponse = {
1599
- [key: string]: unknown;
2072
+ code: number;
2073
+ msg?: string;
2074
+ data: boolean | number;
1600
2075
  };
1601
2076
  /** Lấy danh sách quảng cáo thuộc một chiến dịch. Đây là entry tool thuộc lane zalo-ads-ad; dùng khi đã có campaign ID và cần chọn quảng cáo để xem hoặc chỉnh sửa. */
1602
- type ZaloAdsGetZaapiGetadsfromcampaignidRequest = Record<string, never>;
1603
- type ZaloAdsGetZaapiGetadsfromcampaignidResponse = {
1604
- [key: string]: unknown;
2077
+ type ZaloAdsGetZaapiGetadsfromcampaignidRequest = {
2078
+ campaignId?: number | string;
2079
+ campId?: number | string;
1605
2080
  };
1606
- /** Lấy danh sách tất cả Zalo Official Account hoặc trang có thể sử dụng. Đây là entry tool thuộc lane zalo-ads-page; dùng khi cần chọn page/OA trước khi tạo chiến dịch. */
2081
+ type ZaloAdsGetZaapiGetadsfromcampaignidResponse = {
2082
+ code: number;
2083
+ msg?: string;
2084
+ data: Array<ZaloAdsAdUpdatePayloadDto>;
2085
+ };
2086
+ interface ZaloAdsPageConfigDto {
2087
+ /** Hạng tài khoản OA (ví dụ: 0 = Phổ thông, 1 = Xác thực/Nâng cao). */
2088
+ tier?: number;
2089
+ viewStatus?: number;
2090
+ isVerified?: boolean;
2091
+ allowMessage?: boolean;
2092
+ }
2093
+ /** Một địa điểm trong `extraInfo.locations` của OA (quan sát trên 67 địa điểm của 64 OA). */
2094
+ interface ZaloAdsOwnedPageLocationDto {
2095
+ /** Địa chỉ đầy đủ. */
2096
+ address: string;
2097
+ /** Mã tỉnh/thành. */
2098
+ provinceId: number;
2099
+ /** Mã quận/huyện; chỉ có ở 64/67 địa điểm quan sát được. */
2100
+ districtId?: number;
2101
+ /** Vĩ độ. */
2102
+ lat: number;
2103
+ /** Kinh độ. */
2104
+ lng: number;
2105
+ }
2106
+ /** Cấu trúc của chuỗi JSON `extraInfo` sau khi `JSON.parse`. Dữ liệu cá nhân, chỉ xử lý trong phạm vi được ủy quyền. */
2107
+ interface ZaloAdsOwnedPageExtraInfoDto {
2108
+ website: string | null;
2109
+ contactName: string;
2110
+ hotline: string | null;
2111
+ workingTime: string | null;
2112
+ /** Số điện thoại liên hệ dạng quốc tế, ví dụ "84384473007". */
2113
+ contactPhone: string;
2114
+ locations: Array<ZaloAdsOwnedPageLocationDto>;
2115
+ }
2116
+ interface ZaloAdsOwnedPageItemDto {
2117
+ /** ID nội bộ page/OA (trùng với pageId, ví dụ: 429753475). */
2118
+ id: number;
2119
+ /** Tên danh mục ngành nghề, khi có. */
2120
+ cate?: string;
2121
+ /** Tên page/OA. */
2122
+ name: string;
2123
+ /** Loại page/OA (ví dụ: 2 = Doanh nghiệp/Cửa hàng). */
2124
+ type: number;
2125
+ /** Cờ store (0 hoặc 1). */
2126
+ store?: number;
2127
+ /** Cấu hình phân hạng page/OA thay đổi theo loại. */
2128
+ config?: ZaloAdsPageConfigDto;
2129
+ /** ID nội bộ của page/OA dùng trong các API Zalo Ads như tạo chiến dịch (/zaapi/addNewCamp) hoặc lấy danh sách bài viết (/zaapi/getOwnedArticles). */
2130
+ pageId: number;
2131
+ /** Trạng thái hoạt động page/OA (ví dụ: 1 = Đang hoạt động). */
2132
+ status: number;
2133
+ /** Các ID danh mục ngành nghề (ví dụ: [10018]). */
2134
+ cateIds?: Array<number>;
2135
+ /** ID chủ sở hữu, chỉ xử lý trong phạm vi được ủy quyền. */
2136
+ ownerId?: number;
2137
+ configAd?: {
2138
+ /** Trạng thái hiển thị quảng cáo (ví dụ: 1 = Cho phép). */
2139
+ viewStatus?: number;
2140
+ };
2141
+ /** URL ảnh bìa, khi có. */
2142
+ coverUrl?: string;
2143
+ /** Mã định danh OA làm nhiễu dạng chuỗi số dài (trùng với pageIdNoised). */
2144
+ noisedId?: string;
2145
+ /** Tên hiển thị page/OA. */
2146
+ pageName: string;
2147
+ /** URL ảnh đại diện, khi có. */
2148
+ avatarUrl?: string;
2149
+ /** Cho biết OA đã chứng thực tích vàng (true) hay chưa (false). */
2150
+ certified?: boolean;
2151
+ /** Chuỗi JSON chứa thông tin liên hệ (website, contactName, hotline, contactPhone, workingTime) và danh sách vị trí (locations), khi có. */
2152
+ extraInfo?: string;
2153
+ /** Trạng thái vận hành page/OA (ví dụ: 1 = Hoạt động bình thường). */
2154
+ pageStatus: number;
2155
+ /** Thời điểm tạo dạng Unix timestamp mili giây. */
2156
+ createdTime?: number;
2157
+ /** Mô tả page/OA, khi có. */
2158
+ description?: string;
2159
+ /** Thời điểm cập nhật dạng Unix timestamp mili giây. */
2160
+ updatedTime?: number;
2161
+ /** Mã định danh OA công khai/làm nhiễu dạng chuỗi số dài (ví dụ: '305001418732969574'), dùng làm oaId trong các API Instant Pages, Zalo Forms và Message Flows. */
2162
+ pageIdNoised?: string;
2163
+ }
2164
+ /** Lấy danh sách tất cả Zalo Official Account hoặc trang có thể sử dụng. Đây là entry tool thuộc lane zalo-ads-page; dùng khi cần chọn page/OA trước khi tạo chiến dịch hoặc lấy bài viết OA. */
1607
2165
  type ZaloAdsGetZaapiGetallpagesRequest = Record<string, never>;
1608
2166
  type ZaloAdsGetZaapiGetallpagesResponse = {
1609
- [key: string]: unknown;
2167
+ code: number;
2168
+ msg?: string;
2169
+ data: Array<ZaloAdsOwnedPageItemDto>;
2170
+ };
2171
+ interface ZaloAdsOwnedArticleItemDto {
2172
+ /** Mã định danh nội bộ của bài viết (ví dụ: 17050656), dùng để truyền vào trường articleId khi tạo chiến dịch Quảng cáo Bài viết (campaignType = 4) hoặc ZaloFeedId khi cập nhật quảng cáo. */
2173
+ articleId: number;
2174
+ /** ID nội bộ của trang Zalo Official Account sở hữu bài viết (ví dụ: 429753475). */
2175
+ pageId: number;
2176
+ /** Tiêu đề của bài viết. */
2177
+ title: string;
2178
+ /** Đoạn mô tả tóm tắt (sapo) của bài viết. */
2179
+ description?: string;
2180
+ /** Đường dẫn URL công khai để xem bài viết trên Zalo OA (ví dụ: 'https://post.oa.zalo.me/d?id=...&pageId=...'). */
2181
+ viewUrl: string;
2182
+ /** URL ảnh đại diện thu nhỏ (thumbnail) của bài viết. */
2183
+ thumbnail?: string;
2184
+ /** Tổng số lượt xem bài viết. */
2185
+ numViews?: number;
2186
+ /** Tổng số lượt chia sẻ bài viết. */
2187
+ numShares?: number;
2188
+ /** Cờ đánh dấu bài viết định dạng video (true) hay bài viết thông thường (false). */
2189
+ isVideoArticle: boolean;
2190
+ }
2191
+ /** Lấy danh sách các bài viết đã xuất bản thuộc một trang Zalo Official Account (OA) cụ thể theo mã pageId nội bộ. Đây là entry tool thuộc lane zalo-ads-content / zalo-ads-article; dùng khi chọn bài viết nguồn cho quảng cáo bài viết (campaignType = 4). */
2192
+ type ZaloAdsGetZaapiGetownedarticlesRequest = {
2193
+ /** ID nội bộ của trang Zalo Official Account (trường pageId hoặc id kiểu số nguyên lấy từ getZaapiGetownedpages / getZaapiGetallpages, ví dụ: 429753475). Không truyền pageIdNoised. */
2194
+ pageId: number | string;
1610
2195
  };
1611
- /** Lấy các bài viết thuộc những OA mà tài khoản có quyền quản lý. Đây là entry tool thuộc lane zalo-ads-content; dùng khi chọn bài viết nguồn cho quảng cáo bài viết. */
1612
- type ZaloAdsGetZaapiGetownedarticlesRequest = Record<string, never>;
1613
2196
  type ZaloAdsGetZaapiGetownedarticlesResponse = {
1614
- [key: string]: unknown;
2197
+ code: number;
2198
+ msg?: string;
2199
+ data: Array<ZaloAdsOwnedArticleItemDto>;
1615
2200
  };
1616
- /** Lấy các OA do tài khoản hiện tại sở hữu hoặc quản lý. Đây là entry tool thuộc lane zalo-ads-page; dùng để lấy page ID hợp lệ trước khi cấu hình campaign. */
2201
+ /** Lấy các OA do tài khoản hiện tại sở hữu hoặc quản lý. Đây là entry tool thuộc lane zalo-ads-page; dùng để lấy page ID hợp lệ trước khi cấu hình campaign hoặc lấy bài viết OA. */
1617
2202
  type ZaloAdsGetZaapiGetownedpagesRequest = Record<string, never>;
1618
2203
  type ZaloAdsGetZaapiGetownedpagesResponse = {
1619
2204
  /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
1620
2205
  code: number;
1621
2206
  /** Danh sách page/OA. */
1622
- data: Array<{
1623
- /** ID nội bộ page/OA. */
1624
- id: number;
1625
- /** Tên danh mục, khi có. */
1626
- cate?: string;
1627
- /** Tên page/OA. */
1628
- name: string;
1629
- /** Loại page/OA. */
1630
- type: number;
1631
- /** Cờ store. */
1632
- store?: number;
1633
- /** Cấu hình page/OA thay đổi theo loại. */
1634
- config?: {
1635
- [key: string]: unknown;
1636
- };
1637
- /** ID page/OA dùng trong các API Zalo Ads. */
1638
- pageId: number;
1639
- /** Trạng thái page/OA. */
1640
- status: number;
1641
- /** Các ID danh mục. */
1642
- cateIds?: Array<number>;
1643
- /** ID chủ sở hữu, chỉ xử lý trong phạm vi được ủy quyền. */
1644
- ownerId?: number;
1645
- configAd?: {
1646
- /** Trạng thái hiển thị quảng cáo. */
1647
- viewStatus?: number;
1648
- };
1649
- /** URL ảnh bìa, khi có. */
1650
- coverUrl?: string;
1651
- /** ID làm nhiễu, khi API trả về. */
1652
- noisedId?: string;
1653
- /** Tên hiển thị page/OA. */
1654
- pageName: string;
1655
- /** URL ảnh đại diện, khi có. */
1656
- avatarUrl?: string;
1657
- /** Cho biết OA đã chứng thực hay chưa. */
1658
- certified?: boolean;
1659
- /** Chuỗi JSON chứa thông tin liên hệ và vị trí, khi có; có thể là dữ liệu cá nhân. */
1660
- extraInfo?: string;
1661
- /** Trạng thái vận hành page/OA. */
1662
- pageStatus: number;
1663
- /** Thời điểm tạo dạng Unix timestamp mili giây. */
1664
- createdTime?: number;
1665
- /** Mô tả page/OA, khi có. */
1666
- description?: string;
1667
- /** Thời điểm cập nhật dạng Unix timestamp mili giây. */
1668
- updatedTime?: number;
1669
- /** ID làm nhiễu của page/OA, khi API trả về. */
1670
- pageIdNoised?: string;
1671
- }>;
2207
+ data: Array<ZaloAdsOwnedPageItemDto>;
1672
2208
  };
1673
2209
  /** Lấy khách hàng thuộc agency cùng ngân sách, hạn mức và trạng thái truy cập. Đây là auth-sensitive entry tool thuộc lane zalo-ads-agency; dùng khi cần đối soát danh sách khách hàng hoặc hạn mức theo agency. Dữ liệu định danh và số điện thoại thành viên chỉ được xử lý trong phạm vi được ủy quyền. */
1674
2210
  type ZaloAdsListAgencyCustomersWithBudgetRequest = {
1675
- /** Số khách hàng tối đa mỗi lần lấy. */
1676
- limit: number;
1677
- /** Vị trí bắt đầu để phân trang, gốc 0. */
1678
- offset: number;
1679
- /** Sắp xếp ngày tham gia tăng dần khi là true. */
1680
- joinDateAsc: boolean;
2211
+ /** Số khách hàng tối đa mỗi lần lấy (mặc định: 15). */
2212
+ limit?: number;
2213
+ /** Vị trí bắt đầu để phân trang, gốc 0 (mặc định: 0). */
2214
+ offset?: number;
2215
+ /** Sắp xếp ngày tham gia tăng dần khi là true (mặc định: true). */
2216
+ joinDateAsc?: boolean;
1681
2217
  };
1682
2218
  type ZaloAdsListAgencyCustomersWithBudgetResponse = {
1683
2219
  /** Thông điệp kết quả. */
@@ -1792,9 +2328,7 @@ type ZaloAdsListFormsByOfficialAccountResponse = {
1792
2328
  /** Trạng thái mở rộng section. */
1793
2329
  expand: boolean;
1794
2330
  /** Nội dung section thay đổi theo type, ví dụ images, videos hoặc table. */
1795
- content: {
1796
- [key: string]: unknown;
1797
- };
2331
+ content: ZaloAdsFormSectionContentDto;
1798
2332
  /** Cho biết section bị vô hiệu hóa hay không. */
1799
2333
  disable: boolean;
1800
2334
  }>;
@@ -1828,7 +2362,9 @@ type ZaloAdsListFormsByOfficialAccountResponse = {
1828
2362
  updatedAt?: number;
1829
2363
  /** Các điều kiện bổ sung, khi có. */
1830
2364
  conditions?: Array<{
1831
- [key: string]: unknown;
2365
+ field?: string;
2366
+ operator?: string;
2367
+ value?: string | number;
1832
2368
  }>;
1833
2369
  /** URL ảnh bìa, khi có. */
1834
2370
  coverPhoto?: string;
@@ -1842,7 +2378,8 @@ type ZaloAdsListFormsByOfficialAccountResponse = {
1842
2378
  gotoActionType?: number;
1843
2379
  /** Nhóm câu hỏi, khi có. */
1844
2380
  groupQuestions?: Array<{
1845
- [key: string]: unknown;
2381
+ groupIdx?: number;
2382
+ title?: string;
1846
2383
  }>;
1847
2384
  /** Cờ widget đồng ý OA. */
1848
2385
  oaConsentWidget?: boolean;
@@ -1941,31 +2478,50 @@ type ZaloAdsPostApiAdEstimateaudienceResponse = {
1941
2478
  };
1942
2479
  };
1943
2480
  };
2481
+ interface ZaloAdsMediaSaveSettingsDto {
2482
+ Url: string;
2483
+ Width: number;
2484
+ Height: number;
2485
+ Duration?: number;
2486
+ ThumbUrl?: string;
2487
+ }
2488
+ interface ZaloAdsMediaSavePayloadDto {
2489
+ Name: string;
2490
+ Type: number;
2491
+ Settings: ZaloAdsMediaSaveSettingsDto;
2492
+ }
1944
2493
  /** Lưu tài nguyên media vào thư viện Zalo Ads sau khi đã có URL ảnh hoặc video và metadata kích thước. Đây là mutation tool thuộc lane zalo-ads-media; dùng sau bước upload để nhận MediaId cho cấu hình quảng cáo. */
1945
2494
  type ZaloAdsPostApiMediaSaveRequest = {
1946
- /** Chuỗi JSON media gồm Name (tên), Type (loại) và Settings với Url, Width, Height. Form-urlencoded field name là data. */
1947
- data: string;
2495
+ /** Chuỗi JSON hoặc object media gồm Name (tên), Type (loại) và Settings với Url, Width, Height. Form-urlencoded field name là data. */
2496
+ data: ZaloAdsMediaSavePayloadDto | string;
1948
2497
  };
1949
2498
  type ZaloAdsPostApiMediaSaveResponse = {
1950
2499
  code: number;
1951
2500
  /** ID media vừa được lưu. */
1952
2501
  data: number;
1953
2502
  };
1954
- /** Tải ảnh lên kho media của tài khoản quảng cáo. Đây là mutation tool thuộc lane zalo-ads-media; dùng khi cần tạo asset ảnh trước bước cấu hình quảng cáo. Field multipart file là giả định tạm thời và cần xác minh bằng Form Data thực tế. */
2503
+ /** Tải ảnh lên kho media của tài khoản quảng cáo (`POST /api/member/upload-image`). Đây là mutation tool thuộc lane zalo-ads-media; dùng khi cần tạo asset ảnh trước bước cấu hình quảng cáo. Đã xác minh thực tế trên Zalo Ads sử dụng trường multipart `File` (chữ hoa). */
1955
2504
  type ZaloAdsPostApiMemberUploadImageRequest = {
1956
- /** Tệp ảnh cần tải lên; field name file là giả định tạm thời. */
1957
- file: FileInput;
2505
+ /** Tệp ảnh cần tải lên (URL HTTP/HTTPS, đường dẫn file local trong Node.js, hoặc Blob/Uint8Array). */
2506
+ File?: FileInput;
2507
+ /** Alias tương thích ngược cho `File` (service tự ánh xạ sang `File`). */
2508
+ file?: FileInput;
1958
2509
  };
1959
2510
  type ZaloAdsPostApiMemberUploadImageResponse = {
1960
2511
  /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
1961
2512
  code: number;
1962
2513
  /** URL ảnh do Zalo Ads trả về. */
1963
2514
  data: string;
2515
+ msg?: string;
1964
2516
  };
1965
2517
  /** Xóa hoặc gỡ một quảng cáo đã chọn khỏi Zalo Ads. Đây là mutation tool thuộc lane zalo-ads-ad; chỉ dùng khi đã xác nhận đúng quảng cáo cần xóa. */
1966
- type ZaloAdsPostZaapiDeleteadRequest = Record<string, never>;
2518
+ type ZaloAdsPostZaapiDeleteadRequest = {
2519
+ adId?: number | string;
2520
+ };
1967
2521
  type ZaloAdsPostZaapiDeleteadResponse = {
1968
- [key: string]: unknown;
2522
+ code: number;
2523
+ msg: string;
2524
+ data?: number | boolean;
1969
2525
  };
1970
2526
  /** Đổi tên hiển thị của một chiến dịch Zalo Ads đã tồn tại. Đây là mutation tool thuộc lane quản lý chiến dịch; dùng khi chỉ cần thay tên mà không thay đổi ngân sách, lịch chạy hoặc quảng cáo bên trong. Kết quả chỉ xác nhận thao tác thành công hoặc trả lỗi từ Zalo Ads. */
1971
2527
  type ZaloAdsRenameCampaignRequest = {
@@ -1980,31 +2536,31 @@ type ZaloAdsRenameCampaignResponse = {
1980
2536
  /** Mã kết quả; 0 biểu thị đổi tên thành công. */
1981
2537
  code: number;
1982
2538
  };
1983
- /** Cập nhật cấu hình quảng cáo E-commerce (Commerce) hiện có trên Zalo Ads (Type = 19). */
2539
+ /** Cập nhật cấu hình quảng cáo E-commerce / Commerce hiện có trên Zalo Ads (Type = 19 hoặc 23). */
1984
2540
  type ZaloAdsUpdateEcommerceAdRequest = {
1985
2541
  est?: string;
1986
2542
  stt?: number | string;
1987
- /** Payload cập nhật quảng cáo E-commerce (object hoặc chuỗi JSON). */
1988
- data: Record<string, unknown> | string;
2543
+ /** Payload cập nhật quảng cáo E-commerce / Commerce (object hoặc chuỗi JSON). */
2544
+ data: ZaloAdsAdUpdatePayloadDto | string;
1989
2545
  isBoostAd?: number | string;
1990
2546
  };
1991
2547
  type ZaloAdsUpdateEcommerceAdResponse = {
1992
2548
  msg: string;
1993
2549
  code: number;
1994
- data?: unknown;
2550
+ data?: ZaloAdsAdMutationResultDto;
1995
2551
  };
1996
2552
  /** Cập nhật quảng cáo biểu mẫu (Form) đang có trên Zalo Ads (Type = 18). */
1997
2553
  type ZaloAdsUpdateFormAdRequest = {
1998
2554
  est?: string;
1999
2555
  stt?: number | string;
2000
2556
  /** Payload cập nhật quảng cáo biểu mẫu (object hoặc chuỗi JSON). */
2001
- data: Record<string, unknown> | string;
2557
+ data: ZaloAdsAdUpdatePayloadDto | string;
2002
2558
  isBoostAd?: number | string;
2003
2559
  };
2004
2560
  type ZaloAdsUpdateFormAdResponse = {
2005
2561
  msg: string;
2006
2562
  code: number;
2007
- data?: unknown;
2563
+ data?: ZaloAdsAdMutationResultDto;
2008
2564
  };
2009
2565
  /** Cấu hình đầy đủ của quảng cáo Tin nhắn. Giữ lại các trường hệ thống lấy từ getAdById khi cập nhật. */
2010
2566
  declare class ZaloAdsMessageAdUpdateDataDto {
@@ -2016,23 +2572,7 @@ declare class ZaloAdsMessageAdUpdateDataDto {
2016
2572
  AdName: string;
2017
2573
  /** 20 (hoặc 19) là quảng cáo Tin nhắn. */
2018
2574
  Type: number;
2019
- Settings: {
2020
- Image: Record<string, unknown>;
2021
- Price: {
2022
- Bid: number;
2023
- Type: number;
2024
- Limit: number;
2025
- LimitType: number;
2026
- SpendingMethod: number;
2027
- };
2028
- AdInfo: Record<string, unknown>;
2029
- AppInfo: Record<string, unknown>;
2030
- Targeting: Record<string, unknown>;
2031
- Rating?: number;
2032
- NewFeatures?: unknown[];
2033
- CreatedClientVersion?: number;
2034
- [key: string]: unknown;
2035
- };
2575
+ Settings: ZaloAdsAdSettingsDto;
2036
2576
  Status: number;
2037
2577
  StartDate: number;
2038
2578
  EndDate: number;
@@ -2042,12 +2582,11 @@ declare class ZaloAdsMessageAdUpdateDataDto {
2042
2582
  ZaloFormId?: string;
2043
2583
  ConversionId?: number;
2044
2584
  Report?: Record<string, number>;
2045
- [key: string]: unknown;
2046
2585
  }
2047
2586
  /** Cập nhật quảng cáo Tin nhắn. Service tự JSON.stringify data rồi gửi form-urlencoded. */
2048
2587
  declare class ZaloAdsUpdateMessageAdRequest {
2049
2588
  /** Payload quảng cáo đầy đủ (object hoặc chuỗi JSON); service tự tuần tự hóa thành field form data. */
2050
- data: ZaloAdsMessageAdUpdateDataDto | Record<string, unknown> | string;
2589
+ data: ZaloAdsMessageAdUpdateDataDto | ZaloAdsAdUpdatePayloadDto | string;
2051
2590
  /** Tham số UI phụ trợ; capture Zalo Ads có giá trị literal "undefined". */
2052
2591
  est?: string;
2053
2592
  /** 0 là quảng cáo thông thường, 1 là boost ad. */
@@ -2058,43 +2597,58 @@ declare class ZaloAdsUpdateMessageAdRequest {
2058
2597
  declare class ZaloAdsUpdateMessageAdResponse {
2059
2598
  msg: string;
2060
2599
  code: number;
2061
- data?: unknown;
2600
+ data?: ZaloAdsAdMutationResultDto;
2062
2601
  }
2063
- /** Tải hoặc lưu dữ liệu crop ảnh phục vụ asset quảng cáo. Đây là mutation tool thuộc lane zalo-ads-media; dùng khi cần hoàn tất biến thể ảnh trước khi đưa asset vào quảng cáo. */
2064
- type ZaloAdsUpdateNewAdsRequest = Record<string, never>;
2602
+ /** Tải ảnh và thiết lập vùng crop để tạo asset dùng cho quảng cáo Zalo Ads (`POST /zaapi/UploadCrop`). Đây là mutation tool thuộc lane zalo-ads-media; dùng trước khi đưa URL asset kết quả vào quảng cáo Display. Cần có URL ảnh nguồn và đầy đủ x, y, width, height, scale; dùng toàn bộ 0 cùng scale 1 khi không crop. */
2603
+ type ZaloAdsUpdateNewAdsRequest = {
2604
+ /** URL ảnh nguồn hoặc tệp ảnh cần tải lên và crop. */
2605
+ File: FileInput;
2606
+ /** Tọa độ crop ngang; 0 khi không crop. */
2607
+ x: number;
2608
+ /** Tọa độ crop dọc; 0 khi không crop. */
2609
+ y: number;
2610
+ /** Chiều rộng crop; 0 khi không crop. */
2611
+ width: number;
2612
+ /** Chiều cao crop; 0 khi không crop. */
2613
+ height: number;
2614
+ /** Tỷ lệ crop/zoom; payload quan sát dùng 1. */
2615
+ scale: number;
2616
+ };
2065
2617
  type ZaloAdsUpdateNewAdsResponse = {
2066
- [key: string]: unknown;
2618
+ code: number;
2619
+ msg?: string;
2620
+ data?: string;
2067
2621
  };
2068
- /** Cập nhật quảng cáo Zalo Official Account hiện có (Type = 10). */
2622
+ /** Cập nhật quảng cáo Zalo Official Account hiện có (Type = 2 hoặc 10). */
2069
2623
  type ZaloAdsUpdateOfficialAccountAdRequest = {
2070
2624
  est?: string;
2071
2625
  stt?: number | string;
2072
2626
  /** Payload cập nhật quảng cáo Official Account (object hoặc chuỗi JSON). */
2073
- data: Record<string, unknown> | string;
2627
+ data: ZaloAdsAdUpdatePayloadDto | string;
2074
2628
  isBoostAd?: number | string;
2075
2629
  };
2076
2630
  type ZaloAdsUpdateOfficialAccountAdResponse = {
2077
2631
  msg: string;
2078
2632
  code: number;
2079
- data?: unknown;
2633
+ data?: ZaloAdsAdMutationResultDto;
2080
2634
  };
2081
- /** Cập nhật quảng cáo Bài viết hiện có trên Zalo Ads (Type = 12). */
2635
+ /** Cập nhật quảng cáo Bài viết hiện có trên Zalo Ads (Type = 3 hoặc 12). */
2082
2636
  type ZaloAdsUpdatePostAdRequest = {
2083
2637
  est?: string;
2084
2638
  stt?: number | string;
2085
2639
  /** Payload cập nhật quảng cáo Bài viết (object hoặc chuỗi JSON). */
2086
- data: Record<string, unknown> | string;
2640
+ data: ZaloAdsAdUpdatePayloadDto | string;
2087
2641
  isBoostAd?: number | string;
2088
2642
  };
2089
2643
  type ZaloAdsUpdatePostAdResponse = {
2090
2644
  msg: string;
2091
2645
  code: number;
2092
- data?: unknown;
2646
+ data?: ZaloAdsAdMutationResultDto;
2093
2647
  };
2094
2648
  /** Tạo chiến dịch quảng cáo Website trên Zalo Ads (campaignType = 1, Type = 9). */
2095
2649
  type ZaloAdsCreateWebsiteCampaignRequest = {
2096
2650
  /** Cấu hình chiến dịch Website (object hoặc chuỗi JSON): { name, campaignType: 1, pageId, productId: -1, targetUrl, adtype: -1, budgetType: 0, budgetlimit, limitType: 0, campaignObjective: 0, campaignId: 0, adId: 0 }. */
2097
- data: Record<string, unknown> | string;
2651
+ data: ZaloAdsCampaignCreatePayloadDto | string;
2098
2652
  };
2099
2653
  type ZaloAdsCreateWebsiteCampaignResponse = {
2100
2654
  code: number;
@@ -2109,18 +2663,18 @@ type ZaloAdsUpdateWebsiteAdRequest = {
2109
2663
  est?: string;
2110
2664
  stt?: number | string;
2111
2665
  /** Payload cập nhật quảng cáo Website (object hoặc chuỗi JSON). */
2112
- data: Record<string, unknown> | string;
2666
+ data: ZaloAdsAdUpdatePayloadDto | string;
2113
2667
  isBoostAd?: number | string;
2114
2668
  };
2115
2669
  type ZaloAdsUpdateWebsiteAdResponse = {
2116
2670
  code: number;
2117
2671
  msg: string;
2118
- data?: unknown;
2672
+ data?: ZaloAdsAdMutationResultDto;
2119
2673
  };
2120
2674
  /** Tạo chiến dịch quảng cáo Display trên Zalo Ads (campaignType = 1, Type = 2). */
2121
2675
  type ZaloAdsCreateDisplayCampaignRequest = {
2122
2676
  /** Cấu hình chiến dịch Display (object hoặc chuỗi JSON): { name, campaignType: 1, pageId: -1, productId: -1, targetUrl, adtype: 2, budgetType: 1, budgetlimit, limitType: 1, campaignObjective: 0, campaignId: 0, adId: 0 }. */
2123
- data: Record<string, unknown> | string;
2677
+ data: ZaloAdsCampaignCreatePayloadDto | string;
2124
2678
  };
2125
2679
  type ZaloAdsCreateDisplayCampaignResponse = {
2126
2680
  code: number;
@@ -2135,18 +2689,18 @@ type ZaloAdsUpdateDisplayAdRequest = {
2135
2689
  est?: string;
2136
2690
  stt?: number | string;
2137
2691
  /** Payload cập nhật quảng cáo Display (object hoặc chuỗi JSON). */
2138
- data: Record<string, unknown> | string;
2692
+ data: ZaloAdsAdUpdatePayloadDto | string;
2139
2693
  isBoostAd?: number | string;
2140
2694
  };
2141
2695
  type ZaloAdsUpdateDisplayAdResponse = {
2142
2696
  code: number;
2143
2697
  msg: string;
2144
- data?: unknown;
2698
+ data?: ZaloAdsAdMutationResultDto;
2145
2699
  };
2146
2700
  /** Tạo chiến dịch quảng cáo Video trên Zalo Ads (campaignType = 3, Type = 11). */
2147
2701
  type ZaloAdsCreateVideoCampaignRequest = {
2148
2702
  /** Cấu hình chiến dịch Video (object hoặc chuỗi JSON): { name, campaignType: 3, pageId: -1, productId: -1, targetUrl, adtype: -1, budgetType: 1, budgetlimit, limitType: 1, campaignObjective: 0, campaignId: 0, adId: 0 }. */
2149
- data: Record<string, unknown> | string;
2703
+ data: ZaloAdsCampaignCreatePayloadDto | string;
2150
2704
  };
2151
2705
  type ZaloAdsCreateVideoCampaignResponse = {
2152
2706
  code: number;
@@ -2169,6 +2723,34 @@ type ZaloAdsDeleteCampaignResponse = {
2169
2723
  /** Thông báo kết quả: "Xóa chiến dịch thành công." */
2170
2724
  msg: string;
2171
2725
  };
2726
+ interface ZaloAdsAutomatedRuleActionDto {
2727
+ /** Mã loại hành động thực thi khi thỏa mãn điều kiện (ví dụ: 5). */
2728
+ type: number;
2729
+ /** Mã trường mục tiêu mà hành động tác động (ví dụ: 1). */
2730
+ field: number;
2731
+ /** Giới hạn trần hoặc sàn của hành động điều chỉnh (ví dụ: 1000000). */
2732
+ limit: number;
2733
+ /** Mảng giá trị tham số của hành động (ví dụ: [5] tương ứng mức thay đổi 5%). */
2734
+ values: Array<number>;
2735
+ }
2736
+ interface ZaloAdsAutomatedRuleConditionDto {
2737
+ /** Mã loại điều kiện đánh giá (ví dụ: 1). */
2738
+ type: number;
2739
+ /** Mã chỉ số đo lường dùng làm điều kiện (ví dụ: 11). */
2740
+ field: number;
2741
+ /** Giá trị ngưỡng so sánh của điều kiện (ví dụ: [1000]). */
2742
+ values: Array<number>;
2743
+ /** Mã toán tử so sánh của điều kiện (ví dụ: 1). */
2744
+ operator: number;
2745
+ /** Mã khoảng thời gian lấy dữ liệu đối chiếu điều kiện (ví dụ: 2). */
2746
+ timeRange: number;
2747
+ }
2748
+ interface ZaloAdsAutomatedRuleScheduleDto {
2749
+ type?: number;
2750
+ frequency?: number;
2751
+ hours?: Array<number>;
2752
+ daysOfWeek?: Array<number>;
2753
+ }
2172
2754
  /** Tìm kiếm và lấy danh sách quy tắc tự động (Automated Rules) trên Zalo Ads. */
2173
2755
  type ZaloAdsListAutomatedRulesRequest = {
2174
2756
  /** Từ khóa lọc theo tên quy tắc tự động (truyền "" để lấy toàn bộ). */
@@ -2183,36 +2765,44 @@ type ZaloAdsListAutomatedRulesResponse = {
2183
2765
  memberId: number;
2184
2766
  createdBy: number;
2185
2767
  ruleName: string;
2186
- action: Record<string, unknown>;
2187
- conditions: Array<Record<string, unknown>>;
2188
- schedule: Record<string, unknown>;
2768
+ action: ZaloAdsAutomatedRuleActionDto;
2769
+ conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
2770
+ schedule: ZaloAdsAutomatedRuleScheduleDto;
2189
2771
  status: number;
2190
2772
  createdTime: number;
2191
2773
  appliedTo: number;
2192
- [key: string]: unknown;
2193
2774
  };
2194
2775
  campaignIds?: number[];
2195
2776
  adIds?: number[];
2196
- [key: string]: unknown;
2197
2777
  }>;
2198
- [key: string]: unknown;
2199
2778
  };
2200
- /** Tạo mới quy tắc tự động (Automated Rule) trên Zalo Ads. */
2779
+ /** Tạo mới một quy tắc tự động (Automated Rule) trên Zalo Ads với phạm vi áp dụng, hành động thực thi, bộ điều kiện kích hoạt và tần suất kiểm tra. Đây là mutation tool thuộc lane zalo-ads-automation. */
2201
2780
  type ZaloAdsCreateAutomatedRuleRequest = {
2202
- appliedTo: number;
2781
+ /** Phạm vi áp dụng quy tắc tự động (ví dụ: 1). */
2782
+ scope?: number;
2783
+ /** Tên quy tắc tự động cần tạo. */
2203
2784
  ruleName: string;
2204
- action: Record<string, unknown>;
2205
- conditions: Array<Record<string, unknown>>;
2206
- schedule: Record<string, unknown>;
2785
+ /** Cấu hình hành động tự động thực thi khi các điều kiện được thỏa mãn. */
2786
+ action: ZaloAdsAutomatedRuleActionDto;
2787
+ /** Danh sách các điều kiện kích hoạt quy tắc tự động. */
2788
+ conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
2789
+ /** Tần suất hệ thống chạy kiểm tra quy tắc (ví dụ: 12). */
2790
+ frequency?: number;
2791
+ /** Danh sách ID chiến dịch hoặc quảng cáo cụ thể áp dụng quy tắc; truyền mảng rỗng [] nếu áp dụng theo toàn bộ scope. */
2792
+ appliedIds?: Array<number>;
2793
+ /** Trường tương thích ngược với cấu trúc cũ. */
2794
+ appliedTo?: number;
2795
+ schedule?: ZaloAdsAutomatedRuleScheduleDto;
2207
2796
  campaignIds?: number[];
2208
2797
  adIds?: number[];
2209
- [key: string]: unknown;
2210
2798
  };
2211
2799
  type ZaloAdsCreateAutomatedRuleResponse = {
2800
+ /** Mã kết quả phản hồi từ Zalo Ads (0 là tạo quy tắc thành công). */
2212
2801
  code: number;
2802
+ /** Thông điệp kết quả xử lý (ví dụ: 'Quy tắc của bạn đã được tạo thành công.'). */
2213
2803
  msg?: string;
2214
- data?: unknown;
2215
- [key: string]: unknown;
2804
+ /** ID quy tắc tự động vừa tạo hoặc cờ kết quả trả về từ hệ thống (ví dụ: 1). */
2805
+ data?: number;
2216
2806
  };
2217
2807
  /** Cập nhật quy tắc tự động (Automated Rule) trên Zalo Ads. */
2218
2808
  type ZaloAdsUpdateAutomatedRuleRequest = {
@@ -2220,28 +2810,62 @@ type ZaloAdsUpdateAutomatedRuleRequest = {
2220
2810
  rowVersion: number;
2221
2811
  appliedTo: number;
2222
2812
  ruleName: string;
2223
- action: Record<string, unknown>;
2224
- conditions: Array<Record<string, unknown>>;
2225
- schedule: Record<string, unknown>;
2813
+ action: ZaloAdsAutomatedRuleActionDto;
2814
+ conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
2815
+ schedule: ZaloAdsAutomatedRuleScheduleDto;
2226
2816
  campaignIds?: number[];
2227
2817
  adIds?: number[];
2228
- [key: string]: unknown;
2229
2818
  };
2230
2819
  type ZaloAdsUpdateAutomatedRuleResponse = {
2231
2820
  code: number;
2232
2821
  msg?: string;
2233
- data?: unknown;
2234
- [key: string]: unknown;
2822
+ data?: number | boolean;
2235
2823
  };
2236
- /** Bật (status = 1) hoặc Tạm dừng (status = 2) quy tắc tự động trên Zalo Ads. */
2824
+ /** Thay đổi trạng thái bật hoặc tắt (active/inactive) của một quy tắc tự động (Automated Rule) trên Zalo Ads theo ID quy tắc (`POST /api/automatedrules/change-status`). Dùng khi đã có `automatedRuleId` và cần tạm dừng (`status = 0`) hoặc kích hoạt lại (`status = 1`) quy tắc tự động. */
2237
2825
  type ZaloAdsChangeAutomatedRuleStatusRequest = {
2238
- automatedRuleIds: number[];
2239
- status: 1 | 2 | number;
2826
+ /** ID định danh duy nhất của quy tắc tự động cần thay đổi trạng thái (lấy từ `listAutomatedRules`). */
2827
+ automatedRuleId?: number;
2828
+ /** Danh sách ID quy tắc tự động (tương thích ngược). */
2829
+ automatedRuleIds?: number[];
2830
+ /** Trạng thái mới của quy tắc tự động: 0 = Tạm dừng / Tắt, 1 = Bật / Hoạt động. */
2831
+ status: 0 | 1 | 2 | number;
2240
2832
  };
2241
2833
  type ZaloAdsChangeAutomatedRuleStatusResponse = {
2834
+ /** Mã kết quả phản hồi từ Zalo Ads (0 là thành công). */
2242
2835
  code: number;
2836
+ /** Thông điệp kết quả thay đổi trạng thái quy tắc tự động (ví dụ: 'Thay đổi trạng thái thành công.'). */
2243
2837
  msg?: string;
2244
- data?: unknown;
2838
+ data?: number | boolean;
2839
+ };
2840
+ /** Tra cứu lịch sử thực thi (executeHistory) và lịch sử chỉnh sửa (editHistory) của một quy tắc tự động (Automated Rule) trên Zalo Ads theo ID quy tắc (`GET /api/automatedrules/history/{automatedRuleId}`). */
2841
+ type ZaloAdsGetAutomatedRuleHistoryRequest = {
2842
+ /** ID định danh duy nhất của quy tắc tự động cần xem lịch sử (lấy từ `listAutomatedRules`). */
2843
+ automatedRuleId: number;
2844
+ };
2845
+ type ZaloAdsGetAutomatedRuleHistoryResponse = {
2846
+ /** Mã kết quả phản hồi từ Zalo Ads (0 là thành công). */
2847
+ code: number;
2848
+ /** Thông điệp trạng thái phản hồi từ Zalo Ads (nếu có). */
2849
+ msg?: string;
2850
+ /** Dữ liệu lịch sử thực thi và lịch sử chỉnh sửa của quy tắc tự động. */
2851
+ data: {
2852
+ /** Danh sách lịch sử các lần tạo hoặc chỉnh sửa cấu hình/trạng thái quy tắc tự động. */
2853
+ editHistory: Array<{
2854
+ /** Tên thành viên / người dùng thực hiện chỉnh sửa quy tắc. */
2855
+ member: string;
2856
+ /** Danh sách các dòng mô tả nội dung thay đổi trong lần chỉnh sửa. */
2857
+ content: Array<string>;
2858
+ /** Thời điểm thực hiện chỉnh sửa (Unix timestamp tính bằng giây). */
2859
+ created: number;
2860
+ }>;
2861
+ /** Danh sách lịch sử các lần hệ thống tự động kích hoạt và thực thi quy tắc. */
2862
+ executeHistory: Array<{
2863
+ /** Danh sách các dòng mô tả kết quả thực thi tự động. */
2864
+ content?: Array<string>;
2865
+ /** Thời điểm hệ thống thực thi quy tắc (Unix timestamp tính bằng giây). */
2866
+ created?: number;
2867
+ }>;
2868
+ };
2245
2869
  };
2246
2870
  /** Xóa quy tắc tự động trên Zalo Ads. */
2247
2871
  type ZaloAdsDeleteAutomatedRuleRequest = {
@@ -2250,7 +2874,7 @@ type ZaloAdsDeleteAutomatedRuleRequest = {
2250
2874
  type ZaloAdsDeleteAutomatedRuleResponse = {
2251
2875
  code: number;
2252
2876
  msg?: string;
2253
- data?: unknown;
2877
+ data?: number | boolean;
2254
2878
  };
2255
2879
  /** Tải tệp danh sách số điện thoại để tạo hoặc bổ sung nguồn audience tùy chỉnh trong Zalo Ads. Đây là mutation tool thuộc lane zalo-ads-audience; chỉ dùng khi đã có quyền xử lý dữ liệu cá nhân, tệp hợp lệ và xác nhận phạm vi upload. Không đưa số điện thoại hoặc URL tệp có dữ liệu cá nhân vào mô tả, example hay log. */
2256
2880
  type ZaloAdsUploadCustomAudiencePhoneListRequest = {
@@ -2298,6 +2922,24 @@ type ZaloAdsUpsertCustomReportResponse = {
2298
2922
  /** ID báo cáo vừa tạo hoặc cập nhật. */
2299
2923
  data: number;
2300
2924
  };
2925
+ /** Khởi tạo mới một chiến dịch Quảng cáo Commerce (`campaignType = 22`) trên Zalo Ads để quảng bá sản phẩm và chốt đơn trực tiếp qua trang đích bán hàng (Instant Page / Mini Page). Alias chuẩn theo tool `zalo_ads_create_commerce_campaign` trong Project Schema Zalo ADS. */
2926
+ type ZaloAdsCreateCommerceCampaignRequest = ZaloAdsCreateEcommerceCampaignRequest;
2927
+ type ZaloAdsCreateCommerceCampaignResponse = ZaloAdsCreateEcommerceCampaignResponse;
2928
+ /** Thiết lập và lưu cấu hình chi tiết cho mẫu Quảng cáo Commerce (`Type = 23`, gắn `MiniPageId`) trên Zalo Ads. Alias chuẩn theo tool `zalo_ads_update_commerce_ad` trong Project Schema Zalo ADS. */
2929
+ type ZaloAdsUpdateCommerceAdRequest = ZaloAdsUpdateEcommerceAdRequest;
2930
+ type ZaloAdsUpdateCommerceAdResponse = ZaloAdsUpdateEcommerceAdResponse;
2931
+ /** Khởi tạo mới một chiến dịch Quảng cáo Bài viết (`campaignType = 4`) trên Zalo Ads để quảng bá một bài viết đã xuất bản trên Zalo Official Account (`articleId`). Alias chuẩn theo tool `zalo_ads_create_article_campaign` trong Project Schema Zalo ADS. */
2932
+ type ZaloAdsCreateArticleCampaignRequest = ZaloAdsCreatePostCampaignRequest;
2933
+ type ZaloAdsCreateArticleCampaignResponse = ZaloAdsCreatePostCampaignResponse;
2934
+ /** Thiết lập và lưu cấu hình chi tiết cho mẫu Quảng cáo Bài viết (`Type = 3`, gắn `ZaloFeedId`) trên Zalo Ads. Alias chuẩn theo tool `zalo_ads_update_article_ad` trong Project Schema Zalo ADS. */
2935
+ type ZaloAdsUpdateArticleAdRequest = ZaloAdsUpdatePostAdRequest;
2936
+ type ZaloAdsUpdateArticleAdResponse = ZaloAdsUpdatePostAdResponse;
2937
+ /** Khởi tạo mới một chiến dịch Quảng cáo Zalo Official Account (`campaignType = 3`) trên Zalo Ads nhằm tăng lượt Quan tâm (Follow) cho trang Zalo OA. Alias chuẩn theo tool `zalo_ads_create_oa_campaign` trong Project Schema Zalo ADS. */
2938
+ type ZaloAdsCreateOaCampaignRequest = ZaloAdsCreateOfficialAccountCampaignRequest;
2939
+ type ZaloAdsCreateOaCampaignResponse = ZaloAdsCreateOfficialAccountCampaignResponse;
2940
+ /** 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. */
2941
+ type ZaloAdsUpdateOaAdRequest = ZaloAdsUpdateOfficialAccountAdRequest;
2942
+ type ZaloAdsUpdateOaAdResponse = ZaloAdsUpdateOfficialAccountAdResponse;
2301
2943
 
2302
2944
  /** Zalo Ads API service. Each API explicitly selects its own request transport. */
2303
2945
 
@@ -2306,6 +2948,7 @@ declare class ZaloAdsService {
2306
2948
  constructor(client: ZaloSdkHttpClient);
2307
2949
  updateVideoAd(request: ZaloAdsUpdateVideoAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateVideoAdResponse>;
2308
2950
  createFlow(request: ZaloAdsCreateFlowRequest, options?: RequestOptions): Promise<ZaloAdsCreateFlowResponse>;
2951
+ updateFlow(request: ZaloAdsUpdateFlowRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFlowResponse>;
2309
2952
  listFlowsByOfficialAccount(request: ZaloAdsListFlowsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFlowsByOfficialAccountResponse>;
2310
2953
  changeCampaignStatus(request: ZaloAdsChangeCampaignStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeCampaignStatusResponse>;
2311
2954
  deleteCampaign(request: ZaloAdsDeleteCampaignRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCampaignResponse>;
@@ -2316,46 +2959,57 @@ declare class ZaloAdsService {
2316
2959
  updateDisplayAd(request: ZaloAdsUpdateDisplayAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateDisplayAdResponse>;
2317
2960
  createVideoCampaign(request: ZaloAdsCreateVideoCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateVideoCampaignResponse>;
2318
2961
  createEcommerceCampaign(request: ZaloAdsCreateEcommerceCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateEcommerceCampaignResponse>;
2962
+ /** Alias theo tên tool chuẩn `zalo_ads_create_commerce_campaign` trong Project Schema Zalo ADS (`campaignType = 22`). */
2963
+ createCommerceCampaign(request: ZaloAdsCreateCommerceCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateCommerceCampaignResponse>;
2319
2964
  createForm(request: ZaloAdsCreateFormRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormResponse>;
2320
2965
  createFormCampaign(request: ZaloAdsCreateFormCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateFormCampaignResponse>;
2321
2966
  createMessageCampaign(request: ZaloAdsCreateMessageCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateMessageCampaignResponse>;
2322
2967
  createOfficialAccountCampaign(request: ZaloAdsCreateOfficialAccountCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateOfficialAccountCampaignResponse>;
2968
+ /** Alias theo tên tool chuẩn `zalo_ads_create_oa_campaign` trong Project Schema Zalo ADS (`campaignType = 3`). */
2969
+ createOaCampaign(request: ZaloAdsCreateOaCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateOaCampaignResponse>;
2323
2970
  createPostCampaign(request: ZaloAdsCreatePostCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreatePostCampaignResponse>;
2971
+ /** Alias theo tên tool chuẩn `zalo_ads_create_article_campaign` trong Project Schema Zalo ADS (`campaignType = 4`). */
2972
+ createArticleCampaign(request: ZaloAdsCreateArticleCampaignRequest, options?: RequestOptions): Promise<ZaloAdsCreateArticleCampaignResponse>;
2324
2973
  listAutomatedRules(request?: ZaloAdsListAutomatedRulesRequest, options?: RequestOptions): Promise<ZaloAdsListAutomatedRulesResponse>;
2325
2974
  createAutomatedRule(request: ZaloAdsCreateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsCreateAutomatedRuleResponse>;
2326
2975
  updateAutomatedRule(request: ZaloAdsUpdateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsUpdateAutomatedRuleResponse>;
2327
2976
  changeAutomatedRuleStatus(request: ZaloAdsChangeAutomatedRuleStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeAutomatedRuleStatusResponse>;
2977
+ getAutomatedRuleHistory(request: ZaloAdsGetAutomatedRuleHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetAutomatedRuleHistoryResponse>;
2328
2978
  deleteAutomatedRule(request: ZaloAdsDeleteAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsDeleteAutomatedRuleResponse>;
2979
+ createConversion(request: ZaloAdsCreateConversionRequest, options?: RequestOptions): Promise<ZaloAdsCreateConversionResponse>;
2329
2980
  deleteConversion(request: ZaloAdsDeleteConversionRequest, options?: RequestOptions): Promise<ZaloAdsDeleteConversionResponse>;
2330
2981
  deleteCustomAudience(request: ZaloAdsDeleteCustomAudienceRequest, options?: RequestOptions): Promise<ZaloAdsDeleteCustomAudienceResponse>;
2331
- getAdById(request: ZaloAdsGetAdByIdRequest, options?: RequestOptions): Promise<ZaloAdsGetAdByIdResponse>;
2982
+ getAdById(request?: ZaloAdsGetAdByIdRequest, options?: RequestOptions): Promise<ZaloAdsGetAdByIdResponse>;
2332
2983
  getAdChangeLog(request: ZaloAdsGetAdChangeLogRequest, options?: RequestOptions): Promise<ZaloAdsGetAdChangeLogResponse>;
2333
2984
  getApiAdGetlistadadvancetargeting(request?: ZaloAdsGetApiAdGetlistadadvancetargetingRequest, options?: RequestOptions): Promise<ZaloAdsGetApiAdGetlistadadvancetargetingResponse>;
2334
2985
  getApiBaAccountAllaccessors(request?: ZaloAdsGetApiBaAccountAllaccessorsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllaccessorsResponse>;
2335
2986
  getApiBaAccountAllgrantedmembers(request?: ZaloAdsGetApiBaAccountAllgrantedmembersRequest, options?: RequestOptions): Promise<ZaloAdsGetApiBaAccountAllgrantedmembersResponse>;
2336
- getApiConversionAll(request: ZaloAdsGetApiConversionAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionAllResponse>;
2987
+ getApiConversionAll(request?: ZaloAdsGetApiConversionAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionAllResponse>;
2337
2988
  getApiConversionStandardEvents(request?: ZaloAdsGetApiConversionStandardEventsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiConversionStandardEventsResponse>;
2338
- getApiCustomAudienceAll(request: ZaloAdsGetApiCustomAudienceAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiCustomAudienceAllResponse>;
2989
+ getApiCustomAudienceAll(request?: ZaloAdsGetApiCustomAudienceAllRequest, options?: RequestOptions): Promise<ZaloAdsGetApiCustomAudienceAllResponse>;
2339
2990
  getApiFilegroups(request?: ZaloAdsGetApiFilegroupsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiFilegroupsResponse>;
2340
- getApiLpNews(request: ZaloAdsGetApiLpNewsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiLpNewsResponse>;
2991
+ getApiLpNews(request?: ZaloAdsGetApiLpNewsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiLpNewsResponse>;
2341
2992
  getApiMediaItems(request: ZaloAdsGetApiMediaItemsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMediaItemsResponse>;
2342
- getApiMemberFiles(request: ZaloAdsGetApiMemberFilesRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMemberFilesResponse>;
2343
- getApiNotifiesHeader(request: ZaloAdsGetApiNotifiesHeaderRequest, options?: RequestOptions): Promise<ZaloAdsGetApiNotifiesHeaderResponse>;
2993
+ getApiMemberFiles(request?: ZaloAdsGetApiMemberFilesRequest, options?: RequestOptions): Promise<ZaloAdsGetApiMemberFilesResponse>;
2994
+ getApiNotifiesHeader(request?: ZaloAdsGetApiNotifiesHeaderRequest, options?: RequestOptions): Promise<ZaloAdsGetApiNotifiesHeaderResponse>;
2344
2995
  getApiPaymentTransactionHistory(request: ZaloAdsGetApiPaymentTransactionHistoryRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPaymentTransactionHistoryResponse>;
2345
2996
  getApiPlaceGetalldistricts(request?: ZaloAdsGetApiPlaceGetalldistrictsRequest, options?: RequestOptions): Promise<ZaloAdsGetApiPlaceGetalldistrictsResponse>;
2346
2997
  getApiSpellCheckV2(request: ZaloAdsGetApiSpellCheckV2Request, options?: RequestOptions): Promise<ZaloAdsGetApiSpellCheckV2Response>;
2347
2998
  getApiWhoami(request?: ZaloAdsGetApiWhoamiRequest, options?: RequestOptions): Promise<ZaloAdsGetApiWhoamiResponse>;
2348
2999
  getReportapiV2Ads(request: ZaloAdsGetReportapiV2AdsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2AdsResponse>;
2349
- getReportapiV2Campaigns(request: ZaloAdsGetReportapiV2CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2CampaignsResponse>;
2350
- getReportapiV2UniqueUser(request: ZaloAdsGetReportapiV2UniqueUserRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2UniqueUserResponse>;
3000
+ getReportapiV2Campaigns(request?: ZaloAdsGetReportapiV2CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2CampaignsResponse>;
3001
+ getReportapiV2UniqueUser(request?: ZaloAdsGetReportapiV2UniqueUserRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV2UniqueUserResponse>;
2351
3002
  getReportapiV3Campaigns(request: ZaloAdsGetReportapiV3CampaignsRequest, options?: RequestOptions): Promise<ZaloAdsGetReportapiV3CampaignsResponse>;
2352
- getZaapiCampaignReportcampaign(request: ZaloAdsGetZaapiCampaignReportcampaignRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCampaignReportcampaignResponse>;
2353
- getZaapiCheckcamphasmanyads(request: ZaloAdsGetZaapiCheckcamphasmanyadsRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCheckcamphasmanyadsResponse>;
2354
- getZaapiGetadsfromcampaignid(request: ZaloAdsGetZaapiGetadsfromcampaignidRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetadsfromcampaignidResponse>;
3003
+ getZaapiCampaignReportcampaign(request?: ZaloAdsGetZaapiCampaignReportcampaignRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCampaignReportcampaignResponse>;
3004
+ getZaapiCheckcamphasmanyads(request?: ZaloAdsGetZaapiCheckcamphasmanyadsRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCheckcamphasmanyadsResponse>;
3005
+ getZaapiGetadsfromcampaignid(request?: ZaloAdsGetZaapiGetadsfromcampaignidRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetadsfromcampaignidResponse>;
2355
3006
  getZaapiGetallpages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
2356
- getZaapiGetownedarticles(request?: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
3007
+ getAllPages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
3008
+ getZaapiGetownedarticles(request: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
3009
+ getOwnedArticles(request: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
2357
3010
  getZaapiGetownedpages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
2358
- listAgencyCustomersWithBudget(request: ZaloAdsListAgencyCustomersWithBudgetRequest, options?: RequestOptions): Promise<ZaloAdsListAgencyCustomersWithBudgetResponse>;
3011
+ getOwnedPages(request?: ZaloAdsGetZaapiGetownedpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedpagesResponse>;
3012
+ listAgencyCustomersWithBudget(request?: ZaloAdsListAgencyCustomersWithBudgetRequest, options?: RequestOptions): Promise<ZaloAdsListAgencyCustomersWithBudgetResponse>;
2359
3013
  listCustomReports(request?: ZaloAdsListCustomReportsRequest, options?: RequestOptions): Promise<ZaloAdsListCustomReportsResponse>;
2360
3014
  listFormsByOfficialAccount(request: ZaloAdsListFormsByOfficialAccountRequest, options?: RequestOptions): Promise<ZaloAdsListFormsByOfficialAccountResponse>;
2361
3015
  listMiniPagesByTemplate(request: ZaloAdsListMiniPagesByTemplateRequest, options?: RequestOptions): Promise<ZaloAdsListMiniPagesByTemplateResponse>;
@@ -2363,14 +3017,22 @@ declare class ZaloAdsService {
2363
3017
  postApiAdEstimateaudience(request: ZaloAdsPostApiAdEstimateaudienceRequest, options?: RequestOptions): Promise<ZaloAdsPostApiAdEstimateaudienceResponse>;
2364
3018
  postApiMediaSave(request: ZaloAdsPostApiMediaSaveRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMediaSaveResponse>;
2365
3019
  postApiMemberUploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
2366
- postZaapiDeletead(request: ZaloAdsPostZaapiDeleteadRequest, options?: RequestOptions): Promise<ZaloAdsPostZaapiDeleteadResponse>;
3020
+ /** Alias tiện lợi cho `postApiMemberUploadImage` (`POST /api/member/upload-image`). */
3021
+ uploadImage(request: ZaloAdsPostApiMemberUploadImageRequest, options?: RequestOptions): Promise<ZaloAdsPostApiMemberUploadImageResponse>;
3022
+ postZaapiDeletead(request?: ZaloAdsPostZaapiDeleteadRequest, options?: RequestOptions): Promise<ZaloAdsPostZaapiDeleteadResponse>;
2367
3023
  renameCampaign(request: ZaloAdsRenameCampaignRequest, options?: RequestOptions): Promise<ZaloAdsRenameCampaignResponse>;
2368
3024
  updateEcommerceAd(request: ZaloAdsUpdateEcommerceAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateEcommerceAdResponse>;
3025
+ /** Alias theo tên tool chuẩn `zalo_ads_update_commerce_ad` trong Project Schema Zalo ADS (`Type = 23`, gắn `MiniPageId`). */
3026
+ updateCommerceAd(request: ZaloAdsUpdateCommerceAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateCommerceAdResponse>;
2369
3027
  updateFormAd(request: ZaloAdsUpdateFormAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateFormAdResponse>;
2370
3028
  updateMessageAd(request: ZaloAdsUpdateMessageAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateMessageAdResponse>;
2371
3029
  updateNewAds(request: ZaloAdsUpdateNewAdsRequest, options?: RequestOptions): Promise<ZaloAdsUpdateNewAdsResponse>;
2372
3030
  updateOfficialAccountAd(request: ZaloAdsUpdateOfficialAccountAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateOfficialAccountAdResponse>;
3031
+ /** Alias theo tên tool chuẩn `zalo_ads_update_oa_ad` trong Project Schema Zalo ADS (`Type = 2`, `Action = 6`). */
3032
+ updateOaAd(request: ZaloAdsUpdateOaAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateOaAdResponse>;
2373
3033
  updatePostAd(request: ZaloAdsUpdatePostAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdatePostAdResponse>;
3034
+ /** Alias theo tên tool chuẩn `zalo_ads_update_article_ad` trong Project Schema Zalo ADS (`Type = 3`, gắn `ZaloFeedId`). */
3035
+ updateArticleAd(request: ZaloAdsUpdateArticleAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateArticleAdResponse>;
2374
3036
  uploadCustomAudiencePhoneList(request: ZaloAdsUploadCustomAudiencePhoneListRequest, options?: RequestOptions): Promise<ZaloAdsUploadCustomAudiencePhoneListResponse>;
2375
3037
  uploadVideo(request: ZaloAdsUploadVideoRequest, options?: RequestOptions): Promise<ZaloAdsUploadVideoResponse>;
2376
3038
  upsertCustomReport(request: ZaloAdsUpsertCustomReportRequest, options?: RequestOptions): Promise<ZaloAdsUpsertCustomReportResponse>;
@@ -2409,6 +3071,9 @@ type ZaloChatWidgetGetChatWidgetLoginConfigResponse = {
2409
3071
  /** Thông điệp kết quả từ Zalo. */
2410
3072
  error_message: string;
2411
3073
  };
3074
+ /** Alias theo tên tool chuẩn `zalo_chat_widget_get_login_config` trong Project Schema Zalo ADS. */
3075
+ type ZaloChatWidgetGetLoginConfigRequest = ZaloChatWidgetGetChatWidgetLoginConfigRequest;
3076
+ type ZaloChatWidgetGetLoginConfigResponse = ZaloChatWidgetGetChatWidgetLoginConfigResponse;
2412
3077
 
2413
3078
  /** Zalo Chat Widget API service. Each API explicitly selects its own request transport. */
2414
3079
 
@@ -2416,6 +3081,8 @@ declare class ZaloChatWidgetService {
2416
3081
  private readonly client;
2417
3082
  constructor(client: ZaloSdkHttpClient);
2418
3083
  getChatWidgetLoginConfig(request: ZaloChatWidgetGetChatWidgetLoginConfigRequest, options?: RequestOptions): Promise<ZaloChatWidgetGetChatWidgetLoginConfigResponse>;
3084
+ /** Alias theo tên tool chuẩn `zalo_chat_widget_get_login_config` trong Project Schema Zalo ADS. */
3085
+ getLoginConfig(request: ZaloChatWidgetGetLoginConfigRequest, options?: RequestOptions): Promise<ZaloChatWidgetGetLoginConfigResponse>;
2419
3086
  }
2420
3087
 
2421
3088
  /** Tắt thông báo lead của một Zalo Form đang hoạt động. Đây là mutation tool thuộc lane zalo-ads-form; dùng khi đã đối chiếu formId và cần ngừng nhận thông báo, nhưng vẫn giữ form cùng dữ liệu lead. Không dùng để xóa form hoặc xóa dữ liệu khách hàng. */
@@ -2472,15 +3139,23 @@ type ZaloFormsExportFormLeadReportResponse = {
2472
3139
  /** Tên tệp .xlsx lấy từ Content-Disposition, nếu executor cung cấp. */
2473
3140
  fileName?: string;
2474
3141
  contentType?: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
2475
- [key: string]: unknown;
2476
3142
  };
2477
- /** Lấy dữ liệu audience targeting có thể dùng để loại trừ cho một Official Account. Đây là helper tool thuộc lane zalo-ads-form; dùng trước khi cấu hình loại trừ đối tượng nếu giao diện form cần danh sách lựa chọn nguồn. Cấu trúc response chi tiết chưa có mẫu nên cần kiểm tra kết quả thực tế trước khi nối trường xuống bước sau. */
3143
+ /** Lấy dữ liệu audience targeting có thể dùng để loại trừ cho một Official Account. Đây là helper tool thuộc lane zalo-ads-form; dùng trước khi cấu hình loại trừ đối tượng nếu giao diện form cần danh sách lựa chọn nguồn. */
2478
3144
  type ZaloFormsListAudienceExclusionTargetingRequest = {
2479
3145
  /** ID Official Account cần lấy lựa chọn audience loại trừ. */
2480
3146
  oaId: string;
2481
3147
  };
3148
+ type ZaloFormsAudienceExclusionTargetingItem = {
3149
+ id: string;
3150
+ name: string;
3151
+ oaId: string;
3152
+ totalLeads?: number;
3153
+ createdTime?: number;
3154
+ };
2482
3155
  type ZaloFormsListAudienceExclusionTargetingResponse = {
2483
- [key: string]: unknown;
3156
+ msg: string;
3157
+ code: number;
3158
+ data: Array<ZaloFormsAudienceExclusionTargetingItem>;
2484
3159
  };
2485
3160
  /** Lấy lead phát sinh từ hội thoại theo OA, scene, trạng thái, thời gian và phân trang. Đây là entry tool thuộc lane zalo-ads-conversation-leads; dùng khi nguồn lead là hội thoại thay vì Zalo Form. Phân biệt với lead form: dùng sceneIds, không dùng formIds. */
2486
3161
  type ZaloFormsListConversationLeadsRequest = {
@@ -2503,8 +3178,26 @@ type ZaloFormsListConversationLeadsRequest = {
2503
3178
  /** Danh sách scene ID phân cách dấu phẩy, có thể bỏ trống. */
2504
3179
  sceneIds?: string;
2505
3180
  };
3181
+ type ZaloFormsConversationLeadItem = {
3182
+ id: string;
3183
+ oaId: string;
3184
+ userId: string;
3185
+ userName: string;
3186
+ userAvatar?: string;
3187
+ phone?: string;
3188
+ status: number;
3189
+ sceneId?: string;
3190
+ sceneName?: string;
3191
+ labelIds?: Array<string>;
3192
+ note?: string;
3193
+ createdTime: number;
3194
+ updatedTime?: number;
3195
+ };
2506
3196
  type ZaloFormsListConversationLeadsResponse = {
2507
- [key: string]: unknown;
3197
+ msg: string;
3198
+ code: number;
3199
+ total: number;
3200
+ data: Array<ZaloFormsConversationLeadItem>;
2508
3201
  };
2509
3202
  /** Lấy lead được gửi từ Zalo Form theo OA, form, trạng thái, thời gian và phân trang. Đây là entry tool thuộc lane zalo-ads-form-leads; dùng khi cần tra cứu hoặc xử lý lead form. Truyền formIds là chuỗi ID form phân cách bằng dấu phẩy từ tool danh sách form; để trống để không lọc theo form. */
2510
3203
  type ZaloFormsListFormLeadsRequest = {
@@ -2531,15 +3224,33 @@ type ZaloFormsListFormLeadsRequest = {
2531
3224
  /** Chế độ commerce. */
2532
3225
  isCommerce: boolean;
2533
3226
  };
3227
+ type ZaloFormsLeadAnswerItem = {
3228
+ questionId: string;
3229
+ title: string;
3230
+ value: string;
3231
+ };
3232
+ type ZaloFormsLeadItem = {
3233
+ id: string;
3234
+ formId: string;
3235
+ formName?: string;
3236
+ oaId: string;
3237
+ userId?: string;
3238
+ userName?: string;
3239
+ phone?: string;
3240
+ status: number;
3241
+ labelIds?: Array<string>;
3242
+ note?: string;
3243
+ createdTime: number;
3244
+ updatedTime?: number;
3245
+ answers?: Array<ZaloFormsLeadAnswerItem>;
3246
+ };
2534
3247
  type ZaloFormsListFormLeadsResponse = {
2535
3248
  msg: string;
2536
3249
  /** 0 là thành công. */
2537
3250
  code: number;
2538
- /** Bản ghi upstream; chưa có mẫu không rỗng để mô tả trường chi tiết. */
2539
- data: Array<{
2540
- [key: string]: unknown;
2541
- }>;
2542
- [key: string]: unknown;
3251
+ total?: number;
3252
+ /** Danh sách bản ghi lead thu từ Zalo Form. */
3253
+ data: Array<ZaloFormsLeadItem>;
2543
3254
  };
2544
3255
  /** Lấy danh sách Zalo Form quản trị theo Official Account và khoảng thời gian, kèm trạng thái cùng các chỉ số xem/gửi. Dùng oaId để tra cứu, không thay bằng formId; lấy data[].id trả về làm formId cho các thao tác Form management tiếp theo. data[].status: 1 = Tạo mới, 2 = Không chạy - Form chờ duyệt, 3 = Đang mở, 4 = Không chạy - Form bị từ chối. */
2545
3256
  type ZaloFormsListManagedFormsByOfficialAccountRequest = {
@@ -2595,11 +3306,9 @@ type ZaloFormsListManagedFormsByOfficialAccountResponse = {
2595
3306
  totalGetForm: string;
2596
3307
  /** Cờ upstream với đúng chữ hoa/thường, cho biết yêu cầu mỗi người trả lời chỉ gửi một phản hồi duy nhất. */
2597
3308
  RequiresUniqueResponse: boolean;
2598
- [key: string]: unknown;
2599
3309
  }>;
2600
3310
  /** Tổng số form khớp với OA và khoảng thời gian. */
2601
3311
  total: number;
2602
- [key: string]: unknown;
2603
3312
  };
2604
3313
  /** 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. */
2605
3314
  type ZaloFormsListSimpleFormsByOfficialAccountRequest = {
@@ -2649,10 +3358,8 @@ type ZaloFormsListSimpleFormsByOfficialAccountResponse = {
2649
3358
  totalGetForm: string;
2650
3359
  /** Giữ nguyên chữ hoa/thường của upstream. */
2651
3360
  RequiresUniqueResponse: boolean;
2652
- [key: string]: unknown;
2653
3361
  }>;
2654
3362
  total: number;
2655
- [key: string]: unknown;
2656
3363
  };
2657
3364
  /** 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. */
2658
3365
  type ZaloFormsUpdateFormLeadNotificationIntervalRequest = {
@@ -2679,9 +3386,7 @@ type ZaloFormsUpdateFormLeadNotificationIntervalResponse = {
2679
3386
  formName: string;
2680
3387
  /** Chu kỳ thông báo hiện tại sau cập nhật. Giá trị 0 xác nhận nhận thông báo ngay khi có lead. */
2681
3388
  interval: number;
2682
- [key: string]: unknown;
2683
3389
  };
2684
- [key: string]: unknown;
2685
3390
  };
2686
3391
  type ZaloFormsAuthSessionOaItem = {
2687
3392
  /** Mã vai trò trên OA (ví dụ: 1 = Admin). */
@@ -2700,7 +3405,6 @@ type ZaloFormsAuthSessionOaItem = {
2700
3405
  status?: number;
2701
3406
  apiUploadEnabled?: boolean;
2702
3407
  adMessageEnabled?: boolean;
2703
- [key: string]: unknown;
2704
3408
  };
2705
3409
  /** Lấy thông tin phiên đăng nhập và danh sách Official Accounts (kèm mapping giữa noisedOaId dạng số và oaId dạng mã hóa) trên form.ads.zalo.me. */
2706
3410
  type ZaloFormsGetAuthSessionResponse = {
@@ -2712,12 +3416,10 @@ type ZaloFormsGetAuthSessionResponse = {
2712
3416
  avatar: string;
2713
3417
  token: string;
2714
3418
  isInVN?: boolean;
2715
- roleWLReview?: unknown[];
3419
+ roleWLReview?: string[];
2716
3420
  oaNotifyLead?: ZaloFormsAuthSessionOaItem;
2717
3421
  oas: ZaloFormsAuthSessionOaItem[];
2718
- [key: string]: unknown;
2719
3422
  };
2720
- [key: string]: unknown;
2721
3423
  };
2722
3424
 
2723
3425
  /** Zalo Forms API service. Each API explicitly selects its own request transport. */
@@ -2754,6 +3456,171 @@ declare class ZaloInstantPagesService {
2754
3456
  updateInstantPage(request: ZaloInstantPagesUpdateInstantPageRequest, options?: RequestOptions): Promise<ZaloInstantPagesUpdateInstantPageResponse>;
2755
3457
  listInstantPageLeads(request: ZaloInstantPagesListInstantPageLeadsRequest, options?: RequestOptions): Promise<ZaloInstantPagesListInstantPageLeadsResponse>;
2756
3458
  listOfficialAccounts(request?: ZaloInstantPagesListOfficialAccountsRequest, options?: RequestOptions): Promise<ZaloInstantPagesListOfficialAccountsResponse>;
3459
+ upsertInstantPageForm(request: ZaloInstantPagesUpsertInstantPageFormRequest, options?: RequestOptions): Promise<ZaloInstantPagesUpsertInstantPageFormResponse>;
3460
+ }
3461
+
3462
+ /** DTOs for Zalo Profile Ads (`https://profile.ads.zalo.me`). Request fields are flattened; services route them automatically. */
3463
+
3464
+ /**
3465
+ * Mã Danh mục hoạt động chi tiết (`subCategoryId` - 22 mã chuẩn trên `https://profile.ads.zalo.me/register`):
3466
+ * - `10043`: Bất động sản
3467
+ * - `10018`: Công nghệ & Thiết bị
3468
+ * - `10097`: Dịch vụ tiện ích
3469
+ * - `10020`: Du lịch & Lưu trú
3470
+ * - `10021`: Giáo dục & Đào tạo
3471
+ * - `10024`: Mua sắm & Bán lẻ
3472
+ * - `10019`: Mỹ phẩm & Làm đẹp
3473
+ * - `10014`: Nhà hàng & Quán
3474
+ * - `10094`: Ô tô & Xe máy
3475
+ * - `10098`: Sản xuất & Chế tạo
3476
+ * - `10044`: Tài chính & Ngân hàng
3477
+ * - `10099`: Thiết kế & Thi công
3478
+ * - `10017`: Thời trang & May mặc
3479
+ * - `10023`: Thực phẩm & Đồ uống
3480
+ * - `10016`: Truyền thông & Giải trí
3481
+ * - `10092`: Truyền thông nội bộ
3482
+ * - `10101`: Tuyển dụng & Việc làm
3483
+ * - `10100`: Tư vấn & Quản lý
3484
+ * - `10095`: Vận tải
3485
+ * - `10093`: Viễn thông
3486
+ * - `10022`: Y tế & Dược phẩm
3487
+ * - `10025`: Dịch vụ khác
3488
+ */
3489
+ type ZaloProfileAdsSubCategoryId = 10043 | 10018 | 10097 | 10020 | 10021 | 10024 | 10019 | 10014 | 10094 | 10098 | 10044 | 10099 | 10017 | 10023 | 10016 | 10092 | 10101 | 10100 | 10095 | 10093 | 10022 | 10025 | (number & {});
3490
+ /**
3491
+ * Mã 34 Tỉnh/Thành phố chuẩn trên `https://profile.ads.zalo.me/ajax/get-province`:
3492
+ * - `1`: Thành phố Hà Nội | `79`: Thành phố Hồ Chí Minh | `48`: Thành phố Đà Nẵng | `31`: Thành phố Hải Phòng | `92`: Thành phố Cần Thơ | `46`: Thành phố Huế
3493
+ * - `91`: Tỉnh An Giang | `24`: Tỉnh Bắc Ninh | `96`: Tỉnh Cà Mau | `4`: Tỉnh Cao Bằng | `66`: Tỉnh Đắk Lắk | `11`: Tỉnh Điện Biên | `75`: Tỉnh Đồng Nai | `82`: Tỉnh Đồng Tháp
3494
+ * - `52`: Tỉnh Gia Lai | `42`: Tỉnh Hà Tĩnh | `33`: Tỉnh Hưng Yên | `56`: Tỉnh Khánh Hòa | `12`: Tỉnh Lai Châu | `20`: Tỉnh Lạng Sơn | `15`: Tỉnh Lào Cai | `68`: Tỉnh Lâm Đồng
3495
+ * - `40`: Tỉnh Nghệ An | `37`: Tỉnh Ninh Bình | `25`: Tỉnh Phú Thọ | `51`: Tỉnh Quảng Ngãi | `22`: Tỉnh Quảng Ninh | `44`: Tỉnh Quảng Trị | `14`: Tỉnh Sơn La | `80`: Tỉnh Tây Ninh
3496
+ * - `19`: Tỉnh Thái Nguyên | `38`: Tỉnh Thanh Hóa | `8`: Tỉnh Tuyên Quang | `86`: Tỉnh Vĩnh Long
3497
+ */
3498
+ type ZaloProfileAdsProvinceId = 1 | 4 | 8 | 11 | 12 | 14 | 15 | 19 | 20 | 22 | 24 | 25 | 31 | 33 | 37 | 38 | 40 | 42 | 44 | 46 | 48 | 51 | 52 | 56 | 66 | 68 | 75 | 79 | 80 | 82 | 86 | 91 | 92 | 96 | (number & {});
3499
+ /** Khởi tạo mới trang Zalo Official Account (OA) / Hồ sơ quảng cáo cửa hàng hoặc doanh nghiệp trên hệ thống Zalo Ads Profile với đầy đủ danh mục, thông tin liên hệ, địa chỉ và ảnh nhận diện. Đây là mutation tool thuộc lane zalo-ads-page. Dùng sau khi đã tải lên ảnh đại diện lấy avatarId, ảnh bìa lấy coverId và xác nhận đầy đủ thông tin đăng ký trang OA. */
3500
+ type ZaloProfileAdsCreateOaPageRequest = {
3501
+ /** Hành động tạo mới trang Official Account, cố định là "createpage" (SDK tự gán mặc định nếu bỏ qua). */
3502
+ option?: "createpage";
3503
+ /** Mã CSRF token của phiên làm việc Zalo Ads Profile hiện tại (lưu ý đúng chính tả tham số upstream là `crsf-token`). Nếu sử dụng `zpsid` / `ZaloAuthManager`, SDK sẽ tự động trích xuất từ `https://profile.ads.zalo.me/` nếu bỏ qua. */
3504
+ "crsf-token"?: string;
3505
+ /** Mã loại hình tài khoản OA. Giá trị chuẩn cố định là `2` (Tài khoản OA Doanh nghiệp / Cửa hàng / Hồ sơ quảng cáo; SDK tự gán mặc định `2` nếu bỏ qua). */
3506
+ typeId?: number;
3507
+ /** Định danh chuỗi loại tài khoản OA tương ứng với `typeId = 2`. Giá trị chuẩn cố định là `"store"` (SDK tự gán mặc định `"store"` nếu bỏ qua). */
3508
+ typeName?: string;
3509
+ /** Hạng tài khoản OA khi khởi tạo: `0` = Tài khoản Phổ thông / Hồ sơ quảng cáo mới tạo (`certified: false`, mặc định `0`); `1` = Tài khoản OA Xác thực (`certified: true`). */
3510
+ tier?: number;
3511
+ /** Mã danh mục gốc (Parent Category) được Zalo hardcode cố định là `10003` cho toàn bộ Hồ sơ quảng cáo (SDK tự gán mặc định `10003` nếu bỏ qua). */
3512
+ categoryId?: number;
3513
+ /** Mã Danh mục hoạt động chi tiết (1 trong 22 mã chuẩn `ZaloProfileAdsSubCategoryId`, ví dụ: `10018` = Công nghệ & Thiết bị, `10043` = Bất động sản). */
3514
+ subCategoryId: ZaloProfileAdsSubCategoryId;
3515
+ /** Tên hiển thị của Hồ sơ quảng cáo / Trang Zalo Official Account cần tạo (tối đa 40 ký tự, chữ cái đầu viết hoa). */
3516
+ oaName: string;
3517
+ /** Thông tin giới thiệu về hoạt động hoặc các dịch vụ và sản phẩm mà hồ sơ sẽ quảng cáo (bắt buộc tối thiểu 20 ký tự, tối đa 500 ký tự). */
3518
+ description: string;
3519
+ /** Họ và tên người liên hệ phụ trách trang OA. */
3520
+ contactName: string;
3521
+ /** Số điện thoại người liên hệ (định dạng chuỗi số, ví dụ: '84384473007'). */
3522
+ contactPhone: string;
3523
+ /** Mã fileId của ảnh đại diện nhận được từ công cụ tải ảnh đại diện (`uploadOaAvatar`). */
3524
+ avatarId: string;
3525
+ /** Mã fileId của ảnh bìa nhận được từ công cụ tải ảnh bìa (`uploadOaCover`). */
3526
+ coverId: string;
3527
+ /** Mã Tỉnh/Thành phố nơi đặt địa chỉ hoạt động (1 trong 34 mã `ZaloProfileAdsProvinceId` lấy từ `getProvinces`, ví dụ: `1` = Thành phố Hà Nội, `79` = Thành phố Hồ Chí Minh). */
3528
+ province: ZaloProfileAdsProvinceId;
3529
+ /** Mã Phường/Xã tương ứng thuộc Tỉnh/Thành phố đã chọn (lấy từ `getDistricts({ provinceId })`, ví dụ tại Hà Nội `province=1`: `637` = Phường Đại Mỗ, `9556` = Phường Hà Đông). */
3530
+ district: number;
3531
+ /** Địa chỉ chi tiết của doanh nghiệp hoặc cửa hàng (ví dụ: 'Số 40/74 đường Hữu Hưng, Phường Đại Mỗ, Thành phố Hà Nội'). */
3532
+ address: string;
3533
+ /** Xác nhận đồng ý điều khoản sử dụng Zalo Official Account (luôn là `true`, SDK tự gán mặc định `true` nếu bỏ qua). */
3534
+ agreeTerm?: boolean;
3535
+ };
3536
+ type ZaloProfileAdsCreateOaPageResponse = {
3537
+ /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là tạo trang thành công). */
3538
+ err: number;
3539
+ /** Thông điệp kết quả xử lý (ví dụ: 'Success.'). */
3540
+ msg: string;
3541
+ /** Dữ liệu trang Zalo Official Account vừa khởi tạo. */
3542
+ data?: {
3543
+ /** Tên trang Zalo Official Account vừa được tạo. */
3544
+ name: string;
3545
+ /** Mã định danh Zalo Official Account ID (OA ID) vừa được khởi tạo. */
3546
+ oaid: string;
3547
+ };
3548
+ };
3549
+ /** Tải lên ảnh đại diện (avatar) cho trang Zalo Official Account trên hệ thống Zalo Ads Profile để nhận mã fileId phục vụ khởi tạo hoặc cập nhật OA. Đây là mutation tool thuộc lane zalo-ads-page. Dùng trước bước tạo mới trang OA khi đã có URL tệp ảnh đại diện hợp lệ cần tải lên. */
3550
+ type ZaloProfileAdsUploadOaAvatarRequest = {
3551
+ /** Tùy chọn xử lý tải ảnh đại diện, mặc định là "update". */
3552
+ option?: "update";
3553
+ /** Cờ xác nhận tải ảnh cho OA mới, truyền 'true' khi tạo trang OA mới (mặc định: "true"). */
3554
+ "is-new"?: "true" | "false";
3555
+ /** URL HTTP(S), signed URL hoặc Blob/Buffer của tệp ảnh đại diện cần tải lên (JPG/PNG, tối thiểu 150x150px, tối đa 15MB); hệ thống tự động tải và đính kèm dạng multipart/form-data vào trường `avatar-file`. */
3556
+ "avatar-file": FileInput;
3557
+ };
3558
+ type ZaloProfileAdsUploadOaAvatarResponse = {
3559
+ /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là thành công). */
3560
+ err: number;
3561
+ /** Thông điệp kết quả xử lý (ví dụ: 'Cập nhật thành công!'). */
3562
+ msg: string;
3563
+ /** Mã định danh tệp ảnh đại diện đã tải lên, dùng để truyền vào trường `avatarId` khi tạo hoặc cập nhật OA. */
3564
+ fileId: string;
3565
+ };
3566
+ /** Tải lên ảnh bìa (cover) cho trang Zalo Official Account trên hệ thống Zalo Ads Profile để nhận mã fileId phục vụ khởi tạo hoặc cập nhật OA. Đây là mutation tool thuộc lane zalo-ads-page. Dùng trước bước tạo mới trang OA khi đã có URL tệp ảnh bìa hợp lệ cần tải lên. */
3567
+ type ZaloProfileAdsUploadOaCoverRequest = {
3568
+ /** Tùy chọn xử lý tải ảnh bìa, mặc định là "update". */
3569
+ option?: "update";
3570
+ /** Cờ xác nhận tải ảnh bìa cho OA mới, truyền 'true' khi tạo trang OA mới (mặc định: "true"). */
3571
+ "is-new"?: "true" | "false";
3572
+ /** URL HTTP(S), signed URL hoặc Blob/Buffer của tệp ảnh bìa cần tải lên (JPG/PNG, tối thiểu 320x180px, tối đa 15MB); hệ thống tự động tải và đính kèm dạng multipart/form-data vào trường `cover-file`. */
3573
+ "cover-file": FileInput;
3574
+ };
3575
+ type ZaloProfileAdsUploadOaCoverResponse = {
3576
+ /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là thành công). */
3577
+ err: number;
3578
+ /** Thông điệp kết quả xử lý (ví dụ: 'Cập nhật thành công!'). */
3579
+ msg: string;
3580
+ /** Mã định danh tệp ảnh bìa đã tải lên, dùng để truyền vào trường `coverId` khi tạo hoặc cập nhật OA. */
3581
+ fileId: string;
3582
+ };
3583
+ /** Phần tử Tỉnh/Thành phố hoặc Phường/Xã trên Zalo Ads Profile (`https://profile.ads.zalo.me`). */
3584
+ type ZaloProfileAdsAdministrativeItem = {
3585
+ /** Mã định danh Tỉnh/Thành phố (`province`) hoặc Phường/Xã (`district`). */
3586
+ id: number;
3587
+ /** Tên hiển thị của Tỉnh/Thành phố hoặc Phường/Xã. */
3588
+ value: string;
3589
+ };
3590
+ /** Kết quả lấy danh sách 34 Tỉnh/Thành phố chuẩn trên Zalo Ads Profile (`GET /ajax/get-province`). */
3591
+ type ZaloProfileAdsGetProvincesResponse = {
3592
+ /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là thành công). */
3593
+ err: number;
3594
+ /** Thông điệp kết quả xử lý (ví dụ: 'Lấy dữ liệu thành công.'). */
3595
+ msg: string;
3596
+ /** Danh sách 34 Tỉnh/Thành phố. */
3597
+ data: ZaloProfileAdsAdministrativeItem[];
3598
+ };
3599
+ /** Tham số truy vấn danh sách Phường/Xã theo Tỉnh/Thành phố trên Zalo Ads Profile (`GET /ajax/get-district?provinceId=...`). */
3600
+ type ZaloProfileAdsGetDistrictsRequest = {
3601
+ /** Mã Tỉnh/Thành phố lấy từ `getProvinces()` (ví dụ: `1` = Thành phố Hà Nội, `79` = Thành phố Hồ Chí Minh). */
3602
+ provinceId: ZaloProfileAdsProvinceId;
3603
+ };
3604
+ /** Kết quả lấy danh sách Phường/Xã theo Tỉnh/Thành phố trên Zalo Ads Profile (`GET /ajax/get-district?provinceId=...`). */
3605
+ type ZaloProfileAdsGetDistrictsResponse = {
3606
+ /** Mã lỗi phản hồi từ Zalo Ads Profile (0 là thành công). */
3607
+ err: number;
3608
+ /** Thông điệp kết quả xử lý (ví dụ: 'Lấy dữ liệu thành công.'). */
3609
+ msg: string;
3610
+ /** Danh sách Phường/Xã thuộc Tỉnh/Thành phố được truy vấn. */
3611
+ data: ZaloProfileAdsAdministrativeItem[];
3612
+ };
3613
+
3614
+ /** Zalo Profile Ads API service (`https://profile.ads.zalo.me`). Each API explicitly selects its own request transport. */
3615
+
3616
+ declare class ZaloProfileAdsService {
3617
+ private readonly client;
3618
+ constructor(client: ZaloSdkHttpClient);
3619
+ createOaPage(request: ZaloProfileAdsCreateOaPageRequest, options?: RequestOptions): Promise<ZaloProfileAdsCreateOaPageResponse>;
3620
+ uploadOaAvatar(request: ZaloProfileAdsUploadOaAvatarRequest, options?: RequestOptions): Promise<ZaloProfileAdsUploadOaAvatarResponse>;
3621
+ uploadOaCover(request: ZaloProfileAdsUploadOaCoverRequest, options?: RequestOptions): Promise<ZaloProfileAdsUploadOaCoverResponse>;
3622
+ getProvinces(options?: RequestOptions): Promise<ZaloProfileAdsGetProvincesResponse>;
3623
+ getDistricts(request: ZaloProfileAdsGetDistrictsRequest, options?: RequestOptions): Promise<ZaloProfileAdsGetDistrictsResponse>;
2757
3624
  }
2758
3625
 
2759
3626
  /** Lấy thông tin công khai của Zalo Official Account theo OA ID, gồm tên, mô tả, ảnh đại diện và cấu trúc menu. Đây là detail tool thuộc lane zalo-ads-page; dùng khi đã có OA ID và cần xác thực hoặc hiển thị thông tin OA trước khi liên kết với luồng quảng cáo. */
@@ -2906,6 +3773,8 @@ declare class ZaloAdsSdk {
2906
3773
  readonly ads: ZaloAdsService;
2907
3774
  readonly forms: ZaloFormsService;
2908
3775
  readonly instantPages: ZaloInstantPagesService;
3776
+ readonly profileAds: ZaloProfileAdsService;
3777
+ readonly profile: ZaloProfileAdsService;
2909
3778
  readonly widget: ZaloWidgetApiService;
2910
3779
  readonly chatWidget: ZaloChatWidgetService;
2911
3780
  constructor(options?: ZaloAdsSdkOptions | string);
@@ -3062,4 +3931,4 @@ declare class ZaloAdsIntegrationManager {
3062
3931
  get poolSize(): number;
3063
3932
  }
3064
3933
 
3065
- export { ALL_ZALO_ADS_DOMAINS, type BodyType, type FileDownloadResponse, type FileInput, type HttpMethod, MemoryZaloSessionStore, type MemoryZaloSessionStoreOptions, type OperationDefinition, RedisZaloSessionStore, type RedisZaloSessionStoreOptions, type RequestOptions, TieredZaloSessionStore, type TieredZaloSessionStoreOptions, ZaloAdsIntegrationManager as ZaloAdsAccountPool, type ZaloAdsChangeAutomatedRuleStatusRequest, type ZaloAdsChangeAutomatedRuleStatusResponse, type ZaloAdsChangeCampaignStatusRequest, type ZaloAdsChangeCampaignStatusResponse, type ZaloAdsClientRequest, type ZaloAdsCreateAutomatedRuleRequest, type ZaloAdsCreateAutomatedRuleResponse, type ZaloAdsCreateCustomAudienceRequest, type ZaloAdsCreateCustomAudienceResponse, type ZaloAdsCreateDisplayCampaignRequest, type ZaloAdsCreateDisplayCampaignResponse, type ZaloAdsCreateEcommerceCampaignRequest, type ZaloAdsCreateEcommerceCampaignResponse, ZaloAdsCreateFlowRequest, ZaloAdsCreateFlowResponse, type ZaloAdsCreateFormCampaignRequest, type ZaloAdsCreateFormCampaignResponse, type ZaloAdsCreateFormRequest, type ZaloAdsCreateFormResponse, type ZaloAdsCreateMessageCampaignRequest, type ZaloAdsCreateMessageCampaignResponse, type ZaloAdsCreateOfficialAccountCampaignRequest, type ZaloAdsCreateOfficialAccountCampaignResponse, ZaloAdsCreatePostCampaignRequest, ZaloAdsCreatePostCampaignResponse, type ZaloAdsCreateVideoCampaignRequest, type ZaloAdsCreateVideoCampaignResponse, type ZaloAdsCreateWebsiteCampaignRequest, type ZaloAdsCreateWebsiteCampaignResponse, type ZaloAdsDeleteAutomatedRuleRequest, type ZaloAdsDeleteAutomatedRuleResponse, type ZaloAdsDeleteCampaignRequest, type ZaloAdsDeleteCampaignResponse, type ZaloAdsDeleteConversionRequest, type ZaloAdsDeleteConversionResponse, type ZaloAdsDeleteCustomAudienceRequest, type ZaloAdsDeleteCustomAudienceResponse, type ZaloAdsDomain, ZaloAdsFlowButtonDto, ZaloAdsFlowChildMessageDto, ZaloAdsFlowMessageDto, type ZaloAdsGetAdByIdRequest, type ZaloAdsGetAdByIdResponse, type ZaloAdsGetAdChangeLogRequest, type ZaloAdsGetAdChangeLogResponse, type ZaloAdsGetApiAdGetlistadadvancetargetingRequest, type ZaloAdsGetApiAdGetlistadadvancetargetingResponse, type ZaloAdsGetApiBaAccountAllaccessorsRequest, type ZaloAdsGetApiBaAccountAllaccessorsResponse, type ZaloAdsGetApiBaAccountAllgrantedmembersRequest, type ZaloAdsGetApiBaAccountAllgrantedmembersResponse, type ZaloAdsGetApiConversionAllRequest, type ZaloAdsGetApiConversionAllResponse, type ZaloAdsGetApiConversionStandardEventsRequest, type ZaloAdsGetApiConversionStandardEventsResponse, type ZaloAdsGetApiCustomAudienceAllRequest, type ZaloAdsGetApiCustomAudienceAllResponse, type ZaloAdsGetApiFilegroupsRequest, type ZaloAdsGetApiFilegroupsResponse, type ZaloAdsGetApiLpNewsRequest, type ZaloAdsGetApiLpNewsResponse, type ZaloAdsGetApiMediaItemsRequest, type ZaloAdsGetApiMediaItemsResponse, type ZaloAdsGetApiMemberFilesRequest, type ZaloAdsGetApiMemberFilesResponse, type ZaloAdsGetApiNotifiesHeaderRequest, type ZaloAdsGetApiNotifiesHeaderResponse, type ZaloAdsGetApiPaymentTransactionHistoryRequest, type ZaloAdsGetApiPaymentTransactionHistoryResponse, type ZaloAdsGetApiPlaceGetalldistrictsRequest, type ZaloAdsGetApiPlaceGetalldistrictsResponse, type ZaloAdsGetApiSpellCheckV2Request, type ZaloAdsGetApiSpellCheckV2Response, type ZaloAdsGetApiWhoamiRequest, type ZaloAdsGetApiWhoamiResponse, type ZaloAdsGetReportapiV2AdsRequest, type ZaloAdsGetReportapiV2AdsResponse, type ZaloAdsGetReportapiV2CampaignsRequest, type ZaloAdsGetReportapiV2CampaignsResponse, type ZaloAdsGetReportapiV2UniqueUserRequest, type ZaloAdsGetReportapiV2UniqueUserResponse, type ZaloAdsGetReportapiV3CampaignsRequest, type ZaloAdsGetReportapiV3CampaignsResponse, type ZaloAdsGetZaapiCampaignReportcampaignRequest, type ZaloAdsGetZaapiCampaignReportcampaignResponse, type ZaloAdsGetZaapiCheckcamphasmanyadsRequest, type ZaloAdsGetZaapiCheckcamphasmanyadsResponse, type ZaloAdsGetZaapiGetadsfromcampaignidRequest, type ZaloAdsGetZaapiGetadsfromcampaignidResponse, type ZaloAdsGetZaapiGetallpagesRequest, type ZaloAdsGetZaapiGetallpagesResponse, type ZaloAdsGetZaapiGetownedarticlesRequest, type ZaloAdsGetZaapiGetownedarticlesResponse, type ZaloAdsGetZaapiGetownedpagesRequest, type ZaloAdsGetZaapiGetownedpagesResponse, ZaloAdsIntegrationManager, type ZaloAdsIntegrationManagerOptions, type ZaloAdsListAgencyCustomersWithBudgetRequest, type ZaloAdsListAgencyCustomersWithBudgetResponse, type ZaloAdsListAutomatedRulesRequest, type ZaloAdsListAutomatedRulesResponse, type ZaloAdsListCustomReportsRequest, type ZaloAdsListCustomReportsResponse, type ZaloAdsListFlowsByOfficialAccountRequest, type ZaloAdsListFlowsByOfficialAccountResponse, type ZaloAdsListFormsByOfficialAccountRequest, type ZaloAdsListFormsByOfficialAccountResponse, type ZaloAdsListMiniPagesByTemplateRequest, type ZaloAdsListMiniPagesByTemplateResponse, type ZaloAdsListPersonalPixelLabelsRequest, type ZaloAdsListPersonalPixelLabelsResponse, ZaloAdsMessageAdUpdateDataDto, type ZaloAdsPostApiAdEstimateaudienceRequest, type ZaloAdsPostApiAdEstimateaudienceResponse, type ZaloAdsPostApiMediaSaveRequest, type ZaloAdsPostApiMediaSaveResponse, type ZaloAdsPostApiMemberUploadImageRequest, type ZaloAdsPostApiMemberUploadImageResponse, type ZaloAdsPostZaapiDeleteadRequest, type ZaloAdsPostZaapiDeleteadResponse, type ZaloAdsRenameCampaignRequest, type ZaloAdsRenameCampaignResponse, ZaloAdsSdk, type ZaloAdsSdkOptions, ZaloAdsService, type ZaloAdsUpdateAutomatedRuleRequest, type ZaloAdsUpdateAutomatedRuleResponse, type ZaloAdsUpdateDisplayAdRequest, type ZaloAdsUpdateDisplayAdResponse, type ZaloAdsUpdateEcommerceAdRequest, type ZaloAdsUpdateEcommerceAdResponse, type ZaloAdsUpdateFormAdRequest, type ZaloAdsUpdateFormAdResponse, ZaloAdsUpdateMessageAdRequest, ZaloAdsUpdateMessageAdResponse, type ZaloAdsUpdateNewAdsRequest, type ZaloAdsUpdateNewAdsResponse, 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, ZaloChatWidgetService, type ZaloDomainSession, type ZaloFormSessionProfile, type ZaloFormsAuthSessionOaItem, type ZaloFormsDisableFormLeadNotificationRequest, type ZaloFormsDisableFormLeadNotificationResponse, type ZaloFormsEnableFormLeadNotificationRequest, type ZaloFormsEnableFormLeadNotificationResponse, type ZaloFormsExportFormLeadReportRequest, type ZaloFormsExportFormLeadReportResponse, type ZaloFormsGetAuthSessionResponse, type ZaloFormsListAudienceExclusionTargetingRequest, type ZaloFormsListAudienceExclusionTargetingResponse, type ZaloFormsListConversationLeadsRequest, type ZaloFormsListConversationLeadsResponse, type ZaloFormsListFormLeadsRequest, type ZaloFormsListFormLeadsResponse, type ZaloFormsListManagedFormsByOfficialAccountRequest, type ZaloFormsListManagedFormsByOfficialAccountResponse, type ZaloFormsListSimpleFormsByOfficialAccountRequest, type ZaloFormsListSimpleFormsByOfficialAccountResponse, ZaloFormsService, type ZaloFormsUpdateFormLeadNotificationIntervalRequest, type ZaloFormsUpdateFormLeadNotificationIntervalResponse, type ZaloInstantPagesCloneInstantPageRequest, type ZaloInstantPagesCloneInstantPageResponse, type ZaloInstantPagesGetInstantPageDetailRequest, type ZaloInstantPagesGetInstantPageDetailResponse, type ZaloInstantPagesGetInstantPageSharedUserRequest, type ZaloInstantPagesGetInstantPageSharedUserResponse, type ZaloInstantPagesListInstantPageEditHistoryRequest, type ZaloInstantPagesListInstantPageEditHistoryResponse, type ZaloInstantPagesListInstantPageFormRecordsRequest, type ZaloInstantPagesListInstantPageFormRecordsResponse, type ZaloInstantPagesListInstantPageLeadsRequest, type ZaloInstantPagesListInstantPageLeadsResponse, type ZaloInstantPagesListInstantPageSharesRequest, type ZaloInstantPagesListInstantPageSharesResponse, type ZaloInstantPagesListInstantPageUsersRequest, type ZaloInstantPagesListInstantPageUsersResponse, type ZaloInstantPagesListMiniPageTemplatesRequest, type ZaloInstantPagesListMiniPageTemplatesResponse, type ZaloInstantPagesListOfficialAccountsRequest, type ZaloInstantPagesListOfficialAccountsResponse, type ZaloInstantPagesOfficialAccountItem, type ZaloInstantPagesSearchInstantPagesRequest, type ZaloInstantPagesSearchInstantPagesResponse, ZaloInstantPagesService, type ZaloInstantPagesUpdateInstantPageRequest, type ZaloInstantPagesUpdateInstantPageResponse, type ZaloIntegrationCredentials, type ZaloIntegrationVerificationResult, type ZaloPlaySessionPayload, 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 };
3934
+ 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 };