@softtynet/zca-js 2.3.6 → 2.3.7

package/README.md

@@ -14,10 +14,11 @@
 
 ## Điểm nổi bật
 
-- **Kiến trúc 12 Domains (`252 API nguyên bản`)**: Tổ chức trực quan qua `api.auth`, `api.chat`, `api.group`, `api.friend`, `api.profile`, `api.sync`, `api.zcloud`, `api.call`, `api.media`, `api.sticker`, `api.board`, `api.business` (vẫn hỗ trợ gọi phẳng `api.<method>` tương thích ngược 100%).
+- **Kiến trúc 12 Domains (`256 API nguyên bản`)**: Tổ chức trực quan qua `api.auth`, `api.chat`, `api.group`, `api.friend`, `api.profile`, `api.sync`, `api.zcloud`, `api.call`, `api.media`, `api.sticker`, `api.board`, `api.business` (vẫn hỗ trợ gọi phẳng `api.<method>` tương thích ngược 100%).
 - **Đồng bộ lịch sử Mobile (`ZDB 4.0`) & Catch-up Sync**: Hỗ trợ đầy đủ luồng `requestSyncFromPhone` $\rightarrow$ `getSyncData` (giải mã RSA-2048 OAEP/PKCS1 + ZDB 4.0 64KB multi-chunk AES-256-CBC + Deflate) & `pullMobile`.
 - **ZCloud, MediaStore & Bảo toàn Số nguyên 64-bit (`preParseJsonIds`)**: Tự động giữ nguyên độ chính xác chuỗi 19 chữ số cho `owner_id`, `group_id`, `globalMsgId`, `cliMsgId` trước khi `JSON.parse()` và tích hợp bộ mã hóa `98yS` AES-256-CBC cho ZCloud/ZFamily.
 - **Zalo Call Engine thuần TypeScript (`30 API` trong `api.call` + `ZaloRtcSession` / `ZaloCallController`)**: Hỗ trợ đầy đủ cả **Gọi Đi** và **Nhận Cuộc Gọi Đến** (Thoại 1-1, Video Call H.264 FU-A Annex-B 2 chiều, Gọi Nhóm), nâng cấp Thoại $\rightarrow$ Video giữa cuộc gọi, bật/tắt Camera/Mic, Tạm giữ (Hold/Unhold), Tái kết nối UDP (`reconnectUdp`), và **Bàn giao kết nối UDP trực tiếp cho Mobile App (`signalingOnly` / `handoffUdpToExternal`)**.
+- **Hội thoại & Quản lý Zalo Official Account (OA) 2 chiều (`api.business.getOAProfile`, `blockOA`, `unblockOA`, `convertOAIds`)**: Tự động bóc tách tin nhắn OA (`pageMsgs`, `chat.list.action`, `footerv2`), giải mã bitmask tích vàng (`isOAVerified`), Zalo Bot (`isZaloBot`), trạng thái DNR (`parseOADnrStatus`) và lắng nghe thời gian thực qua `oa_message` & `oa_event`.
 
 ---
 
@@ -66,7 +67,7 @@ const zalo = new Zalo({ imageMetadataGetter });
 | **Kho lưu trữ & Voice-to-Text** | `api.media` | 8 | [`docs/api/media.md`](docs/api/media.md) |
 | **Nhãn dán & Biểu cảm** | `api.sticker` | 10 | [`docs/api/sticker.md`](docs/api/sticker.md) |
 | **Bảng tin, Bình chọn & Lịch hẹn** | `api.board` | 16 | [`docs/api/board.md`](docs/api/board.md) |
-| **Zalo Business & Danh mục** | `api.business` | 26 | [`docs/api/business.md`](docs/api/business.md) |
+| **Zalo Business, OA & Danh mục** | `api.business` | 30 | [`docs/api/business.md`](docs/api/business.md) |
 
 > Xem tổng quan toàn bộ tài liệu tại [`docs/api/index.md`](docs/api/index.md) hoặc chạy trang tài liệu VitePress cục bộ bằng lệnh `npm run docs:dev`.
 
