Kết nối hệ thống
Chức năng Kết nối hệ thống cho phép shop Mini Gift kết nối với các ứng dụng thương mại điện tử (ecommerce) trong cùng hệ sinh thái Zalo Mini App, đồng thời tạo API Key để đối tác bên ngoài tích hợp ngược vào Mini Gift.
Màn hình gồm 2 tab chính:
| Tab | Mục đích |
|---|---|
| Ứng dụng MiniApp | Liên kết Mini Gift sang shop ecommerce — dùng API Key của shop ecommerce |
| API Key | Tạo API Key của Mini Gift — để bên ngoài kết nối vào Mini Gift |
- Tab Ứng dụng MiniApp: bạn nhập API Key của đối tác ecommerce để Mini Gift kết nối sang họ.
- Tab API Key: bạn tạo API Key của chính mình để đối tác bên ngoài gọi vào API của Mini Gift.
Hai tab phục vụ hai chiều kết nối ngược nhau.
1. Truy cập chức năng
Từ menu bên trái, chọn Quản lý liên kết.
Hình ảnh: Menu truy cập Quản lý liên kết
2. Tab Ứng dụng MiniApp
Tab Ứng dụng MiniApp cho phép shop Mini Gift liên kết với các Zalo Mini App ecommerce trong cùng hệ sinh thái. Sau khi liên kết thành công, hai hệ thống có thể chia sẻ dữ liệu coupon, điểm thưởng và quà tặng với nhau.
Hình ảnh: Danh sách ứng dụng MiniApp đã liên kết
Điều kiện liên kết
Để liên kết thành công, admin cần có 2 thông tin từ phía shop ecommerce:
| Thông tin | Mô tả |
|---|---|
| Zalo Mini App ID | ID định danh của ứng dụng ecommerce trên nền tảng Zalo |
| API Key | API Key do shop ecommerce tạo ra trong hệ thống của họ, dùng để xác thực quyền kết nối |
API Key ở đây là của shop ecommerce bên kia, không phải API Key của shop Mini Gift. Bạn cần liên hệ đối tác ecommerce để lấy thông tin này.
Liên kết ứng dụng mới
Nhấn Thêm mới
Hình ảnh: Nút Thêm mới
Nhập thông tin từ shop ecommerce
Hình ảnh: Form liên kết ứng dụng
Điền Zalo Mini App ID và API Key của shop ecommerce, sau đó nhấn Liên kết.
Hệ thống sẽ xác thực:
- Tìm shop ecommerce theo Zalo Mini App ID
- Kiểm tra API Key có khớp với shop đó không
Kết quả
- Hợp lệ → liên kết thành công, hiển thị card với logo và tên shop ecommerce
- Không hợp lệ → báo lỗi (shop không tồn tại hoặc API Key sai)
Ngắt liên kết
Nhấn Ngắt liên kết trên card của shop ecommerce → xác nhận → ngắt kết nối thành công. Sau khi ngắt, hai hệ thống sẽ ngừng chia sẻ dữ liệu.
Sau khi liên kết, dữ liệu được dùng ở đâu?
Các shop ecommerce đã liên kết sẽ xuất hiện dưới dạng dropdown "Cửa hàng MiniApp" tại:
| Nơi sử dụng | Mục đích |
|---|---|
| Form tạo/sửa Quà tặng | Gắn quà tặng với shop ecommerce cụ thể — khi user nhận quà có coupon, coupon sẽ thuộc shop ecommerce đã chọn |
| Form tạo/sửa Campaign | Gắn campaign với shop ecommerce — điểm thưởng và coupon từ campaign sẽ đồng bộ sang shop ecommerce |
Dữ liệu được đồng bộ giữa hai hệ thống
| Loại dữ liệu | Chiều đồng bộ | Mô tả |
|---|---|---|
| Coupon | Mini Gift → Ecommerce | Khi user nhận quà hoặc đổi điểm, coupon code được tạo và gắn với shop ecommerce để user sử dụng bên đó |
| Điểm thưởng (Loyalty) | Ecommerce ↔ Mini Gift | Đồng bộ thông tin tích điểm và customer ID giữa hai hệ thống |
| Thông tin khách hàng | Mini Gift → Ecommerce | Khi user hoàn thành khảo sát/campaign, tag khách hàng được gắn sang hệ thống ecommerce |
| Cài đặt ZNS | Ecommerce → Mini Gift | Mini Gift có thể dùng cài đặt ZNS (Zalo Notification Service) của shop ecommerce đã liên kết để gửi thông báo |
3. Tab API Key
Tab API Key cho phép tạo và quản lý các khóa truy cập của shop Mini Gift. Các đối tác bên ngoài sử dụng API Key này để gọi vào API của Mini Gift — ví dụ: shop ecommerce cần API Key của bạn để liên kết từ phía họ.
Hình ảnh: Danh sách API Key
| Cột | Mô tả |
|---|---|
| Tên | Tên định danh API Key |
| ApiKey | Giá trị khóa (được che một phần) |
| Ngày tạo | Thời điểm tạo |
| Hành động | Xóa API Key |
Tạo API Key mới
Nhấn Tạo mới để sinh API Key.
Hình ảnh: Form tạo API Key
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Tên | Không | Tên định danh cho API Key (nên đặt tên theo mục đích sử dụng, ví dụ: "Key cho shop ABC") |
Xóa API Key
Nhấn biểu tượng Xóa tại API Key cần thu hồi.
API Key bị xóa sẽ ngừng hoạt động ngay lập tức và không thể khôi phục. Mọi hệ thống đang dùng key này sẽ mất kết nối.
4. Lưu ý bảo mật
- Không chia sẻ API Key cho bên thứ ba không đáng tin cậy
- Thay đổi API Key ngay khi nghi ngờ bị lộ
- Mỗi đối tác nên sử dụng một API Key riêng để dễ quản lý và thu hồi khi cần
- Đặt tên theo mục đích hoặc đối tác (ví dụ: "Key cho shop Ecommerce ABC") để dễ phân biệt
- Thường xuyên rà soát và thu hồi API Key không còn sử dụng