--- sourceType: official-guide sourceTypeMatchedRule: fallback slug: MA/intro/request-permission title: Hướng dẫn xin cấp quyền trong Zalo Mini App --- ## **Tổng quan** Trong quá trình phát triển Mini App sẽ có những tính năng cần phải truy cập vào các thông tin của người dùng. Các quyền này cần sự đồng ý và cho phép của người dùng. ### **1. Các nhóm quyền có trong Zalo Mini App** Trong Zalo Mini App có 4 nhóm quyền như sau: #### User Device Permission Là các quyền liên quan đến thiết bị của người dùng. Ví dụ: location, camera,... #### User Information Permission Là các quyền liên quan đến thông tin cá nhân của người dùng: Ví dụ: số điện thoại, ... Để đảm bảo về tính bảo mật cho người dùng, các quyền này chỉ có hiệu lực trong một khoảng thời gian. Quá thời gian này, các quyền sẽ được thu hồi. Vì vậy, Zalo Mini App cung cấp tính năng để User ghi nhớ lựa chọn. #### Zalo Permission Là các quyền liên quan đến các tính năng của Zalo. Ví dụ: mở scan QR Code trên Zalo, hiển thị QR OA, ... #### Mini App Permission Là các quyền liên quan đến các tính năng trên Mini App. Ví dụ: thay đổi màu của navigation bar, đóng/mở Mini App. ### **2. Danh sách quyền** | Nhóm quyền | Quyền | Mô tả | Cần sự cho phép từ | | --- | --- | --- | --- | | User Device Permisison | Mở màn hình cuộc gọi Native | Cho phép ứng dụng mở màn hình cuộc gọi native có thể tuỳ chỉnh số điện thoại | Mặc định | | User Device Permisison | Mở màn hình tin nhắn Native | Cho phép ứng dụng mở màn hình tin nhắn native có thể tuỳ chỉnh nội dung tin nhắn | Mặc định | | User Device Permisison | Shortcut | Cho phép ứng dụng tạo lối tắt trên màn hình điện thoại | Zalo | | User Device Permisison | Hiển thị toast | Cho phép ứng dụng hiển thị toast trên màn hình điện thoại | Mặc định | | User Device Permisison | Lấy thông tin network device | Cho phép ứng dụng lấy thông tin network của device | Zalo | | User Device Permisison | Giữ màn hình luôn bật | Cho phép ứng dụng giữ cho màn hình luôn bật | Zalo | | User Device Permisison | Sử dụng native storage | Cho phép ứng dụng sử dụng Native Storage của Zalo App để caching dữ liệu | Zalo | | User Device Permisison | Lưu ảnh vào điện thoại | Lưu ảnh vào thư viện ảnh của điện thoại | Zalo | | User Device Permisison | Ẩn bàn phím | Cho phép ứng dụng ẩn bàn phím | Mặc định | | User Device Permisison | Rung | Kích hoạt chế độ rung trên thiết bị | Zalo | | User Device Permisison | Vị trí | Cho phép ứng dụng lấy thông tin vị trí hiện tại của người dùng | Zalo & User | | User Device Permisison | Camera | Cho phép ứng dụng yêu cầu device cấp quyền truy cập camera | Zalo | | User Information Permisison | Số điện thoại | Lấy thông tin số điện thoại của người dùng. Một thông báo xin cấp quyền sẽ được hiển thị sau khi gọi API. Chỉ lấy được thông tin số điện thoại nếu người dùng đồng ý cấp quyền | Zalo & User | | Zalo Permission | Mở giao diện chia sẻ lên nhật ký Zalo | Cho phép ứng dụng mở giao diện chia sẻ để người dùng chia sẻ thông tin lên nhật ký Zalo | Mặc định | | Zalo Permission | Mở Scan QR Code trên Zalo | Cho phép ứng dụng mở tính năng quét QR Code của Zalo và trả về kết quả sau khi người dùng quét ... | Zalo | | Zalo Permission | Mở màn hình Share với bạn bè trên Zalo | Cho phép ứng dụng mở giao diện chia sẻ để người dùng chia sẻ thông tin với bạn bè Zalo. | Mặc định | | Zalo Permission | Hiển thị QR OA | Cho phép ứng dụng hiển thị QR code của Official Account | Mặc định | | Zalo Permission | Yêu cầu theo dõi/bỏ theo dõi OA | Cho phép ứng dụng hiển thị giao diện yêu cầu theo dõi Official Account để người dùng xác nhận | Mặc định | | Zalo Permission | Màn hình chọn bạn bè trên Zalo | Cho phép ứng dụng hiển thị giao diện yêu cầu bỏ theo dõi Official Account để người dùng xác nhận | Mặc định | | Zalo Permission | Mở profile User or OA | Cho phép mở màn hình chọn bạn bè trong Zalo. API sẽ trả về danh sách những người được chọn | Mặc định | | Zalo Permission | Mở cửa sổ chat trên Zalo | Cho phép ứng dụng mở cửa sổ chat với User hoặc Official Account | Mặc định | | Mini App Permission | Thay đổi màu của navigation bar | Cho phép ứng dụng thay đổi màu của navigation bar | Mặc định | | Mini App Permission | Thay đổi title trên Navigation bar | Cho phép ứng dụng thay đổi title trên thanh navigation bar của Zalo App | Mặc định | | Mini App Permission | Yêu cầu mở Mini App | Cho phép ứng dụng mở Mini App khác | Mặc định | | Mini App Permission | Yêu cầu đóng Mini App | Cho phép ứng dụng đóng Mini App | Mặc định | ## **Hướng dẫn xin cấp quyền từ Zalo Mini App** Đối với các quyền cần sự cho phép từ Zalo Mini App, nhà phát triển cần tạo yêu cầu cấp quyền & có sự cho phép từ Zalo Mini App. Bộ phận kiểm duyệt sẽ xét duyệt yêu cầu cấp quyền khi xét duyệt phiên bản mới. **Hướng dẫn:** #### 1\. Nhà phát triển truy cập vào hệ thống quản lý Mini App Center, click chọn vào mục Quyền Mini App ![zmp deploy](/assets/MA/img/permission/permission-step1.png) #### 2\. Chọn quyền bạn muốn yêu cầu xét duyệt từ Zalo ![zmp deploy](/assets/MA/img/permission/permission-step2.png) #### 3\. Mô tả lý do & hình ảnh của quyền ![zmp deploy](/assets/MA/img/permission/permission-step3.png) #### 4\. Nhà phát triển nhập nội dung mô tả quyền để hiển thị cho người dùng (Tuỳ chọn) ![zmp deploy](/assets/MA/img/permission/permission-step4.png) #### 5\. Gửi xét duyệt ![zmp deploy](/assets/MA/img/permission/permission-step5.png) #### 6\. Sau khi bộ phận xét duyệt xong sẽ có thông báo qua OA & Mini App Center cho nhà phát triển ![zmp deploy](/assets/MA/img/permission/permission-step6.png) :::tip TIP Nhà phát triển vui lòng mô tả rõ lý do & hình ảnh để bộ phận xét duyệt xử lý nhanh hơn ::: ## **Hướng dẫn xin cấp quyền từ người dùng** Đối với các quyền cần sự cho phép từ người dùng, nhà phát triển cần gọi API để xin cấp quyền từ người dùng. Một số gợi ý để nâng cao trải nghiệm cho người dùng khi xin quyền như sau: #### Xin quyền đúng ngữ cảnh - Để người dùng hiểu rõ nhu cầu sử dụng quyền và dễ dàng cấp quyền hơn. Các quyền nên được xin đúng ngữ cảnh sử dụng của người dùng. - Khi mới vào Mini App, chỉ xin các quyền thực sự cần thiết và ảnh hưởng đến các tính năng lõi sau đó của Mini App.