@@ -161,6 +162,28 @@ const handoffParams = await session.startOutgoingCall("5249661060655759359", {
 });
 ```
 
+### 5. Nhận, Trả lời & Quản lý Zalo Official Account (OA) 2 chiều
+
+```ts
+import { ThreadType } from "@softtynet/zca-js";
+
+// 1) Lấy hồ sơ chi tiết của Zalo OA (tích vàng isVerified, hotline, website, giờ mở cửa, DNR)
+const oaProfile = await api.business.getOAProfile("2359864726282056346");
+console.log(oaProfile.displayName, oaProfile.isVerified, oaProfile.hotline);
+
+// 2) Lắng nghe tin nhắn OA thời gian thực (`oa_chat`, `oa_list`, `info_chat`, `ecard`) và trả lời 2 chiều
+api.listener.on("oa_message", async (msg) => {
+    console.log(`[OA ${msg.oaData?.kind}] ${msg.data.dName}: ${msg.oaData?.text}`);
+    if (!msg.isSelf) {
+        await api.chat.sendMessage({ msg: "Cảm ơn OA!" }, msg.threadId, ThreadType.User);
+    }
+});
+
+// 3) Chặn / Bỏ chặn OA & chuyển đổi OA ID
+await api.business.blockOA("2359864726282056346");
+await api.business.unblockOA("2359864726282056346");
+```
+
 ---
 
 ## Chạy trang Tài liệu (VitePress Docs)

package/dist/apis/business/blockOA.d.ts

@@ -0,0 +1,2 @@
+export type BlockOAResponse = "" | Record<string, unknown>;
+export declare const blockOAFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (oaId: string) => Promise<BlockOAResponse>;

package/dist/apis/business/blockOA.js

@@ -0,0 +1,28 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const blockOAFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/oa/block`);
+    /**
+     * Chặn nhận tin nhắn / thông báo từ một Zalo Official Account (OA).
+     * Tương ứng với hàm `setBlockOA` (`commandId = 12681`) trên Zalo Desktop.
+     *
+     * @param oaId UID hoặc OA ID của Official Account cần chặn
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function blockOA(oaId) {
+        const params = {
+            oaid: String(oaId),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/business/convertOAIds.d.ts

@@ -0,0 +1,4 @@
+export type ConvertOAIdsResponse = {
+    [oaId: string]: string | unknown;
+};
+export declare const convertOAIdsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (oaIds: string | string[]) => Promise<ConvertOAIdsResponse>;

package/dist/apis/business/convertOAIds.js

@@ -0,0 +1,26 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const convertOAIdsFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/oa/convertid`);
+    /**
+     * Chuyển đổi danh sách OA ID sang Zalo UID nội bộ (hoặc ngược lại).
+     * Tương ứng với hàm `convertOAIds` (`commandId = 11863`) trên Zalo Desktop.
+     *
+     * @param oaIds Một OA ID hoặc mảng các OA ID cần chuyển đổi
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function convertOAIds(oaIds) {
+        const normalizedIds = (Array.isArray(oaIds) ? oaIds : [oaIds]).map(String);
+        const params = {
+            oa_ids: normalizedIds,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/business/getOAProfile.d.ts

@@ -0,0 +1,13 @@
+import { type OAProfileInfo } from "../../models/OAMessage.js";
+export type GetOAProfileOptions = {
+    /**
+     * Kích thước ảnh đại diện (mặc định: `240`).
+     */
+    avatarSize?: number;
+    /**
+     * Có lấy kèm thông tin tài khoản Business (`/api/social/friend/get-bizacc`) hay không (mặc định: `true`).
+     */
+    includeBizAccount?: boolean;
+};
+export type GetOAProfileResponse = OAProfileInfo;
+export declare const getOAProfileFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (oaId: string, options?: GetOAProfileOptions) => Promise<GetOAProfileResponse>;

package/dist/apis/business/getOAProfile.js

