Bài viết này tổng hợp các mẹo kỹ thuật hữu ích trong quá trình phát triển ứng dụng. Nếu như bạn là người mới bắt đầu phát triển Zalo Mini App, bài viết này sẽ rất phù hợp để giúp bạn dễ dàng triển khai thành công ứng dụng đầu tiên của mình.
Kích hoạt Zalo App
Bước đầu tiên và tiên quyết trong việc phát triển Zalo Mini App là tạo app. Nhiều người thường hay nhầm lẫn hai khái niệm sau:
- Zalo Mini App ID: mỗi mini app sẽ có riêng một ID dùng để định danh. ID này được dùng để deploy mini app từ source code, gửi xét duyệt cũng như chia sẻ trong quá trình sử dụng.
- Zalo App ID (hay còn gọi là Zalo Developer ID): các nhà phát triển làm việc với hệ sinh thái của Zalo sẽ cần có một Zalo App. Zalo App ID được sử dụng để xác định nhà phát triển và cấp quyền truy cập vào các API của Zalo, do đó việc tích hợp các dịch vụ như OA, ZNS và trường hợp này là đều cần phải có một Zalo App với trạng thái “Đang hoạt động”.
Để tạo Zalo App và kích hoạt, bạn truy cập https://developers.zalo.me và truy cập trang Quản lý ứng dụng như hình dưới:
Thiết lập CORS cho phép gọi API từ Mini App
Một trong những vấn đề thường gặp nhất khi giao tiếp tới Server của doanh nghiệp từ Mini App đó là vấn đề về cross origins. Đây là cơ chế mặc định của các trình duyệt web để đảm bảo chỉ có những domain mà Server cho phép mới có thể gửi dữ liệu đến Server.
Các domain cần được khai báo trong response header Access-Control-Allow-Origin mà Server trả về là:
- https://h5.zdn.vn
- zbrowser://h5.zdn.vn
Sử dụng tài khoản Zalo để đăng nhập trên Mini App
Một trong những thế mạnh của Mini App so với Native App hoặc Web App đó là Mini App có thể tận dụng được tập người dùng có sẵn của Zalo. Người sử dụng không cần phải tạo tài khoản hoặc đăng nhập để có thể sử dụng dịch vụ, vì khi mở Mini App chúng ta đã biết họ là ai thông qua tài khoản Zalo mà họ đang sử dụng.
Một nhu cầu thường gặp khác là liên kết người dùng Zalo Mini App (mới) với tập người dùng có sẵn từ các kênh khác (cũ) trong hệ thống của bạn. Khi đó người dùng Zalo Mini App có thể xem lại các hợp đồng cũng như đơn hàng trước mà họ đã thực hiện trước khi sử dụng Zalo Mini App và ngược lại. Có nhiều cách để thực hiện cơ chế này, liên kết số điện thoại là một trong những cách đó.
Hướng dẫn sử dụng DevTools để phát triển Mini App
Nếu như bạn chưa biết thì phát triển Zalo Mini App (hay Mini App nói chung) cần phải code, vì thế người phát triển Zalo Mini App yêu cầu phải có không ít thì nhiều kiến thức về lập trình
Zalo Mini App Platform cung cấp 2 bộ cung cụ phát triển ứng dụng chính:
- Zalo Mini App Studio: bao gồm 1 trình soạn thảo code đầy đủ (IDE) và các giao diện giúp bạn có thể chạy thử ứng dụng của bạn trên máy tính và deploy lên Mini App ID để có thể xuất bản.
- Zalo Mini App CLI: bộ công cụ dòng lệnh giúp bạn có thể chạy thử ứng dụng của mình trên trình duyệt và deploy lên ID để xuất bản ứng dụng. Bạn có thể sử dụng IDE/Text Editor tuỳ thích như Visual Studio Code và chạy các lệnh này từ Terminal.
Xin cấp quyền sử dụng API
Để đảm bảo quyền riêng tư cho người sử dụng Zalo Mini App, một số API nhạy cảm yêu cầu cần phải đăng ký quyền sử dụng trước khi dùng:
Một vài lưu ý về việc xin quyền sử dụng API:
- Thời điểm tốt nhất để gửi yêu cầu xét duyệt quyền sử dụng API là sau khi gửi xét duyệt version đầu tiên của Mini App. Chỉ khi đó thì đội ngũ xét duyệt mới có đủ ngữ cảnh để đưa ra quyết định. Càng không nên để đến khi Mini App của bạn đã xuất bản và có những người dùng đầu tiên thì mới tiến hành đi xin.
- Để dễ dàng tiếp cận và phát triển ứng dụng, người dùng nằm trong tập Admin/Developer và Người dùng thử nghiệm của Mini App có thể sử dụng được toàn bộ tất cả API mà không cần xin quyền. Do đó kể cả khi bạn không nhìn thấy những thông báo lỗi về permission của API khi sử dụng, luôn phải double check danh sách các quyền đã được duyệt tương ứng.
Chuyển đổi Mini App từ dự án có sẵn
Vì bản chất của Zalo Mini App là web app và có cơ chế routing phía client, nên các dự án web app có kiến trúc Single Page tương tự (như Vue.js, Angular,…), hoặc có thể thiết lập để build ra dưới dạng web app (như Flutter, Next.js) có thể được sử dụng lại để chuyển đổi sang Zalo Mini App. Đối với các trang web có cơ chế routing phía server, việc chuyển đổi là không khả thi.
Nhìn chung các bước trong quá trình chuyển đổi bao gồm:
- Build source code của dự án ra static assets (bao gồm các file html, css và js). Cơ chế routing phải được thực hiện bằng JavaScript.
- Khai báo các assets cần phải load (JS/CSS) trong app-config.json.
- Dùng Zalo Mini App CLI để đẩy những assets này lên Mini App ID của bạn.
Chính sách kiểm duyệt Zalo Mini App
Bước cuối cùng trong quy trình phát triển ứng dụng là xuất bản và mang nó đến với 70 triệu người dùng của Zalo.
THÔNG TIN LIÊN HỆ
SDT: 0977383456
EMAIL: kbtech.technology@gmail.com
WEBSITE : kbtech.com.vn
ĐĂNG KÝ ZALO OA: dangkyzalooa.com
