Các thuật ngữ và định nghĩa
Nhóm thuật ngữ chung (dành cho Merchant)
- Merchant Doanh nghiệp sở hữu Mini App. Chịu trách nhiệm về hồ sơ pháp lý và nội dung ứng dụng.
- Official Account (OA) Kênh giao tiếp chính thức của doanh nghiệp trên Zalo.
- KYB (Know Your Business) Bộ hồ sơ pháp lý xác minh doanh nghiệp: giấy phép đăng ký kinh doanh, giấy phép ngành nghề (nếu có), giấy tờ chứng minh sở hữu thương hiệu.
- Xác thực Mini App Bước định danh chủ sở hữu hợp pháp của Mini App và các hoạt động kinh doanh của chủ sở hữu trên nền tảng.
- Zalo Mini App Store Kho ứng dụng Mini App trên nền tảng Zalo.
- Trang quản lý Mini App Portal tại mini.zalo.me/developers/ để tạo Mini App, quản lý quyền, gửi phiên bản, xem báo cáo.
- Điểm truy cập (Entry point) Các đường vào Mini App: QR code, shortcut màn hình, từ Mini App khác, tin nhắn share, menu OA, Mini App Store, tìm kiếm Zalo.
Nhóm thuật ngữ kỹ thuật (dành cho Developer)
- Zalo App Ứng dụng đăng ký tại developers.zalo.me. Chứa Mini App bên trong và cung cấp API OAuth cùng các Open API khác.
- Mini App ID Mã định danh Mini App, được cấp sau khi tạo Mini App trên trang quản lý. Dùng trong deeplink
zalo.me/s/{appId}và mọi API. - Access Token Token định danh phiên đăng nhập của user trên Mini App.
- Authentication Token (JWT) Token do server merchant tự phát hành để định danh user cho hệ thống riêng. Khuyến nghị dùng JWT (jwt.io).
- ZMP SDK (zmp-sdk) SDK JavaScript của Zalo Mini App, cung cấp các API: openMiniApp, openWebview, nativeStorage, và các API khác.
- ZJSBridge JavaScript Bridge giữa Mini App và ứng dụng Zalo, cho phép Mini App gọi tính năng nâng cao của hệ thống Zalo.
- ZaUI Components Bộ UI Components đã chuẩn hóa theo phong cách thiết kế Zalo.
- Checkout SDK SDK riêng cho luồng thanh toán trong Mini App. Mini App có tính năng thanh toán phải tích hợp Checkout SDK.
- Webview Cửa sổ hiển thị website bên ngoài, mở trong Mini App qua API openWebview từ zmp-sdk.
- Deeplink Mini App URL dạng
https://zalo.me/s/{appId}/?variable=valuedùng để mở Mini App từ bên ngoài Zalo. - Origin Mini App Domain mà Mini App chạy trên đó: https://h5.zdn.vn.
- Secure Context Môi trường Web yêu cầu HTTPS + domain hợp lệ + SSL còn hạn. Mini App chạy trong Secure Context.
- Native Storage Cơ chế lưu trữ local của Zalo Mini App, thay thế LocalStorage/SessionStorage/Cookie. Tối đa 5MB, tự động xoá dữ liệu cũ khi đầy.
- Nhóm quyền Bốn nhóm quyền trong Zalo Mini App: User Device Permission, User Information Permission, Zalo Permission, Mini App Permission.
- zDebug=true Query parameter thêm vào deeplink để hiện icon Debug trên phiên bản Live, cho phép xem Console logs, Network requests, Element inspector.
- Zalo Mini App Studio / Extension / CLI Ba công cụ phát triển: Studio, Extension (VSCode), CLI.
- OpenAPI (Zalo) Nhóm API cần gọi từ Server-to-Server, dùng App Secret / Private Key.
