Triển khai Zalo Mini App là lựa chọn phù hợp cho doanh nghiệp muốn xây dựng dịch vụ, bán hàng, chăm sóc khách hàng hoặc triển khai các chương trình tương tác trên nền tảng Zalo. Tuy nhiên, với những người mới bắt đầu, quá trình triển khai có thể gặp một số vấn đề về tạo ứng dụng, gọi API, phân quyền, đăng nhập, cấu hình kỹ thuật và xét duyệt phiên bản. Bài viết này, Abenla sẽ tổng hợp những tips giúp bạn triển khai Mini App thuận lợi ngay từ dự án đầu tiên.

1. Kích hoạt Zalo App trước khi phát triển Mini App

Bước đầu tiên khi phát triển Zalo Mini App là tạo và kích hoạt Zalo App. Nhiều người thường nhầm lẫn giữa Zalo Mini App ID và Zalo App ID, trong khi đây là hai thông tin có vai trò khác nhau.

Zalo Mini App ID là gì?

Mỗi Zalo Mini App sẽ có một ID riêng để định danh ứng dụng. ID này được sử dụng trong các hoạt động như:

Deploy source code lên Mini App.
Gửi phiên bản xét duyệt.
Xuất bản Mini App.
Chia sẻ Mini App đến người dùng.
Cấu hình một số tính năng liên quan đến ứng dụng.

Zalo App ID là gì?

Zalo App ID, còn được gọi là Zalo Developer ID, dùng để xác định nhà phát triển trong hệ sinh thái Zalo. Khi doanh nghiệp muốn tích hợp các dịch vụ như Zalo OA, ZNS hoặc Zalo Mini App, cần có Zalo App ở trạng thái Đang hoạt động để được cấp quyền truy cập các API liên quan. Do đó, trước khi bắt đầu phát triển Mini App, hãy kiểm tra trạng thái Zalo App trong hệ thống quản lý ứng dụng của Zalo.

Zalo App Name với trạng thái “Đang hoạt động”

2. Thiết lập CORS để Mini App gọi API thành công

Một lỗi kỹ thuật phổ biến khi Zalo Mini App gọi API đến server của doanh nghiệp là lỗi CORS. CORS là cơ chế bảo mật của trình duyệt và webview, giúp kiểm soát những domain nào được phép gửi request đến server. Vì Zalo Mini App chạy trong môi trường webview, server cần cho phép domain của Zalo gọi API. Đây cũng là lý do nhiều nhà phát triển gặp trường hợp API vẫn hoạt động khi kiểm tra bằng Postman hoặc cURL nhưng lại lỗi khi chạy trên Mini App.

Cơ chế CORS

Khi cấu hình server, cần đảm bảo thiết lập header CORS phù hợp để cho phép request từ môi trường Zalo Mini App. Việc này đặc biệt quan trọng với các chức năng như:

Đăng nhập và xác thực người dùng.
Lấy danh sách sản phẩm.
Tạo đơn hàng.
Thanh toán.
Tra cứu thông tin.
Gửi dữ liệu biểu mẫu.
Đồng bộ dữ liệu với hệ thống nội bộ.

3. Tận dụng tài khoản Zalo để đăng nhập Mini App

Một trong những lợi thế lớn của Zalo Mini App là người dùng đã có sẵn tài khoản Zalo khi mở ứng dụng. Vì vậy, trong nhiều trường hợp, Mini App không cần yêu cầu người dùng tạo tài khoản hoặc nhập username, số điện thoại và mật khẩu như Web App thông thường.

Việc tận dụng tài khoản Zalo giúp:

Rút ngắn thao tác đăng nhập.
Giảm tỷ lệ người dùng rời bỏ ứng dụng.
Tạo trải nghiệm liền mạch hơn.
Hỗ trợ cá nhân hóa nội dung và dịch vụ.
Thuận tiện khi triển khai chăm sóc khách hàng qua Zalo OA.

Với các doanh nghiệp đã có hệ thống khách hàng từ website, ứng dụng hoặc cửa hàng trước đó, có thể triển khai cơ chế liên kết tài khoản Zalo Mini App với dữ liệu khách hàng hiện có. Một phương án thường được sử dụng là liên kết bằng số điện thoại. Sau khi liên kết thành công, người dùng có thể xem lại thông tin như đơn hàng, hợp đồng hoặc lịch sử giao dịch đã phát sinh từ các kênh khác.

