Thiết lập cửa hàng & cấu hình hệ thống

Trước khi mở bán, hãy hoàn thiện nhận diện thương hiệu và các cấu hình vận hành. Tất cả nằm ở ba trang: Cửa hàng, Thiết lập và Giao diện.

1. Cửa hàng — Nhận diện & nội dung hiển thị

Vào menu Cửa hàng. Trang này có 3 tab:

Tab 1: Thông Tin Cửa Hang

Card "Thông Tin Doanh Nghiệp" (bên trái):

Trường	Mô tả	Bắt buộc
Tên Doanh Nghiệp	Tên cửa hàng hiển thị trên Mini App	Có (*)
Email	Email liên hệ	Không
Số Điện Thoại	SĐT liên hệ (định dạng 0123-456-789)	Không
Mã Số Thuế	Mã số thuế doanh nghiệp	Không
Mô Tả	Giới thiệu ngắn về cửa hàng (tối đa 500 ký tự)	Không

Card "Địa Chỉ Cơ Sở" (bên trái, ẩn khi bật Chi nhánh):

• Nhấn "Thêm Cơ Sở" để thêm địa chỉ
• Mỗi cơ sở có: Tên Cơ Sở, Địa Chỉ, Số Điện Thoại, checkbox "Đặt làm cơ sở chính"
• Xóa cơ sở bằng nút "Xóa" bên cạnh

Card "Logo Cửa Hang" (bên phải):

• Kéo thả hoặc nhấn để tải lên logo (PNG, JPG, SVG, khuyến nghị kích thước vuông)
• Nút "Lưu Logo" khi chọn file mới, "Thay Đổi Logo" để thay, "Xóa Logo" để xóa

Mẹo: Logo và banner là ấn tượng đầu tiên của khách. Dùng ảnh rõ nét, đúng tỉ lệ khung để tránh bị cắt.

Tab 2: Banners

Quản lý banner quảng cáo trên trang chủ Mini App.

Tạo banner mới:

1. Nhấn "Thêm Banner"
2. Điền thông tin:

Trường	Mô tả	Bắt buộc
Tiêu đề	Tên banner để quản lý	Có
Link URL	Liên kết khi khách nhấn banner (tới sản phẩm, danh mục hoặc link ngoài)	Không
Hình ảnh Banner	Ảnh banner (PNG, JPG, tối đa 5MB)	Có
Hiển thị trên mini app	Bật/tắt banner	Không

3. Nhấn "Tạo mới"

Quản lý banner hiện có:

• Nhấn vào badge trạng thái ("Đang hiển thị" / "Đã ẩn") để bật/tắt nhanh
• Nhấn "Chỉnh sửa" để sửa thông tin
• Nhấn "Xóa" để xóa banner

Tab 3: Popups

Tạo popup khuyến mãi hiển thị khi khách mở app.

Tạo popup mới:

1. Nhấn "Tạo Popup"
2. Điền thông tin:

Trường	Mô tả	Bắt buộc
Tiêu đề	Tên popup để quản lý (không hiển thị trên popup)	Có (*)
Loại Popup	Chọn: "Thông báo", "Khuyến mãi", hoặc "Mini Game"	Có (*)
Chọn Mini Game	Chỉ hiện khi chọn loại "Mini Game"	Có (*)
Hình ảnh Popup	Ảnh popup (JPG, PNG, GIF, WEBP, tối đa 5MB)	Có (*)
Tần suất	"Mỗi phiên 1 lần", "Mỗi ngày 1 lần", "Mỗi lần mở app", "1 lần duy nhất"	Có (*)
Thứ tự ưu tiên	Số nhỏ = hiển thị trước	Không
Bắt đầu	Ngày bắt đầu (trống = hiển thị luôn)	Không
Kết thúc	Ngày kết thúc (trống = không hết hạn)	Không
Kích hoạt popup	Bật/tắt popup	Không

3. Nhấn "Tạo Popup"

