B3: Cấu hình Zalo Mini App (Đăng ký mới)
Trước khi xây dựng lõi hệ thống mini app qua hệ thống quản trị Evotech, bạn cần có Zalo App ID để kết nối đồng bộ dữ liệu
Nếu chưa có Zalo App
2.Đăng ký Zalo App
Để bắt đầu phát triển Mini App bạn cần phải có Zalo App. Đây là ứng dụng trên nền tảng Zalo, giúp tương tác với API OAuth và những API về dữ liệu khác trên nền tảng Zalo. Một Zalo App có thể chứa nhiều Mini App bên trong.
LƯU Ý:
Nếu bạn đã có Zalo App thì có thể bỏ qua bước này.
Bạn có thể tự thực hiện bước này theo hướng dẫn. Vui lòng bỏ qua nếu đăng ký dịch vụ Thiết lập ban đầu kèm gói phần mềm quản trị của Evotech. Đội ngũ Evotech sẽ thực hiện bước này theo gói dịch vụ đã mua.
Các bước thực hiện:
Cài đặt hệ thống (đăng ký Mini App)
Bước 1 — Khai báo thông tin đăng ký
1.1. Truy cập app.evotech.vn → Ứng dụng của bạn → Zalo Mini App → Nhập đầy đủ thông tin theo yêu cầu → Tích chọn ô "Đồng ý với Thỏa thuận chương trình Zalo Mini App" → nhấn Tiếp tục.
1.2. Tiếp theo cần kết nối thông tin với Ứng dụng gốc, App ID được tạo từ Ứng dụng gốc, Thanh toán và uỷ quyền OA doanh nghiệp
Bước 2 — Lấy thông tin ứng dụng
2.1. Truy cập https://developers.zalo.me/apps → Bấm Tạo mới để tạo Ứng dụng gốc
2.2. Trong phần Cài đặt chọn Kích hoạt ứng dụng để người dùng bên ngoài có thể sử dụng ứng dụng của bạn.
2.3. Copy trường thông tin ID ứng dụng gốc và Khoá bí mật của ứng dụng trên Zalo for Developers.
2.4. Quay lại app.evotech.vn → vào Ứng dụng của bạn → Zalo Mini App → dán ID ứng dụng và Khoá bí mật của ứng dụng vào hệ thống app.evotech.vn → bấm "Lưu"
2.5. Tiếp theo truy cập miniapp.zaloplatforms.com/developers
Chọn "Tạo Mini App" → Điền các thông tin cần thiết → Sau đó, chọn "Tạo mới"
Sau khi tạo Mini App, bạn sẽ nhận được Mini App ID. ID này sẽ được dùng cho bước tiếp theo.
Thay đổi thông tin sau khi tạo Mini App
Trước khi tiến hành Tạo ứng dụng, vui lòng kiểm tra kỹ các thông tin bạn đã nhập. Nếu có yêu cầu thay đổi thông tin sau khi đã tạo ứng dụng, bạn cần tạo một ticket hỗ trợ thông qua hệ thống và chờ đợi xác nhận từ bộ phận kiểm duyệt.
2.6. Tiếp tục truy cập Chọn Mini App để lấy App ID
2.7. Copy trường thông tin App ID vào hệ thống app.evotech.vn
Bước 3 — Lấy thông tin thanh toán
Cần khai báo thêm Checkout Secret Key để mini app xử lý được thanh toán. Cách lấy:
Vào miniapp.zaloplatforms.com → Checkout SDK → Cấu hình chung → Copy mục Private Key
Quay lại Evotech → Ứng dụng của bạn → Zalo Mini App → Cài đặt hệ thống → dán vào mục Checkout Secret Key → nhấn Lưu
Bước 4 — Uỷ quyền OA
Truy cập vào trang miniapp.zaloplatforms.com → Vào Mini App cần chọn
Vào mục Quản lý → Quản lý xác thực → Nhập OA ID doanh nghiệp của bạn
Bấm Xác thực → Xác nhận
Admin Zalo OA doanh nghiệp sẽ nhận thông báo về tài khoản Zalo. Bấm Phản hồi và xác nhận.
Truy cập vào trang app.evotech.vn → vào Ứng dụng của bạn → Zalo Mini App → bấm Uỷ quyền lại trong mục Liên kết Zalo OA
Sau đó, cửa sổ chuyển tiếp sang trang cấp quyền cho ứng dụng như bên dưới (lưu ý cần truy cập tài khoản Zalo OA trên cùng một trình duyệt này):
Tại đây, Admin chọn tài khoản OA cần cấp quyền và chọn “Cho phép” để xác nhận cấp quyền.
Bước 5 — Build Mini App
B1 — Tạo bản build
Ứng dụng của bạn → Zalo Mini App → Cài đặt hệ thống → nhấn Build phiên bản mới.
B2 — Khai báo số phiên bản
Nhập số phiên bản tiếp theo tại mục Phiên bản (phải lớn hơn phiên bản hiện tại) → nhấn OK.
B3 — Gửi xét duyệt
Vào lại mục Phiên bản → nhấn Gửi xét duyệt.
Lưu ý
Sau khi gửi xét duyệt, Zalo cần khoảng 3 – 5 ngày làm việc để trả kết quả duyệt hoặc từ chối.
Hữu ích — Checklist giúp Mini App được duyệt nhanh
1. Sản phẩm vào giỏ hàng không lỗi
– Trang chủ → Giỏ hàng → Thêm vào giỏ hàng — không báo lỗi tồn kho, hết hàng
– Trang chủ → Giỏ hàng → tăng/giảm số lượng sản phẩm hoạt động đúng
– Trang chủ → Sản phẩm — ảnh hiển thị đúng, không vỡ/lỗi; tên, giá, phân loại (size/màu) chính xác
– Trang chủ → Giỏ hàng — tích chọn và xóa sản phẩm hoạt động đúng
– Trang chủ → Giỏ hàng — tổng tiền thanh toán khớp với số lượng × giá
2. Phương thức thanh toán
– Giỏ hàng → Thanh toán → có đầy đủ, hoặc ít nhất 1 phương thức thanh toán
– Thông tin thanh toán hiển thị rõ ràng, dễ hiểu
– Không bị lỗi trắng trang khi tải phương thức thanh toán
– Đặt hàng và áp dụng ưu đãi hoạt động bình thường
3. Đặt hàng thành công
– Trang chủ → Danh mục → Thêm vào giỏ hàng → Giỏ hàng → Thanh toán
– Trang chủ → Danh mục → Chi tiết sản phẩm → Thêm giỏ → Giỏ hàng → Thanh toán
– Trang chủ → Chi tiết sản phẩm → Mua ngay → Thanh toán
4. Điều khoản & chính sách
– Cá nhân → Về chúng tôi → Điều khoản & chính sách: đầy đủ Điều khoản sử dụng nền tảng, Chính sách thanh toán hoàn tiền, Chính sách đổi trả, Chính sách giao hàng (tiêu đề, nội dung, font hiển thị đúng)
5. Mục "Mua ngay"
– Trang chủ → Chi tiết sản phẩm → Mua ngay — không tải trắng trang
– Trang chủ → Chi tiết sản phẩm → Mua ngay → đặt hàng thành công
Lợi ích khi đăng ký Zalo Mini App
Tiếp cận thêm tập khách hàng lớn đang sử dụng Zalo mà không cần cài thêm ứng dụng
Đồng bộ dữ liệu sản phẩm, đơn hàng, thanh toán với hệ thống Evotech đang vận hành
Tự chủ quy trình build và gửi duyệt phiên bản ngay trong Evotech, không cần công cụ ngoài
Sau khi tạo Mini App, bạn sẽ nhận được Mini App ID. ID này sẽ được dùng cho bước tiếp theo.
THAY ĐỔI THÔNG TIN SAU KHI TẠO MINI APP
Trước khi tiến hành Tạo ứng dụng, vui lòng kiểm tra kỹ các thông tin bạn đã nhập. Nếu có yêu cầu thay đổi thông tin sau khi đã tạo ứng dụng, bạn cần tạo một ticket hỗ trợ thông qua hệ thống và chờ đợi xác nhận từ bộ phận kiểm duyệt.
LƯU Ý: PHÂN BIỆT ZALO APP (ID ỨNG DỤNG GỐC) VỚI MINI APP (APP ID)
Trong hệ thống quản lý của Zalo Platform, Ứng dụng gốc (Zalo App) và Mini App là hai cấp độ khác nhau trong việc định danh và phát triển dịch vụ.
1. Bản chất và mối quan hệ
Ứng dụng gốc (Zalo App): Là "tài khoản gốc" hoặc cổng kết nối chính thức được tạo trên Zalo for Developer. Nó đóng vai trò xác thực danh tính của nhà phát triển/doanh nghiệp với hệ thống Zalo, đồng thời quản lý các kết nối bảo mật, OAuth API và dữ liệu nền tảng.
Mini App: Là ứng dụng con thu gọn (dung lượng dưới 10MB) được tạo ra và chứa bên trong một Ứng dụng gốc (Zalo App).
2. Tiêu chí phân biệt chi tiết