@@ -0,0 +1,64 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { normalizeOAProfile } from "../../models/OAMessage.js";
+import { apiFactory } from "../../utils.js";
+export const getOAProfileFactory = apiFactory()((api, ctx, utils) => {
+    const profileServiceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/getprofiles/v2`);
+    const bizServiceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/get-bizacc`);
+    /**
+     * Lấy hồ sơ đầy đủ của một Zalo Official Account (OA) theo `oaId`
+     * (bao gồm `oaInfo`, trạng thái tích vàng `isVerified`, `isZaloBot`, `isGroupedMsg`, trạng thái chặn/DNR `dnrStatus`, hotline, website, giờ mở cửa, địa chỉ, danh mục...).
+     *
+     * @param oaId UID của Zalo Official Account
+     * @param options Tùy chọn truy vấn
+     * @throws {ZaloApiError}
+     */
+    return async function getOAProfile(oaId, options = {}) {
+        const cleanId = String(oaId ?? "").trim().split("_")[0];
+        if (!cleanId) {
+            throw new ZaloApiError("Missing oaId");
+        }
+        const profileParams = {
+            phonebook_version: 0,
+            friend_pversion_map: [`${cleanId}_0`],
+            avatar_size: options.avatarSize ?? 240,
+            language: ctx.language ?? "vi",
+            show_online_status: 1,
+            isReqOAInfo: 1,
+            imei: ctx.imei,
+        };
+        const encryptedProfileParams = utils.encodeAES(JSON.stringify(profileParams));
+        if (!encryptedProfileParams) {
+            throw new ZaloApiError("Failed to encrypt OA profile params");
+        }
+        const fetchProfilePromise = utils
+            .request(profileServiceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedProfileParams,
+            }),
+        })
+            .then((res) => utils.resolve(res));
+        const fetchBizPromise = options.includeBizAccount !== false
+            ? (async () => {
+                const encryptedBizParams = utils.encodeAES(JSON.stringify({ fid: cleanId }));
+                if (!encryptedBizParams)
+                    return null;
+                const res = await utils.request(bizServiceURL, {
+                    method: "POST",
+                    body: new URLSearchParams({
+                        params: encryptedBizParams,
+                    }),
+                });
+                return utils.resolve(res);
+            })().catch(() => null)
+            : Promise.resolve(null);
+        const [profileRes, bizRes] = await Promise.all([fetchProfilePromise, fetchBizPromise]);
+        const profileData = (profileRes ?? {});
+        const changedProfiles = (profileData.changed_profiles ?? profileData.profiles ?? {});
+        const rawProfile = changedProfiles[cleanId] ??
+            changedProfiles[`${cleanId}_0`] ??
+            Object.values(changedProfiles)[0] ??
+            null;
+        return normalizeOAProfile(cleanId, rawProfile, bizRes && typeof bizRes === "object" ? bizRes : null);
+    };
+});

package/dist/apis/business/unblockOA.d.ts

@@ -0,0 +1,2 @@
+export type UnblockOAResponse = "" | Record<string, unknown>;
+export declare const unblockOAFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (oaId: string) => Promise<UnblockOAResponse>;

package/dist/apis/business/unblockOA.js

