> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/huong-dan-van-hanh-zalo-mini-app.md). # Hướng dẫn vận hành Zalo Mini App

Từ những thao tác cơ bản đến các tình huống thường gặp, hướng dẫn được trình bày rõ ràng từng bước để bạn tự tin quản lý Mini App hiệu quả mỗi ngày. Bạn có thể đọc hướng dẫn từng tính năng ở cột trái, hoặc có thể đọc phần hướng dẫn từng bước bên dưới:\ \ **Hướng dẫn các bước khởi tạo & vận hành Zalo Mini App**\ \ Hướng dẫn này gồm 3 phần A,B,C. Hãy làm theo đúng thứ tự Phần B (6 bước cơ bản) – đây là những việc 100% khách hàng đều cần. Khi muốn làm thêm tính năng nâng cao, mở Phần C và chỉ đọc đúng cụm bạn cần. Mỗi chỗ nhắc tới một chức năng đều có liên kết xanh – bấm vào để xem hướng dẫn chi tiết kèm hình ảnh. Lộ trình dưới đây là thứ tự được khuyến nghị. Làm lần lượt từ trên xuống, mỗi bước dẫn tới hướng dẫn chi tiết tương ứng ở Phần B. ## **PHẦN A — BẮT ĐẦU NHANH** Lộ trình dưới đây là thứ tự được khuyến nghị. Làm lần lượt từ trên xuống, mỗi bước dẫn tới hướng dẫn chi tiết tương ứng ở Phần B.


Bước	Việc cần làm	Menu trong CMS
1	Đăng sản phẩm đầu tiên	Menu: Sản phẩm › Danh sách sản phẩm → Xem bước chi tiết
2	Cấu hình giá / khuyến mãi	Menu: Ưu đãi › Chương trình giảm giá → Xem bước chi tiết
3	Đăng banner & bài viết trang chủ	Menu: Tin tức › Danh sách tin tức → Xem bước chi tiết
4	Tạo menu phân loại (danh mục)	Menu: Sản phẩm › Danh mục sản phẩm → Xem bước chi tiết
5	Cấu hình nút điều hướng	Menu: Cài đặt chung › Nút điều hướng → Xem bước chi tiết
6	Khai báo thông tin Công ty	Menu: Cài đặt chung › Thông tin ứng dụng → Xem bước chi tiết

💡 Lưu ý: Nếu chưa có danh mục sản phẩm nào, hãy làm B4 (tạo danh mục) trước rồi quay lại B1, vì khi đăng sản phẩm bắt buộc phải chọn danh mục. ## **PHẦN B — 6 BƯỚC CƠ BẢN (100% khách cần)** ### B1. Đăng sản phẩm đầu tiên 🎯 Mục tiêu: *Có ít nhất 1 sản phẩm hiển thị trên Mini App.*


Bước 1	Vào menu Sản phẩm › Danh sách sản phẩm, nhấn nút + Thêm sản phẩm.
Bước 2	Điền các trường bắt buộc: Tên sản phẩm, Loại (Sản phẩm/Quà tặng), Danh mục, Giá bán (số nguyên, không dấu chấm), Trạng thái “Còn hàng”, Chi nhánh áp dụng.
Bước 3	Tải Ảnh sản phẩm (jpg/png/webp ≤ 2MB – ảnh đầu tiên là ảnh đại diện). Nếu có nhiều biến thể (màu, size…) → chọn Phân loại rồi nhập giá cho từng biến thể.
Bước 4	Nhấn Lưu. Sản phẩm hiển thị ngay trên Mini App.

💡 Lưu ý: Nhiều sản phẩm cùng lúc? Anh/chị dùng Nhập từ Excel (tải file mẫu, tối đa 100 SP/lần; ảnh phải là link URL). Xem [hướng dẫn import Excel](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/san-pham/danh-sach-san-pham).

*Form “Thêm sản phẩm” và các trường bắt buộc*

