interactOA

Cập nhật lần cuối: 23/5/2025

Bắt đầu hỗ trợ ở phiên bản:

• SDK: 2.28.8

import { interactOA } from "zmp-sdk/apis";

API yêu cầu người dùng cho phép gửi thông báo thông qua Official Account. Khi gọi api, một thông báo sẽ được hiển thị. Lưu ý, để giúp các nhà phát triển Mini App sử dụng flow xin quyền một cách hiệu quả, cũng như phù hợp với chính sách của Zalo Mini App điều 3.3.4. Mini App Team đã đưa ra một số gợi ý thiết kế trải nghiệm như thông tin bên dưới. Nhà phát triển cần giải thích rõ ràng và trực quan mục đích xin quyền để người dùng dễ dàng hiểu và đồng ý cung cấp thông tin.

Nhằm đảm bảo trải nghiệm thoải mái của người dùng Mini App, chúng tôi sẽ từ chối xét duyệt cho những Mini App có luồng xin cấp quyền chưa rõ ràng, không nêu được mục đích xin quyền đến người dùng. Tham khảo một số trường hợp vi phạm như bên dưới:

Ví dụ

Yêu cầu người dùng cho phép gửi thông báo thông qua Official Account:

await interactOA({
  oaId: "xxxx",
});

Xử lý lỗi:

try {
  await interactOA({
    oaId: "xxxx",
  });
  console.log("Người dùng đã cho phép");
} catch (error) {
  const code = (error as AppError).code;
  if (code === -201) {
    console.log("Người dùng đã từ chối");
  } else {
    console.log("Lỗi khác");
  }
}

Xem hướng dẫn xử lý lỗi và bảng mô tả chi tiết mã lỗi tại đây.

Tham số

Truyền tham số vào API dưới dạng object chứa các thuộc tính:

Name	Type	Default	Description
oaId	string		Id của Official Account.