@@ -0,0 +1,28 @@
+import { ZaloApiError } from "../../Errors/ZaloApiError.js";
+import { apiFactory } from "../../utils.js";
+export const unblockOAFactory = apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/oa/unblock`);
+    /**
+     * Bỏ chặn một Zalo Official Account (OA) để tiếp tục nhận tin nhắn / ZNS.
+     * Tương ứng với hàm `setBlockOA` (`commandId = 12682`) trên Zalo Desktop.
+     *
+     * @param oaId UID hoặc OA ID của Official Account cần bỏ chặn
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function unblockOA(oaId) {
+        const params = {
+            oaid: String(oaId),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});

package/dist/apis/chat/preloadConversations.d.ts

@@ -1,4 +1,4 @@
-import { ClearUnread, type Message, type TClearUnreadItem, type TGroupMessage, type TMessage } from "../../models/index.js";
+import { ClearUnread, UserMessage, type Message, type TClearUnreadItem, type TGroupMessage, type TMessage } from "../../models/index.js";
 export type PreloadConversationsRawResponse = {
     msgs?: TMessage[];
     groupMsgs?: TGroupMessage[];
@@ -6,7 +6,7 @@ export type PreloadConversationsRawResponse = {
         isGroup?: boolean | number;
     })>;
     eeMsgs?: unknown[];
-    pageMsgs?: unknown[];
+    pageMsgs?: TMessage[];
     clearUnreads?: TClearUnreadItem[];
     clearUnreadsReact?: TClearUnreadItem[];
     seens?: unknown[];
@@ -23,6 +23,7 @@ export type PreloadConversationsRawResponse = {
 };
 export type PreloadConversationsResponse = PreloadConversationsRawResponse & {
     messages: Message[];
+    pageMessages: UserMessage[];
     unreadCleared: ClearUnread[];
 };
 export declare const preloadConversationsFactory: (ctx: import("../../context.js").ContextBase, api: import("../../apis.js").API) => (threadIdLocalMsgId?: Record<string, string | number>) => Promise<PreloadConversationsResponse>;

package/dist/apis/chat/preloadConversations.js

@@ -27,6 +27,7 @@ export const preloadConversationsFactory = apiFactory()((api, ctx, utils) => {
                 data = JSON.parse(data);
             }
             const messages = [];
+            const pageMessages = [];
             const seenMsgIds = new Set();
             if (Array.isArray(data.msgs)) {
                 for (const msg of data.msgs) {
@@ -38,6 +39,18 @@ export const preloadConversationsFactory = apiFactory()((api, ctx, utils) => {
                     messages.push(new UserMessage(ctx.uid, msg));
                 }
             }
+            if (Array.isArray(data.pageMsgs)) {
+                for (const msg of data.pageMsgs) {
+                    const id = String(msg.msgId ?? "");
+                    if (id && seenMsgIds.has(id))
+                        continue;
+                    if (id)
+                        seenMsgIds.add(id);
+                    const userMsg = new UserMessage(ctx.uid, msg, true);
+                    pageMessages.push(userMsg);
+                    messages.push(userMsg);
+                }
+            }
             if (Array.isArray(data.groupMsgs)) {
                 for (const msg of data.groupMsgs) {
                     const id = String(msg.msgId ?? "");
@@ -71,6 +84,7 @@ export const preloadConversationsFactory = apiFactory()((api, ctx, utils) => {
             return {
                 ...data,
                 messages,
+                pageMessages,
                 unreadCleared,
             };
         });

package/dist/apis/sync/getSyncData.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import toughCookie from "tough-cookie";
+import * as toughCookie from "tough-cookie";
 import { ZaloApiError } from "../../Errors/ZaloApiError.js";
 import { apiFactory, ZALO_DOMAINS } from "../../utils.js";
 export const getSyncDataFactory = apiFactory()((api, ctx, utils) => {

package/dist/apis.d.ts

@@ -12,6 +12,7 @@ import { analyseGroupFactory } from "./apis/group/analyseGroup.js";
 import { answerAckVoiceCallFactory } from "./apis/call/answerAckVoiceCall.js";
 import { answerGroupCallFactory } from "./apis/call/answerGroupCall.js";
 import { answerVoiceCallFactory } from "./apis/call/answerVoiceCall.js";
+import { blockOAFactory } from "./apis/business/blockOA.js";
 import { blockUserFactory } from "./apis/friend/blockUser.js";
 import { blockViewFeedFactory } from "./apis/friend/blockViewFeed.js";
 import { broadcastGroupCallStateFactory } from "./apis/call/broadcastGroupCallState.js";
@@ -25,6 +26,7 @@ import { changeGroupNameFactory } from "./apis/group/changeGroupName.js";
 import { changeGroupOwnerFactory } from "./apis/group/changeGroupOwner.js";
 import { checkQuotaCommunityMemberFactory } from "./apis/group/checkQuotaCommunityMember.js";
 import { clearUnreadFriendRequestsFactory } from "./apis/friend/clearUnreadFriendRequests.js";
+import { convertOAIdsFactory } from "./apis/business/convertOAIds.js";
 import { createAutoReplyFactory } from "./apis/business/createAutoReply.js";
 import { createBankAccountFactory } from "./apis/business/createBankAccount.js";
 import { createCatalogFactory } from "./apis/business/createCatalog.js";
@@ -126,6 +128,7 @@ import { getMultiGroupCloudMessagesFactory } from "./apis/group/getMultiGroupClo
 import { getMultiUsersByPhonesFactory } from "./apis/friend/getMultiUsersByPhones.js";
 import { getMuteFactory } from "./apis/chat/getMute.js";
 import { getNoisedIdsFactory } from "./apis/auth/getNoisedIds.js";
+import { getOAProfileFactory } from "./apis/business/getOAProfile.js";
 import { getOwnIdFactory } from "./apis/auth/getOwnId.js";
 import { getPendingGroupMembersFactory } from "./apis/group/getPendingGroupMembers.js";
 import { getPersonalizedStickerListFactory } from "./apis/sticker/getPersonalizedStickerList.js";
@@ -221,6 +224,7 @@ import { setMuteFactory } from "./apis/chat/setMute.js";
 import { setPinnedConversationsFactory } from "./apis/chat/setPinnedConversations.js";
 import { sharePollFactory } from "./apis/board/sharePoll.js";
 import { shareScreenGroupCallFactory } from "./apis/call/shareScreenGroupCall.js";
+import { unblockOAFactory } from "./apis/business/unblockOA.js";
 import { unblockUserFactory } from "./apis/friend/unblockUser.js";
 import { undoFactory } from "./apis/chat/undo.js";
 import { undoFriendRequestFactory } from "./apis/friend/undoFriendRequest.js";
@@ -289,6 +293,8 @@ export type BoardDomainAPI = {
 };
 export type BusinessDomainAPI = {
     readonly addQuickMessage: ReturnType<typeof addQuickMessageFactory>;
+    readonly blockOA: ReturnType<typeof blockOAFactory>;
+    readonly convertOAIds: ReturnType<typeof convertOAIdsFactory>;
     readonly createAutoReply: ReturnType<typeof createAutoReplyFactory>;
     readonly createBankAccount: ReturnType<typeof createBankAccountFactory>;
     readonly createCatalog: ReturnType<typeof createCatalogFactory>;
@@ -303,10 +309,12 @@ export type BusinessDomainAPI = {
     readonly getLabels: ReturnType<typeof getLabelsFactory>;
     readonly getListBank: ReturnType<typeof getListBankFactory>;
     readonly getListBankAccount: ReturnType<typeof getListBankAccountFactory>;
+    readonly getOAProfile: ReturnType<typeof getOAProfileFactory>;
     readonly getProductCatalogList: ReturnType<typeof getProductCatalogListFactory>;
     readonly getQuickMessageList: ReturnType<typeof getQuickMessageListFactory>;
     readonly registerCatalog: ReturnType<typeof registerCatalogFactory>;
     readonly removeQuickMessage: ReturnType<typeof removeQuickMessageFactory>;
+    readonly unblockOA: ReturnType<typeof unblockOAFactory>;
     readonly updateAutoReply: ReturnType<typeof updateAutoReplyFactory>;
     readonly updateBankAccount: ReturnType<typeof updateBankAccountFactory>;
     readonly updateCatalog: ReturnType<typeof updateCatalogFactory>;
@@ -562,6 +570,7 @@ export declare class API {
     get answerAckVoiceCall(): ReturnType<typeof answerAckVoiceCallFactory>;
     get answerGroupCall(): ReturnType<typeof answerGroupCallFactory>;
     get answerVoiceCall(): ReturnType<typeof answerVoiceCallFactory>;
+    get blockOA(): ReturnType<typeof blockOAFactory>;
     get blockUser(): ReturnType<typeof blockUserFactory>;
     get blockViewFeed(): ReturnType<typeof blockViewFeedFactory>;
     get broadcastGroupCallState(): ReturnType<typeof broadcastGroupCallStateFactory>;
@@ -575,6 +584,7 @@ export declare class API {
     get changeGroupOwner(): ReturnType<typeof changeGroupOwnerFactory>;
     get checkQuotaCommunityMember(): ReturnType<typeof checkQuotaCommunityMemberFactory>;
     get clearUnreadFriendRequests(): ReturnType<typeof clearUnreadFriendRequestsFactory>;
+    get convertOAIds(): ReturnType<typeof convertOAIdsFactory>;
     get createAutoReply(): ReturnType<typeof createAutoReplyFactory>;
     get createBankAccount(): ReturnType<typeof createBankAccountFactory>;
     get createCatalog(): ReturnType<typeof createCatalogFactory>;
@@ -676,6 +686,7 @@ export declare class API {
     get getMultiUsersByPhones(): ReturnType<typeof getMultiUsersByPhonesFactory>;
     get getMute(): ReturnType<typeof getMuteFactory>;
     get getNoisedIds(): ReturnType<typeof getNoisedIdsFactory>;
+    get getOAProfile(): ReturnType<typeof getOAProfileFactory>;
     get getOwnId(): ReturnType<typeof getOwnIdFactory>;
     get getPendingGroupMembers(): ReturnType<typeof getPendingGroupMembersFactory>;
     get getPersonalizedStickerList(): ReturnType<typeof getPersonalizedStickerListFactory>;
@@ -771,6 +782,7 @@ export declare class API {
     get setPinnedConversations(): ReturnType<typeof setPinnedConversationsFactory>;
     get sharePoll(): ReturnType<typeof sharePollFactory>;
     get shareScreenGroupCall(): ReturnType<typeof shareScreenGroupCallFactory>;
+    get unblockOA(): ReturnType<typeof unblockOAFactory>;
     get unblockUser(): ReturnType<typeof unblockUserFactory>;
     get undo(): ReturnType<typeof undoFactory>;
     get undoFriendRequest(): ReturnType<typeof undoFriendRequestFactory>;

package/dist/apis.js

@@ -12,6 +12,7 @@ import { analyseGroupFactory } from "./apis/group/analyseGroup.js";
 import { answerAckVoiceCallFactory } from "./apis/call/answerAckVoiceCall.js";
 import { answerGroupCallFactory } from "./apis/call/answerGroupCall.js";
 import { answerVoiceCallFactory } from "./apis/call/answerVoiceCall.js";
+import { blockOAFactory } from "./apis/business/blockOA.js";
 import { blockUserFactory } from "./apis/friend/blockUser.js";
 import { blockViewFeedFactory } from "./apis/friend/blockViewFeed.js";
 import { broadcastGroupCallStateFactory } from "./apis/call/broadcastGroupCallState.js";
@@ -25,6 +26,7 @@ import { changeGroupNameFactory } from "./apis/group/changeGroupName.js";
 import { changeGroupOwnerFactory } from "./apis/group/changeGroupOwner.js";
 import { checkQuotaCommunityMemberFactory } from "./apis/group/checkQuotaCommunityMember.js";
 import { clearUnreadFriendRequestsFactory } from "./apis/friend/clearUnreadFriendRequests.js";
+import { convertOAIdsFactory } from "./apis/business/convertOAIds.js";
 import { createAutoReplyFactory } from "./apis/business/createAutoReply.js";
 import { createBankAccountFactory } from "./apis/business/createBankAccount.js";
 import { createCatalogFactory } from "./apis/business/createCatalog.js";
@@ -126,6 +128,7 @@ import { getMultiGroupCloudMessagesFactory } from "./apis/group/getMultiGroupClo
 import { getMultiUsersByPhonesFactory } from "./apis/friend/getMultiUsersByPhones.js";
 import { getMuteFactory } from "./apis/chat/getMute.js";
 import { getNoisedIdsFactory } from "./apis/auth/getNoisedIds.js";
+import { getOAProfileFactory } from "./apis/business/getOAProfile.js";
 import { getOwnIdFactory } from "./apis/auth/getOwnId.js";
 import { getPendingGroupMembersFactory } from "./apis/group/getPendingGroupMembers.js";
 import { getPersonalizedStickerListFactory } from "./apis/sticker/getPersonalizedStickerList.js";
@@ -221,6 +224,7 @@ import { setMuteFactory } from "./apis/chat/setMute.js";
 import { setPinnedConversationsFactory } from "./apis/chat/setPinnedConversations.js";
 import { sharePollFactory } from "./apis/board/sharePoll.js";
 import { shareScreenGroupCallFactory } from "./apis/call/shareScreenGroupCall.js";
+import { unblockOAFactory } from "./apis/business/unblockOA.js";
 import { unblockUserFactory } from "./apis/friend/unblockUser.js";
 import { undoFactory } from "./apis/chat/undo.js";
 import { undoFriendRequestFactory } from "./apis/friend/undoFriendRequest.js";
@@ -318,6 +322,8 @@ export class API {
         if (!this._domains.business) {
             const createNamespace = (api) => ({
                 get addQuickMessage() { return api.addQuickMessage; },
+                get blockOA() { return api.blockOA; },
+                get convertOAIds() { return api.convertOAIds; },
                 get createAutoReply() { return api.createAutoReply; },
                 get createBankAccount() { return api.createBankAccount; },
                 get createCatalog() { return api.createCatalog; },
@@ -332,10 +338,12 @@ export class API {
                 get getLabels() { return api.getLabels; },
                 get getListBank() { return api.getListBank; },
                 get getListBankAccount() { return api.getListBankAccount; },
+                get getOAProfile() { return api.getOAProfile; },
                 get getProductCatalogList() { return api.getProductCatalogList; },
                 get getQuickMessageList() { return api.getQuickMessageList; },
                 get registerCatalog() { return api.registerCatalog; },
                 get removeQuickMessage() { return api.removeQuickMessage; },
+                get unblockOA() { return api.unblockOA; },
                 get updateAutoReply() { return api.updateAutoReply; },
                 get updateBankAccount() { return api.updateBankAccount; },
                 get updateCatalog() { return api.updateCatalog; },
@@ -658,6 +666,9 @@ export class API {
     get answerVoiceCall() {
         return (this._cache.answerVoiceCall ??= answerVoiceCallFactory(this.ctx, this));
     }
+    get blockOA() {
+        return (this._cache.blockOA ??= blockOAFactory(this.ctx, this));
+    }
     get blockUser() {
         return (this._cache.blockUser ??= blockUserFactory(this.ctx, this));
     }
@@ -697,6 +708,9 @@ export class API {
     get clearUnreadFriendRequests() {
         return (this._cache.clearUnreadFriendRequests ??= clearUnreadFriendRequestsFactory(this.ctx, this));
     }
+    get convertOAIds() {
+        return (this._cache.convertOAIds ??= convertOAIdsFactory(this.ctx, this));
+    }
     get createAutoReply() {
         return (this._cache.createAutoReply ??= createAutoReplyFactory(this.ctx, this));
     }
@@ -1000,6 +1014,9 @@ export class API {
     get getNoisedIds() {
         return (this._cache.getNoisedIds ??= getNoisedIdsFactory(this.ctx, this));
     }
+    get getOAProfile() {
+        return (this._cache.getOAProfile ??= getOAProfileFactory(this.ctx, this));
+    }
     get getOwnId() {
         return (this._cache.getOwnId ??= getOwnIdFactory(this.ctx, this));
     }
@@ -1285,6 +1302,9 @@ export class API {
     get shareScreenGroupCall() {
         return (this._cache.shareScreenGroupCall ??= shareScreenGroupCallFactory(this.ctx, this));
     }
+    get unblockOA() {
+        return (this._cache.unblockOA ??= unblockOAFactory(this.ctx, this));
+    }
     get unblockUser() {
         return (this._cache.unblockUser ??= unblockUserFactory(this.ctx, this));
     }

package/dist/cjs/apis/business/blockOA.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const blockOAFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/oa/block`);
+    /**
+     * Chặn nhận tin nhắn / thông báo từ một Zalo Official Account (OA).
+     * Tương ứng với hàm `setBlockOA` (`commandId = 12681`) trên Zalo Desktop.
+     *
+     * @param oaId UID hoặc OA ID của Official Account cần chặn
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function blockOA(oaId) {
+        const params = {
+            oaid: String(oaId),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.blockOAFactory = blockOAFactory;

package/dist/cjs/apis/business/convertOAIds.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const convertOAIdsFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/oa/convertid`);
+    /**
+     * Chuyển đổi danh sách OA ID sang Zalo UID nội bộ (hoặc ngược lại).
+     * Tương ứng với hàm `convertOAIds` (`commandId = 11863`) trên Zalo Desktop.
+     *
+     * @param oaIds Một OA ID hoặc mảng các OA ID cần chuyển đổi
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function convertOAIds(oaIds) {
+        const normalizedIds = (Array.isArray(oaIds) ? oaIds : [oaIds]).map(String);
+        const params = {
+            oa_ids: normalizedIds,
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(utils.makeURL(serviceURL, { params: encryptedParams }), {
+            method: "GET",
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.convertOAIdsFactory = convertOAIdsFactory;

package/dist/cjs/apis/business/getOAProfile.cjs

@@ -0,0 +1,69 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var OAMessage = require('../../models/OAMessage.cjs');
+var utils = require('../../utils.cjs');
+
+const getOAProfileFactory = utils.apiFactory()((api, ctx, utils) => {
+    const profileServiceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/getprofiles/v2`);
+    const bizServiceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/friend/get-bizacc`);
+    /**
+     * Lấy hồ sơ đầy đủ của một Zalo Official Account (OA) theo `oaId`
+     * (bao gồm `oaInfo`, trạng thái tích vàng `isVerified`, `isZaloBot`, `isGroupedMsg`, trạng thái chặn/DNR `dnrStatus`, hotline, website, giờ mở cửa, địa chỉ, danh mục...).
+     *
+     * @param oaId UID của Zalo Official Account
+     * @param options Tùy chọn truy vấn
+     * @throws {ZaloApiError}
+     */
+    return async function getOAProfile(oaId, options = {}) {
+        const cleanId = String(oaId ?? "").trim().split("_")[0];
+        if (!cleanId) {
+            throw new ZaloApiError.ZaloApiError("Missing oaId");
+        }
+        const profileParams = {
+            phonebook_version: 0,
+            friend_pversion_map: [`${cleanId}_0`],
+            avatar_size: options.avatarSize ?? 240,
+            language: ctx.language ?? "vi",
+            show_online_status: 1,
+            isReqOAInfo: 1,
+            imei: ctx.imei,
+        };
+        const encryptedProfileParams = utils.encodeAES(JSON.stringify(profileParams));
+        if (!encryptedProfileParams) {
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt OA profile params");
+        }
+        const fetchProfilePromise = utils
+            .request(profileServiceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedProfileParams,
+            }),
+        })
+            .then((res) => utils.resolve(res));
+        const fetchBizPromise = options.includeBizAccount !== false
+            ? (async () => {
+                const encryptedBizParams = utils.encodeAES(JSON.stringify({ fid: cleanId }));
+                if (!encryptedBizParams)
+                    return null;
+                const res = await utils.request(bizServiceURL, {
+                    method: "POST",
+                    body: new URLSearchParams({
+                        params: encryptedBizParams,
+                    }),
+                });
+                return utils.resolve(res);
+            })().catch(() => null)
+            : Promise.resolve(null);
+        const [profileRes, bizRes] = await Promise.all([fetchProfilePromise, fetchBizPromise]);
+        const profileData = (profileRes ?? {});
+        const changedProfiles = (profileData.changed_profiles ?? profileData.profiles ?? {});
+        const rawProfile = changedProfiles[cleanId] ??
+            changedProfiles[`${cleanId}_0`] ??
+            Object.values(changedProfiles)[0] ??
+            null;
+        return OAMessage.normalizeOAProfile(cleanId, rawProfile, bizRes && typeof bizRes === "object" ? bizRes : null);
+    };
+});
+
+exports.getOAProfileFactory = getOAProfileFactory;