### **B2. Cấu hình giá / khuyến mãi / ưu đãi** 🎯 Mục tiêu: *Gắn chương trình giảm giá cho sản phẩm để kích thích mua hàng.* Có 3 công cụ ưu đãi: * Chương trình giảm giá – giảm % hoặc số tiền cho nhiều sản phẩm theo thời gian. [Mở hướng dẫn](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/uu-dai/chuong-trinh-giam-gia) * Mua X tặng Y – mua kèm tặng quà. [Mở hướng dẫn](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/uu-dai/mua-x-tang-y) * Voucher – mã giảm giá khách nhập khi thanh toán (xem C3). Làm nhanh chương trình giảm giá:


Bước 1	Vào Ưu đãi › Chương trình giảm giá → + Thêm mới.
Bước 2	Nhập Tên chương trình, Loại giảm (Tỉ lệ % hoặc Giảm trực tiếp), Giá trị giảm, Giảm tối đa, Ngày bắt đầu – hết hạn.
Bước 3	Chọn sản phẩm áp dụng (có thể chọn nhiều) → nhấn Lưu.

*Form thêm chương trình giảm giá & mục chọn sản phẩm áp dụng*

### **B3. Đăng banner & bài viết (slider trang chủ)** 🎯 Mục tiêu: *Có banner chạy slider trên trang chủ Mini App + bài viết tin tức.* 💡 Lưu ý: Trên Core Retail, banner trang chủ được lấy từ bài viết Tin tức. Mỗi bài viết có trường Ảnh banner; ảnh này sẽ hiển ra thành slider ở trang chính. Vì vậy, để đăng banner anh/chị chỉ cần tạo một bài viết tin tức như bên dưới.


Bước 1	Vào Tin tức › Danh sách tin tức → + Thêm mới.
Bước 2	Nhập Tiêu đề, chọn Danh mục, soạn Nội dung. Tải Ảnh tin tức (tỷ lệ 16:9, 1280×720) và Ảnh banner – chính là ảnh dùng cho slider trang chủ.
Bước 3	Đặt Trạng thái “Công khai” → Lưu. (Không thể lưu nếu chưa có ảnh tin tức.)

💡 Lưu ý: Muốn phân loại bài viết (Tin nổi bật, Khuyến mãi…), anh/chị tạo nhóm trước tại [Tin tức › Danh mục tin tức](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/tin-tuc/danh-muc-tin-tuc).

*Vị trí trường “Ảnh banner” trong form thêm tin tức.*

### B4. Tạo menu phân loại sản phẩm (Danh mục) 🎯 Mục tiêu: *Có các nhóm danh mục để khách dễ tìm sản phẩm trên trang chủ.*


Bước 1	Vào Sản phẩm › Danh mục sản phẩm → + Thêm danh mục.
Bước 2	Nhập Tên danh mục, Thứ tự hiển thị (số nhỏ lên đầu). Có thể thêm Danh mục con kèm ảnh (khuyến nghị 500×500).
Bước 3	Nhấn Lưu. Sau đó ở mục “Cập nhật danh mục trên trang chủ”, chọn những danh mục muốn hiện ngoài trang chính → Áp dụng.

*Popup tạo danh mục & khu vực chọn danh mục hiển thị trên trang chủ.*

### B5. Cấu hình nút điều hướng trang chính 🎯 Mục tiêu: *Có các nút hành động như Hotline, Chat Zalo OA… trên giao diện Mini App.*


Bước 1	Vào Cài đặt chung › Cài đặt nút điều hướng → + Thêm nút.
Bước 2	Chọn Loại nút (Gọi điện / Webview / Email / Direct), Nhóm nút (Shortcut / Button / Floating Bubble), nhập Tiêu đề và Giá trị điều hướng (số điện thoại / link / email), tải Icon.
Bước 3	Bật Trạng thái hoạt động → Lưu.

Ví dụ thường dùng: nút Hotline (Phone), nút Chat Zalo OA (Direct → link OA), nút nổi Floating Bubble để hỗ trợ nhanh.