Các loại popup:

• Thông báo — Hiển thị ảnh, bấm ảnh sẽ đóng popup
• Khuyến mãi — Hiển thị ảnh, bấm ảnh sẽ đóng popup
• Mini Game — Bấm ảnh sẽ mở trò chơi (ví dụ: vòng quay may mắn)

2. Thiết lập — Cấu hình vận hành

Vào menu Thiết lập. Trang này gồm 6 tab:

Tab 1: Thanh Toan

Cấu hình Zalo Checkout SDK để kích hoạt thanh toán cho Mini App.

Trường	Mô tả	Bắt buộc
App ID	App ID từ Zalo Developer Portal	Có (*)
Private Key	Private Key từ Zalo Developer Portal (giữ bí mật!)	Có (*)
Callback URL	URL tự động tạo — copy và dán vào Zalo Developer Portal	Tự động
Sandbox Mode	Bật chế độ test	Không

Bước thực hiện:

1. Truy cập Zalo Developer Portal
2. Tạo ứng dụng hoặc chọn ứng dụng hiện có
3. Copy App ID và Private Key từ trang thanh toán
4. Dán vào form, copy Callback URL về Zalo Developer Portal
5. Nhấn "Lưu Cấu Hình"

Tab 2: Van Chuyen

Trường	Mô tả
Phí Vận Chuyển Mặc Định	Phí ship áp dụng cho đơn hàng thông thường (VND)
Ngưỡng Miễn Phí Vận Chuyển	Miễn phí ship khi tổng đơn >= giá trị này (0 = không áp dụng)
Kích Hoạt Cấu Hình	Bật/tắt áp dụng phí vận chuyển

Ví dụ tính phí ship:

• Đơn 100.000đ → Phí ship: 30.000đ
• Đơn 500.000đ → Miễn phí ship (nếu ngưỡng = 300.000đ)
• Đơn 1.000.000đ → Miễn phí ship

Nhấn "Đặt Lại Mặc Định" để quay về cấu hình ban đầu.

Tab 3: San Pham

Kiểm Soát Tồn Kho:

• Nghiêm ngặt — Chặn đặt hàng khi hết tồn kho
• Linh hoạt — Cho phép tồn kho âm (đặt hàng được dù hết hàng)

Thứ Tự Hiển Thị Sản Phẩm:

• Mới nhất trước — Sản phẩm vừa tạo hiển thị đầu tiên (mặc định)
• Cũ nhất trước — Sản phẩm tạo từ lâu hiển thị đầu tiên

Tab 4: Giao Diện

Tùy chỉnh màu chủ đạo của Mini App.

Cách chọn màu:

1. Nhấn vào 1 trong 8 màu gợi ý (Blue, Purple, Green, Orange, Pink, Red, Teal, Indigo)
2. Hoặc nhập mã HEX vào ô nhập liệu
3. Nhấn "Xem Trước" để xem hiệu ứng
4. Nhấn "Lưu Cấu Hình"

Lưu ý: Hệ thống tự động tạo 5 sắc thái (shade) từ màu bạn chọn để áp dụng cho toàn bộ giao diện.

Tab 5: Thong Bao

Nhận thông báo đơn hàng và đặt phòng mới qua tin nhắn Zalo Bot tự động.

Thiết lập (3 bước):

1. Tạo Bot trên Zalo — Quét QR code để tạo Bot
2. Lấy Bot Token — Copy token từ trang quản lý Bot
3. Kết nối hệ thống — Dán token vào ô Bot Token, nhấn "Tiếp Tục"
4. Cập nhật Webhook — Copy Webhook URL và cập nhật vào Bot
5. Bắt đầu nhận thông báo — Gửi "/start" đến Bot trên Zalo

Khi đã kết nối thành công:

• Bật/tắt thông báo: Đơn hàng mới, Đặt phòng mới, Đơn hàng bị hủy
• Nhấn "Gửi tin nhắn thử" để kiểm tra
• Nhấn "Ngắt kết nối" để ngắt