4. Sử dụng DevTools phù hợp khi phát triển Zalo Mini App

Phát triển Zalo Mini App yêu cầu kiến thức lập trình web cơ bản, bởi ứng dụng cần được xây dựng, chạy thử, kiểm tra lỗi và deploy trước khi phát hành.

Zalo Mini App hiện cung cấp hai bộ công cụ phát triển chính.

Zalo Mini App Studio

Zalo Mini App Studio là công cụ tích hợp gồm trình soạn thảo code và môi trường hỗ trợ chạy thử Mini App trên máy tính.

Công cụ này phù hợp với những người muốn có một bộ môi trường phát triển tương đối đầy đủ, hỗ trợ viết code, kiểm tra ứng dụng và deploy lên Mini App ID.

Zalo Mini App CLI

Zalo Mini App CLI là bộ công cụ dòng lệnh hỗ trợ chạy thử và deploy ứng dụng.

Với CLI, nhà phát triển có thể sử dụng IDE hoặc trình soạn thảo code quen thuộc như Visual Studio Code, sau đó chạy các lệnh bằng Terminal để build, kiểm tra và deploy Mini App.

Việc lựa chọn công cụ nào phụ thuộc vào thói quen làm việc của đội ngũ kỹ thuật. Nếu doanh nghiệp chưa có nhân sự lập trình, có thể làm việc với Agency có kinh nghiệm để được tư vấn giải pháp và phát triển Mini App theo nhu cầu riêng.

5. Xin cấp quyền sử dụng API đúng thời điểm

Để bảo vệ quyền riêng tư của người dùng, một số API nhạy cảm trên Zalo Mini App yêu cầu ứng dụng phải được cấp quyền trước khi sử dụng.

Một số API thường cần đăng ký quyền gồm:

getPhoneNumber
getLocation
getNetworkType
keepScreen
createShortcut
vibrate
requestCameraPermission
saveImageToGallery
openMediaPicker
Các API liên quan đến Native Storage

Bên cạnh quyền từ nền tảng, một số API còn yêu cầu người dùng đồng ý trực tiếp trong quá trình sử dụng. Ví dụ, việc lấy số điện thoại hoặc vị trí người dùng thường cần được xin phép theo đúng ngữ cảnh thao tác.

Do đó, cần phân biệt rõ:

Quyền từ Zalo Mini App Platform: Nhà phát triển gửi yêu cầu để Zalo xét duyệt quyền sử dụng API.
Quyền từ người dùng: Người dùng trực tiếp đồng ý hoặc từ chối cấp quyền khi sử dụng tính năng.

Khi nào nên gửi yêu cầu xét duyệt quyền API?

Thời điểm phù hợp để gửi yêu cầu xin quyền là sau khi đã gửi xét duyệt phiên bản đầu tiên của Mini App. Khi đó, đội ngũ kiểm duyệt có đủ thông tin về giao diện, luồng thao tác và mục đích sử dụng API để đánh giá. Không nên đợi đến khi Mini App đã xuất bản và có người dùng đầu tiên mới bắt đầu xin quyền, vì điều này có thể làm gián đoạn trải nghiệm hoặc ảnh hưởng đến tiến độ triển khai.

Ngoài ra, tài khoản thuộc nhóm Admin, Developer hoặc người dùng thử nghiệm có thể sử dụng nhiều API mà không gặp lỗi quyền. Vì vậy, trước khi phát hành chính thức, nhà phát triển vẫn cần kiểm tra lại danh sách các quyền đã được duyệt cho Mini App.

Gửi yêu cầu xét duyệt quyền sử dụng API Mini App

6. Chuyển đổi dự án Web App có sẵn sang Zalo Mini App

Zalo Mini App có bản chất là Web App chạy trong môi trường Zalo. Vì vậy, một số dự án có kiến trúc phù hợp có thể được tận dụng và chuyển đổi thay vì phải xây dựng hoàn toàn từ đầu.

Cách này phù hợp khi doanh nghiệp đã có sẵn Web App và việc viết lại toàn bộ ứng dụng sẽ tốn nhiều thời gian hoặc chi phí.