*Form thêm nút điều hướng: chọn Loại nút & Nhóm nút.*

### B6. Khai báo thông tin Công ty (Cài đặt chung) 🎯 Mục tiêu: *Hiển thị đúng thông tin giới thiệu & liên hệ của doanh nghiệp trên Mini App.*


Bước 1	Vào Cài đặt chung › Thông tin ứng dụng.
Bước 2	Mục “Thông tin doanh nghiệp”: soạn nội dung giới thiệu DN, link hướng dẫn thanh toán → Lưu.
Bước 3	Mục “Thông tin liên hệ doanh nghiệp”: nhập Mã DN, Địa chỉ, Email, Hotline → Lưu.

💡 Lưu ý: Anh/chị vui lòng không tự sửa mục “Thông tin tài khoản Omni” và “Token OA” – những thông tin này đã được INCOM cấu hình sẵn để hệ thống chạy ổn định; chỉ điều chỉnh khi được đội kỹ thuật INCOM hướng dẫn. Tuỳ chọn thêm: thiết lập [Phí vận chuyển](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/cai-dat-chung/cai-dat-phi-van-chuyen) theo khoảng giá đơn hàng nếu có bán giao hàng.

*Hai mục “Thông tin doanh nghiệp” và “Thông tin liên hệ” trong Thông tin ứng dụng.*

## PHẦN C — CÀI ĐẶT CHỨC NĂNG NÂNG CAO Chỉ mở cụm bạn cần. Mỗi cụm ghi rõ khi nào dùng và các menu phải thao tác theo thứ tự. ### C1. Tiếp thị liên kết (Affiliate) 🎯 Mục tiêu: *Cho phép cộng tác viên/đối tác chia sẻ link giới thiệu và nhận hoa hồng.*


Bước 1	Khai báo chính sách hoa hồng: vào Cài đặt chung › Thông tin ứng dụng → mục “Chính sách Tiếp thị Liên kết”, soạn cơ chế & bảng % hoa hồng → Lưu.
Bước 2	Quản lý CTV & theo dõi hoa hồng tại menu Tiếp thị liên kết.

### C2. Thiết lập cửa hàng / chi nhánh 🎯 Mục tiêu: *Khai báo nhiều chi nhánh để hiển thị đúng cho khách khi chọn nơi mua/đặt lịch.*


Bước 1	Vào menu Chi nhánh → + Thêm → nhập tên, địa chỉ, giờ mở cửa, thông tin liên hệ.
Bước 2	Khi tạo sản phẩm (B1), chọn đúng Chi nhánh áp dụng cho từng sản phẩm.

### C3. Voucher & ưu đãi chuyên sâu 🎯 Mục tiêu: *Tạo mã giảm giá có điều kiện và phát cho khách.*


Bước 1	Vào Voucher › Danh sách Voucher → Thêm mới.
Bước 2	Nhập Tên, Mã (duy nhất), Loại áp dụng (Đơn hàng/Sản phẩm/Vận chuyển), Loại giảm (% / số tiền), Giá trị, Đơn tối thiểu, Số lượng, thời gian.
Bước 3	Tuỳ chọn “Đổi bằng điểm” để gắn loyalty (xem Hạng thành viên) → Lưu.
Bước 4	Phát hành: dùng chức năng “Tặng Voucher” – tặng theo Tag (nhóm khách) hoặc tặng khách cụ thể. Có thể Import Excel hàng loạt.

### C4. Khảo sát khách hàng 🎯 Mục tiêu: *Thu thập ý kiến khách để cải thiện sản phẩm/dịch vụ.*


Bước 1	Vào Khảo sát › Danh sách khảo sát → tạo khảo sát, soạn câu hỏi → Công khai.
Bước 2	Xem kết quả tại Danh sách phản hồi.

### C5. Vòng quay may mắn 🎯 Mục tiêu: *Tạo minigame quay thưởng để tăng tương tác & giữ khách.*


