Trong quá trình xây dựng và vận hành Zalo Mini App, nhà phát triển có thể cần truy cập một số thông tin hoặc tính năng trên thiết bị của người dùng như vị trí, camera, số điện thoại, QR Code hay bộ nhớ thiết bị. Để đảm bảo tính minh bạch và bảo mật, các quyền này cần được Zalo hoặc người dùng cho phép trước khi sử dụng. Bài viết dưới đây, Abenla sẽ giúp bạn hiểu rõ các nhóm quyền trong Zalo Mini App, danh sách quyền phổ biến và quy trình gửi yêu cầu xét duyệt.

Tổng quan về quyền trong Zalo Mini App

Quyền trong Zalo Mini App là cơ chế cho phép ứng dụng truy cập vào một số tính năng, dữ liệu hoặc thành phần liên quan đến thiết bị, tài khoản Zalo và trải nghiệm sử dụng của người dùng.

Tùy theo loại quyền, nhà phát triển có thể cần xin phê duyệt từ Zalo, xin xác nhận trực tiếp từ người dùng hoặc được sử dụng mặc định. Một số quyền liên quan đến thông tin cá nhân chỉ có hiệu lực trong một khoảng thời gian nhất định và có thể bị thu hồi sau đó.

Để nâng cao trải nghiệm, Mini App cũng hỗ trợ cơ chế ghi nhớ lựa chọn của người dùng trong một số trường hợp phù hợp.

1. Các nhóm quyền có trong Mini App Zalo

Hiện nay, Mini App Zalo có 4 nhóm quyền chính gồm:

User Device Permission

Đây là nhóm quyền liên quan trực tiếp đến thiết bị của người dùng, chẳng hạn như vị trí, camera, rung, lưu ảnh, kết nối mạng hoặc giữ màn hình luôn bật.

User Information Permission

Nhóm quyền này liên quan đến thông tin cá nhân của người dùng, ví dụ như số điện thoại. Với các quyền này, người dùng cần chủ động đồng ý trước khi Mini App có thể truy cập dữ liệu.

Zalo Permission

Zalo Permission là nhóm quyền liên quan đến các tính năng trong hệ sinh thái Zalo, chẳng hạn như mở trình quét QR Code, hiển thị QR OA, chia sẻ thông tin lên nhật ký hoặc mở cửa sổ chat.

Mini App Permission

Đây là nhóm quyền phục vụ các thao tác bên trong Zalo Mini App, chẳng hạn thay đổi màu thanh điều hướng, thay đổi tiêu đề hoặc mở và đóng Mini App.

2. Danh sách quyền trong Zalo Mini App

Nhóm quyền	Quyền	Mô tả	Cần sự cho phép từ
User Device Permission	Mở màn hình cuộc gọi Native	Cho phép ứng dụng mở giao diện gọi điện native và tùy chỉnh số điện thoại.	Mặc định
User Device Permission	Mở màn hình tin nhắn Native	Cho phép ứng dụng mở giao diện nhắn tin native và tùy chỉnh nội dung tin nhắn.	Mặc định
User Device Permission	Shortcut	Cho phép Mini App tạo lối tắt trên màn hình điện thoại.	Zalo
User Device Permission	Hiển thị toast	Cho phép ứng dụng hiển thị thông báo toast trên màn hình điện thoại.	Mặc định
User Device Permission	Lấy thông tin network device	Cho phép ứng dụng lấy thông tin mạng của thiết bị.	Zalo
User Device Permission	Giữ màn hình luôn bật	Cho phép Mini App duy trì trạng thái màn hình luôn sáng.	Zalo
User Device Permission	Sử dụng native storage	Cho phép ứng dụng dùng Native Storage của Zalo để lưu tạm hoặc cache dữ liệu.	Zalo
User Device Permission	Lưu ảnh vào điện thoại	Cho phép lưu ảnh vào thư viện ảnh trên thiết bị.	Zalo
User Device Permission	Ẩn bàn phím	Cho phép ứng dụng ẩn bàn phím trên thiết bị.	Mặc định
User Device Permission	Rung	Cho phép Mini App kích hoạt chế độ rung trên thiết bị.	Zalo
User Device Permission	Vị trí	Cho phép ứng dụng lấy vị trí hiện tại của người dùng.	Zalo và người dùng
User Device Permission	Camera	Cho phép Mini App yêu cầu quyền truy cập camera của thiết bị.	Zalo
User Information Permission	Số điện thoại	Cho phép lấy số điện thoại của người dùng sau khi người dùng đồng ý cấp quyền.	Zalo và người dùng
Zalo Permission	Giao diện chia sẻ nội dung lên nhật ký Zalo	Cho phép mở giao diện để người dùng chia sẻ nội dung lên nhật ký Zalo.	Mặc định
Zalo Permission	Mở Scan QR Code trên Zalo	Cho phép mở tính năng quét QR Code của Zalo và trả về kết quả sau khi quét.	Zalo
Zalo Permission	Chia sẻ màn hình Share với bạn bè trên Zalo	Cho phép người dùng chia sẻ nội dung đến bạn bè trên Zalo.	Mặc định
Zalo Permission	Hiển thị QR OA	Cho phép hiển thị mã QR của Zalo Official Account.	Mặc định
Zalo Permission	Yêu cầu theo dõi hoặc bỏ theo dõi OA	Cho phép mở giao diện để người dùng xác nhận theo dõi hoặc bỏ theo dõi OA.	Mặc định
Zalo Permission	Màn hình chọn bạn bè trên Zalo	Cho phép mở giao diện để người dùng chọn bạn bè trên Zalo.	Mặc định
Zalo Permission	Mở profile User hoặc OA	Cho phép mở trang hồ sơ của người dùng hoặc Official Account.	Mặc định
Zalo Permission	Mở cửa sổ chat trên Zalo	Cho phép Mini App mở cửa sổ chat với người dùng hoặc Official Account.	Mặc định
Mini App Permission	Thay đổi màu navigation bar	Cho phép thay đổi màu sắc thanh điều hướng trong Zalo.	Mặc định
Mini App Permission	Thay đổi title ở navigation bar	Cho phép thay đổi tiêu đề trên thanh điều hướng của Zalo App.	Mặc định
Mini App Permission	Yêu cầu mở Mini App	Cho phép mở một Mini App khác.	Mặc định
Mini App Permission	Yêu cầu đóng Mini App	Cho phép đóng Mini App đang sử dụng.	Mặc định