Các dự án thường có khả năng chuyển đổi gồm:

Web App dạng Single Page Application.
Dự án sử dụng React, Vue.js hoặc Angular.
Một số dự án Flutter hoặc Next.js có thể build thành Web App.
Ứng dụng có routing phía client bằng JavaScript.

Ngược lại, những website phụ thuộc nhiều vào routing phía server thường khó chuyển đổi trực tiếp sang Zalo Mini App.

Quy trình chuyển đổi cơ bản gồm:

Build source code thành static assets gồm HTML, CSS và JavaScript.
Đảm bảo routing được xử lý phía client.
Khai báo các file CSS và JavaScript cần tải trong app-config.json.
Sử dụng Zalo Mini App CLI để deploy assets lên Mini App ID.
Kiểm tra lại hoạt động của ứng dụng trên môi trường Zalo.

Dù có thể chuyển đổi dự án cũ, với các Mini App mới, doanh nghiệp vẫn nên cân nhắc xây dựng theo hướng phát triển chuẩn ngay từ đầu để dễ tối ưu trải nghiệm, mở rộng tính năng và bảo trì về sau.

7. Chuẩn bị kỹ trước khi gửi xét duyệt Mini App

Xuất bản là bước cuối cùng trong quá trình phát triển Zalo Mini App. Tuy nhiên, để ứng dụng được duyệt thuận lợi, nhà phát triển cần đảm bảo Mini App đáp ứng các tiêu chí kiểm duyệt và không vi phạm thỏa thuận chương trình Zalo Mini App.

Một Mini App thường dễ được xét duyệt hơn khi:

Các tính năng chính hoạt động đầy đủ.
Không xuất hiện màn hình trắng hoặc lỗi không có hướng xử lý.
Luồng người dùng rõ ràng, dễ thao tác.
Nội dung hiển thị chính xác và phù hợp với lĩnh vực kinh doanh.
Không để các tính năng quan trọng ở trạng thái “đang phát triển”.
Có hướng dẫn hoặc thông báo rõ ràng khi người dùng không thể tiếp tục thao tác.
Các quyền API đã được đăng ký và xét duyệt phù hợp.
Mini App tuân thủ chính sách của nền tảng.

Một cách đơn giản để kiểm tra trước khi gửi duyệt là đặt mình vào vai trò người dùng mới. Hãy thử thực hiện toàn bộ luồng sử dụng từ lúc mở Mini App đến khi hoàn thành tác vụ chính, chẳng hạn như đặt hàng, đăng ký dịch vụ, đặt lịch hoặc gửi biểu mẫu.

8. Checklist triển khai Zalo Mini App cho người mới

Trước khi phát hành Mini App, bạn nên kiểm tra các nội dung sau:

Zalo App đã ở trạng thái hoạt động.
Zalo Mini App ID đã được tạo đúng.
API server đã cấu hình CORS phù hợp.
Các chức năng chính hoạt động ổn định trên điện thoại.
Mini App có luồng đăng nhập hoặc định danh người dùng phù hợp.
Các API nhạy cảm đã được gửi yêu cầu xét duyệt.
Quyền từ người dùng được xin đúng lúc và có giải thích rõ ràng.
Hình ảnh, nội dung, nút bấm và điều hướng hiển thị tốt.
Không có trang trắng, lỗi điều hướng hoặc tính năng chưa hoàn thiện.
Đã kiểm tra ứng dụng bằng tài khoản người dùng thông thường.
Đã rà soát các yêu cầu trong chính sách kiểm duyệt trước khi gửi phiên bản.

Triển khai Zalo Mini App thành công không chỉ phụ thuộc vào việc viết code mà còn cần chuẩn bị tốt về cấu hình kỹ thuật, trải nghiệm người dùng, phân quyền API và quy trình xét duyệt. Với người mới bắt đầu, việc nắm rõ các bước từ kích hoạt Zalo App, thiết lập CORS, tận dụng tài khoản Zalo đến kiểm tra quyền và phát hành ứng dụng sẽ giúp hạn chế đáng kể các lỗi thường gặp. Abenla hy vọng những tips trên giúp doanh nghiệp tự tin hơn khi bắt đầu với Zalo Mini App.

Xem thêm:

Thông tin liên hệ:

Công ty TNHH ABENLA