Bước 1	Tạo phần thưởng trước tại Vòng quay › Danh sách phần thưởng (phần thưởng có thể là voucher – liên kết C3).
Bước 2	Tạo chương trình tại Danh sách vòng quay, gán phần thưởng & tỉ lệ, đặt thời gian.
Bước 3	Theo dõi người trúng tại Danh sách trúng giải.

### C6. Tạo & tổ chức sự kiện 🎯 Mục tiêu: *Quản lý sự kiện marketing/workshop/khai trương và danh sách đăng ký.*


Bước 1	Vào Sự kiện › Danh sách sự kiện → tạo sự kiện, theo dõi số lượng đăng ký.
Bước 2	Nếu có tài trợ: quản lý tại Quản lý nhà tài trợ và Danh sách hạng nhà tài trợ.

### C7. Gửi tin tự động (ETM) & Campaign chủ động 🎯 Mục tiêu: *Tự động chăm sóc khách: gửi tin khi có sự kiện, hoặc gửi chiến dịch chủ động theo data.* Phân biệt: ETM = gửi tự động khi có sự kiện (tạo đơn, cập nhật đơn…); Campaign = chủ động gửi cho tệp khách theo data đã thu thập.


Bước 1	Chuẩn bị mẫu tin: Omni Mini Tool › Event Trigger Messaging (gắn template với từng sự kiện) hoặc Quản lý mẫu tin UID cho tin cá nhân hoá.
Bước 2	Tạo chiến dịch tại Danh sách Campaign → chọn tệp khách (theo tag), nội dung, lịch gửi.
Bước 3	Theo dõi kết quả ở Nhật ký gửi tin (Campaign/ETM).

💡 Lưu ý: ETM/Campaign cần tài khoản Omni & Token OA đã được cấu hình sẵn (xem B6). Phần này INCOM đã thiết lập khi bàn giao. ### C8. Tùy biến Form đăng ký (custom trường thông tin) 🎯 Mục tiêu: *Thu thêm trường thông tin khách theo ý muốn khi họ đăng ký/cập nhật hồ sơ.*


Bước 1	Vào Cài đặt chung › Cài đặt thông tin khách hàng → khai báo các trường bổ sung (giới tính, nhóm KH, mã thành viên…).
Bước 2	Kết hợp Danh sách thẻ (tag) để phân nhóm khách phục vụ gửi tin/ưu đãi đúng đối tượng.

### C9. Tích hợp hệ thống bên thứ 3 (POS / ERP / CRM) 🎯 Mục tiêu: *Đồng bộ đơn hàng / khách hàng / điểm / tồn kho giữa Mini App và hệ thống Quý khách đang dùng (KiotViet, Sapo, Haravan, iPOS, Pancake, Nhanh.vn, Shopify, Odoo…).* 💡 Lưu ý: Mini App của INCOM kết nối được với hệ thống của Quý khách. Hệ thống được trang bị sẵn cơ chế Webhook tự động – đẩy dữ liệu (đơn mới, khách mới) sang phần mềm Quý khách đang dùng theo thời gian thực. Đây là nền tảng để hai hệ thống kết nối hai chiều. Để INCOM tư vấn chính xác thời gian và chi phí, Quý khách vui lòng mô tả nhu cầu theo bảng ở Bước 1.

*Các chiều đồng bộ dữ liệu giữa Mini App và hệ thống bên thứ 3*

#### Bước 1 — Mô tả rõ nhu cầu đồng bộ (phần quan trọng nhất) Cùng một câu “đồng bộ đơn hàng” nhưng mỗi doanh nghiệp lại cần một kiểu khác nhau. Quý khách mô tả càng chi tiết theo bảng dưới, INCOM càng báo đúng giải pháp, thời gian và chi phí. Hãy điền cho từng loại dữ liệu Quý khách muốn kết nối:


STT	Loại dữ liệu	Chiều đồng bộ	Tần suất	Khi nào kích hoạt / ràng buộc
1	Đơn hàng	Mini App → Platform (1 chiều hay 2 chiều?)	Tức thời / theo giờ (real-time?)	Khi khách đặt đơn mới
2	Trạng thái đơn hàng	Platform → Mini App (thường 2 chiều)	Tức thời	Khi xử lý đơn trên platform: đang giao / hoàn tất / huỷ → cập nhật ngược về Mini App
3	Khách hàng	1 chiều / 2 chiều?	Tức thời / theo lô	Khi có khách mới đăng ký
4	Tồn kho	2 chiều song song? (bán kênh nào trừ kho kênh đó)	Tức thời	Đồng bộ liên tục để tránh bán quá số lượng
5	Điểm & hạng thành viên	1 chiều / 2 chiều?	Tức thời / theo lô	Khi tích/đổi điểm
6	Voucher / khuyến mãi	1 chiều / 2 chiều?	Theo chương trình	Khi phát hành / sử dụng voucher

Một vài kịch bản thường gặp để Quý khách dễ hình dung: * Đơn hàng 1 chiều: đơn tạo trên Mini App tự động đẩy sang phần mềm bán hàng để nhân viên xử lý (đơn giản, triển khai nhanh nhất). * Đơn hàng 2 chiều: đơn đẩy sang phần mềm; khi nhân viên đổi trạng thái (đang giao / hoàn tất / huỷ) thì trạng thái cập nhật ngược lại Mini App để khách tự theo dõi. * Tồn kho 2 chiều song song: bán ở bất kỳ kênh nào đều trừ vào kho chung; số tồn đồng bộ liên tục giữa Mini App và phần mềm để không bán vượt số lượng. * Khách hàng & điểm: thông tin khách và điểm tích luỹ đồng bộ giữa hai hệ thống để chăm sóc nhất quán. #### Bước 2 — Thông tin kỹ thuật Quý khách cần cung cấp * Tài liệu API của hệ thống đối tác: endpoint, method, schema, giới hạn truy cập (có Webhook không?). * Thông tin đăng nhập kết nối (credentials): api\_key / secret / access\_token / OAuth. * Quyền xử lý dữ liệu được cấp: tạo / xem / sửa / xoá. * Danh sách trường dữ liệu & các ràng buộc bắt buộc của hệ thống đối tác. * Tài khoản truy cập hoặc đầu mối kỹ thuật phối hợp + môi trường thử nghiệm (nếu có). #### Bước 3 — INCOM khảo sát, báo giải pháp & thời gian


Bước	Nội dung	Bên phụ trách	Thời gian
1	Tiếp nhận & khảo sát (Quý khách cung cấp tài liệu API)	INCOM	2 ngày
2	Đánh giá kỹ thuật, xác định cách ánh xạ dữ liệu, đề xuất giải pháp	INCOM	3 ngày
3	Gửi giải pháp + báo giá	INCOM	1 ngày
4	Quý khách cấp thông tin đăng nhập (api_key/token) + quyền	Quý khách	1 ngày
5	Xử lý tích hợp & kết nối API	INCOM	3–10 ngày
6	Bàn giao & nghiệm thu (chạy thử thực tế)	INCOM & Quý khách	3 ngày

Thời gian dự kiến (kể từ khi Quý khách cung cấp đủ thông tin – sau bước 4): trường hợp thuận lợi khoảng 3–6 ngày làm việc; trường hợp phức tạp/cần thêm lớp trung gian khoảng 10–13 ngày. 💡 Lưu ý: Một số phần mềm dùng mã kết nối phải làm mới định kỳ (ví dụ KiotViet) sẽ cần thêm một lớp trung gian, nên thời gian có thể dài hơn. Nếu chưa có sẵn tài liệu API, INCOM cần thêm 2–4 ngày để khảo sát trước khi cam kết tiến độ. INCOM sẽ trao đổi rõ với Quý khách trong quá trình khảo sát. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/huong-dan-van-hanh-zalo-mini-app.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.