openProfilePicker

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

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

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

API mở cửa sổ chọn bạn bè trong Zalo, API sẽ trả về danh sách những người được chọn.

openProfilePicker

Ví dụ

Chọn tối đa 2 bạn bè trong danh sách bạn bè của người dùng:

const { users } = await openProfilePicker({
  maxProfile: 2,
});
console.log(users);

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

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

Name	Type	Default	Description
maxProfile	`number`	`1`	Số lượng bạn bè tối đa được chọn. Giới hạn trong khoảng 1 đến 10.

API trả về Promise<OpenProfilePickerReturns> chứa chứa danh sách những bạn bè được chọn.

Name	Type	Default	Description
users	`PickedProfile[]`		Danh sách những bạn bè được chọn.

Name	Type	Description
code	`number`	Mã lỗi: 0: Lấy thông tin của người dùng thành công. 1: Lấy thông tin người dùng thất bại.
id	`string`	Mã người dùng. Chuỗi này là duy nhất cho mỗi người dùng trên mỗi ứng dụng Zalo App. Các Zalo Mini App cùng chung một Zalo App sẽ dùng được mã người dùng của nhau.
message	`string`	Thông báo lỗi.
profile	`ProfileInfo`	Thông tin của người dùng.

Name	Type	Default	Description
avatar	`string`		Ảnh đại diện người dùng.
name	`string`		Tên hiển thị của người dùng.