package/dist/cjs/apis/business/unblockOA.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var ZaloApiError = require('../../Errors/ZaloApiError.cjs');
+var utils = require('../../utils.cjs');
+
+const unblockOAFactory = utils.apiFactory()((api, _ctx, utils) => {
+    const serviceURL = utils.makeURL(`${api.zpwServiceMap.profile[0]}/api/social/oa/unblock`);
+    /**
+     * Bỏ chặn một Zalo Official Account (OA) để tiếp tục nhận tin nhắn / ZNS.
+     * Tương ứng với hàm `setBlockOA` (`commandId = 12682`) trên Zalo Desktop.
+     *
+     * @param oaId UID hoặc OA ID của Official Account cần bỏ chặn
+     *
+     * @throws {ZaloApiError}
+     */
+    return async function unblockOA(oaId) {
+        const params = {
+            oaid: String(oaId),
+        };
+        const encryptedParams = utils.encodeAES(JSON.stringify(params));
+        if (!encryptedParams)
+            throw new ZaloApiError.ZaloApiError("Failed to encrypt params");
+        const response = await utils.request(serviceURL, {
+            method: "POST",
+            body: new URLSearchParams({
+                params: encryptedParams,
+            }),
+        });
+        return utils.resolve(response);
+    };
+});
+
+exports.unblockOAFactory = unblockOAFactory;