Tab 6: Sapo API

Kết nối cửa hàng Sapo để đồng bộ dữ liệu.

Kết nối:

1. Chọn mode: "Ứng dụng riêng (Private App)" hoặc "OAuth (App đã duyệt)"
2. Nhập Tên cửa hàng (ví dụ: my-shop → my-shop.mysapo.net)
3. Nhập API Key và API Secret (Private App mode)
4. Nhấn "Kết Nối"

Đồng bộ dữ liệu (6 loại):

• Sản phẩm, Danh mục, Nhận đơn từ Sapo, Đẩy đơn lên Sapo, Tồn kho, Khách hàng
• Mỗi loại có nút "All" (đồng bộ tất cả) và "Mới" (chỉ đồng bản mới)
• Bật/tắt từng loại bằng toggle

3. Giao diện — Chọn theme cho Mini App

Vào menu Giao diện. Trang này có 2 phần:

Mau Chu Dao

• Chọn từ 10 màu preset hoặc nhập mã HEX tùy chỉnh
• Màu sẽ áp dụng cho toàn bộ Mini App

Phong Cach Giao Dien

3 phong cách với preview trực tiếp trên điện thoại mô phỏng:

Phong cách	Mô tả	Đặc điểm
Classic	Thân thiện, ấm áp	Font Be Vietnam Pro, card bo tròn với đổ bóng, tab chuyển động mượt
Minimalist	Tối giản, tập trung nội dung	Font Inter, viền mạnh thay vì đổ bóng, khoảng trắng lớn
Modern	Nền đậm, táo bạo	Font Space Grotesk, hiệu ứng kính mờ, nút gradient phát sáng

Nhấn "Lưu Thay Đổi" khi đã chọn xong. Thay đổi sẽ áp dụng trong 1-2 phút. Khách cần đóng và mở lại Mini App để thấy giao diện mới.

Checklist trước khi mở bán

• Đã tải logo và thông tin cửa hàng
• Đã tạo ít nhất 1 banner trang chủ
• Đã bật phương thức thanh toán (Zalo Checkout SDK)
• Đã cấu hình phí vận chuyển
• Đã chọn giao diện và màu chủ đạo
• Đã thiết lập thông báo Zalo Bot (tùy chọn)

Mẹo & Best Practices

1. Logo nên là hình vuông — Tránh bị cắt hoặc méo trên Mini App
2. Banner nên có tỷ lệ 16:9 — Hiển thị đẹp trên mọi thiết bị
3. Popup không nên quá频繁 — Khách sẽ khó chịu nếu popup hiện mỗi lần mở app
4. Test thanh toán ở Sandbox Mode — Bật Sandbox để thử nghiệm trước khi bán thật
5. Sao lưu Private Key — Nếu mất, bạn phải tạo lại trên Zalo Developer Portal

Câu hỏi thường gặp

Q: Tôi có thể thay đổi loại hình kinh doanh sau không? A: Có, trong phần Cài đặt. Nhưng nên chọn đúng ngay từ đầu.

Q: Banner có thể liên kết đến đâu? A: Đến sản phẩm, danh mục trong Mini App, hoặc link ngoài (website, Zalo OA...).

Q: Phí vận chuyển có áp dụng cho tất cả đơn không? A: Có, trừ khi tổng đơn vượt ngưỡng miễn phí hoặc khách có hạng thành viên được miễn phí ship.

Q: Tôi quên Private Key thì làm sao? A: Đăng nhập Zalo Developer Portal → Ứng dụng của bạn → Thanh toán → Tạo lại Private Key.

Bước tiếp theo

Tùy loại hình, hãy thiết lập nghiệp vụ chính: Quản lý danh mục & sản phẩm (bán lẻ), Thiết lập phòng & cấu hình giá (khách sạn), hoặc Thực đơn & gọi món tại bàn (nhà hàng).