3. Hướng dẫn xin cấp quyền từ Zalo Mini App

Với các quyền yêu cầu sự phê duyệt từ Zalo, nhà phát triển cần gửi yêu cầu cấp quyền trên hệ thống quản lý Mini App Center. Bộ phận kiểm duyệt sẽ đánh giá yêu cầu trong quá trình xét duyệt phiên bản mới của Mini App.

Bước 1: Truy cập mục Quyền Mini App

Nhà phát triển đăng nhập vào hệ thống Mini App Center, sau đó chọn mục Quyền Mini App trong trang quản lý.

Bước 2: Chọn quyền cần gửi xét duyệt

Tại giao diện quản lý quyền, chọn quyền mà Zalo Mini App cần sử dụng, ví dụ quyền vị trí, camera, lưu ảnh hoặc mở trình quét QR Code.

Bước 3: Mô tả lý do sử dụng quyền

Nhập đầy đủ nội dung mô tả về mục đích sử dụng quyền. Nhà phát triển nên giải thích rõ quyền này phục vụ cho tính năng nào và lý do cần thiết trong quá trình sử dụng Mini App.

Bước 4: Cung cấp hình ảnh minh họa

Bổ sung hình ảnh hoặc màn hình minh họa về vị trí xuất hiện của tính năng trong Zalo Mini App. Điều này giúp bộ phận xét duyệt hiểu rõ ngữ cảnh sử dụng quyền.

Bước 5: Nhập nội dung hiển thị cho người dùng

Nhà phát triển có thể thêm nội dung giải thích quyền để hiển thị cho người dùng khi hệ thống yêu cầu cấp quyền. Phần này là tùy chọn nhưng nên được viết rõ ràng, ngắn gọn và dễ hiểu.

Bước 6: Gửi yêu cầu xét duyệt

Sau khi kiểm tra thông tin, gửi yêu cầu xét duyệt quyền. Khi quá trình xử lý hoàn tất, nhà phát triển sẽ nhận được thông báo qua OA và Mini App Center.

Lưu ý: Nên mô tả rõ ràng lý do sử dụng quyền và đính kèm hình ảnh phù hợp để quá trình xét duyệt Zalo Mini App diễn ra nhanh hơn.

4. Hướng dẫn xin cấp quyền từ người dùng Mini App

Với các quyền cần sự đồng ý trực tiếp từ người dùng, nhà phát triển cần gọi API phù hợp để gửi yêu cầu cấp quyền. Ví dụ, khi Mini App cần truy cập vị trí hoặc số điện thoại, người dùng cần xác nhận trước khi hệ thống trả về dữ liệu.

Để tăng tỷ lệ người dùng đồng ý, Zalo Mini App nên xin quyền đúng thời điểm và đúng bối cảnh sử dụng.

Xin quyền đúng ngữ cảnh

Không nên yêu cầu quá nhiều quyền ngay khi người dùng vừa mở Mini App. Thay vào đó, chỉ nên xin quyền khi người dùng thực sự cần sử dụng một tính năng liên quan.

Ví dụ, Mini App chỉ nên xin quyền vị trí khi người dùng chọn tìm cửa hàng gần nhất, đặt giao hàng hoặc tra cứu dịch vụ theo khu vực. Tương tự, quyền camera nên được yêu cầu khi người dùng thực hiện quét mã QR, chụp ảnh hoặc xác thực thông tin.

Chỉ xin các quyền cần thiết

Khi người dùng mới truy cập Zalo Mini App, nhà phát triển chỉ nên yêu cầu những quyền ảnh hưởng trực tiếp đến chức năng cốt lõi. Việc yêu cầu quyền không cần thiết có thể làm giảm sự tin tưởng và khiến người dùng từ chối cấp quyền.

Giải thích rõ mục đích sử dụng

Trước khi gửi yêu cầu cấp quyền, Mini App nên giải thích ngắn gọn người dùng sẽ nhận được lợi ích gì. Nội dung minh bạch giúp người dùng dễ hiểu hơn và đưa ra quyết định cấp quyền nhanh chóng.

Việc quản lý quyền trong Zalo Mini App đóng vai trò quan trọng trong bảo mật dữ liệu, trải nghiệm người dùng và quá trình xét duyệt ứng dụng. Nhà phát triển cần xác định đúng loại quyền cần sử dụng, gửi yêu cầu xét duyệt đầy đủ khi cần thiết và chỉ xin quyền từ người dùng vào đúng ngữ cảnh. Nếu bạn đang cần thiết kế Zalo Mini App, hãy liên hệ ngay với Abenla để xem báo giá chi tiết.

Xem thêm:

Thông tin liên hệ:

Công ty TNHH ABENLA