ShopReply
Hướng dẫn cài đặt & sử dụng
v1.0

Hướng dẫn cài đặt ShopReply

Phần mềm tự động trả lời tin nhắn cho shop bán hàng trên Facebook & Zalo.
Mọi dữ liệu đều được xử lý trên máy của bạn — không gì bị gửi lên cloud.

100% bảo mật — dữ liệu không rời máy bạn

Yêu cầu hệ thống

Hạng mục Yêu cầu tối thiểu
Hệ điều hành Windows 10 trở lên (64-bit)
RAM 8 GB (khuyến nghị 16 GB nếu dùng AI gợi ý)
Ổ cứng ~5 GB trống (backend ~200MB + model gemma3:4b ~3.3GB + embedding ~120MB)
Trình duyệt Google Chrome phiên bản 120+
Mạng Không cần internet để trả lời tự động. Cần internet để cài Chrome Extension

Tùy chọn: Cài Ollama (để có AI gợi ý)

Nếu bạn muốn ShopReply gợi ý câu trả lời bằng AI cho những câu hỏi mới:

  1. Tải Ollama tại: ollama.com/download
  2. Cài đặt bình thường (Next > Next > Install)
  3. Mở Command Prompt, chạy: ollama pull gemma3:4b
  4. Đợi tải xong (khoảng 3.3 GB)
Lưu ý: Nếu không cài Ollama, ShopReply vẫn hoạt động bình thường — chỉ là không có AI gợi ý cho câu hỏi mới.
1

Cài Backend (1 lần duy nhất)

  1. ⬇ Tải ShopReply-Backend-v1.0.0.zip — giải nén ra sẽ có file ShopReply-Backend.exe
  2. Tạo 1 thư mục riêng, ví dụ: C:\ShopReply\
  3. Bỏ file .exe vào thư mục đó
  4. Double-click để chạy
  5. Lần đầu chạy sẽ mất 30-60 giây để tải model embedding (chỉ lần đầu)
  6. Biểu tượng ShopReply (hình tròn xanh chữ "S") sẽ hiện ở khay hệ thống (góc dưới phải màn hình)
Mẹo: Nếu không thấy biểu tượng, click mũi tên ^ ở khay hệ thống để hiện các biểu tượng ẩn.

Kiểm tra đã chạy thành công

  1. Click phải biểu tượng ShopReply ở khay hệ thống
  2. Chọn "Open Health Check"
  3. Trình duyệt sẽ mở và hiện trạng thái "status": "ok" — vậy là thành công!
2

Cài Chrome Extension

  1. Mở Chrome Web Store (link sẽ được cung cấp sau)
  2. Nhấn "Thêm vào Chrome" (Add to Chrome)
  3. Nhấn "Thêm tiện ích mở rộng" (Add extension)
  4. Ghim biểu tượng ShopReply vào thanh công cụ:
    • Click biểu tượng puzzle (tiện ích mở rộng) ở góc phải Chrome
    • Tìm ShopReply > click biểu tượng ghim
ShopReply Popup - Giao diện chính sau khi cài đặt
Popup chính của ShopReply — hiển thị số Q&A, thống kê auto-reply, nút bật/tắt nhanh
3

Import bộ câu hỏi - trả lời

Đây là bước quan trọng nhất — bạn cần "dạy" cho bot biết cách trả lời khách hàng.

Cách 1: Import từ file (khuyến nghị)

  1. Chuẩn bị file CSV với 2 cột: questionanswer

Ví dụ:

question,answer
"Giá áo hoodie?","Áo hoodie giá 350k, size S-XL ạ"
"Ship bao lâu?","Ship nội thành 1-2 ngày, ngoại thành 3-5 ngày ạ"
"Có COD không?","Có COD nha bạn, nhận hàng rồi trả tiền ạ"
  1. Click biểu tượng ShopReply trên Chrome > "Cài đặt"
  2. Chọn tab "Import"
  3. Kéo thả file CSV vào hoặc click để chọn file
  4. Xác nhận import
Q&A Database - Bảng câu hỏi và trả lời
Tab Q&A Database — quản lý tất cả câu hỏi/trả lời, tìm kiếm, sửa, xóa

Cách 2: Thêm từng câu

  1. Mở cài đặt ShopReply > tab "Q&A"
  2. Click "Thêm mới"
  3. Nhập câu hỏi và câu trả lời
  4. Lưu lại

Cách 3: Scan lịch sử chat cũ (cần Ollama)

  1. Mở Facebook Messages hoặc Zalo Web trên Chrome
  2. Click biểu tượng ShopReply > "Scan lịch sử"
  3. Chọn những cuộc hội thoại là khách hàng (bỏ qua bạn bè, nhóm chat...)
  4. ShopReply sẽ tự động trích xuất các cặp câu hỏi - trả lời
  5. Review và xác nhận

Cách 4: Không cần import — bot tự học

Nếu bạn không có data sẵn:

  1. Mỗi khi khách hỏi, bạn tự viết câu trả lời — bot sẽ lưu vào database ở trạng thái chưa duyệt (nguồn auto_scan)
  2. Vào Bộ câu hỏi → rà soát các Q&A chưa duyệt → bấm Duyệt những câu đúng ý
  3. Chỉ Q&A đã duyệt mới được bot dùng để tự động trả lời (tránh bot học sai, trả lời bậy)
  4. Sau 1-2 tuần tích lũy, bot đã đủ dữ liệu để tự động 80-90% câu hỏi
4

Bắt đầu sử dụng

  1. Đảm bảo ShopReply Backend đang chạy (biểu tượng xanh ở khay hệ thống)
  2. Mở Facebook Messages (facebook.com/messages) hoặc Zalo Web (chat.zalo.me)
  3. Khi có tin nhắn khách hàng:
    • Câu đã có sẵn trong DB đã duyệt (độ khớp ≥ 80%) — ShopReply tự động trả lời (chỉ áp dụng gói Pro)
    • Câu tương tự (65-79%) — Hiện bảng đề xuất, bạn chọn/sửa rồi gửi
    • Câu hoàn toàn mới — Hiện gợi ý từ AI (nếu có Ollama), bạn tự viết/chỉnh rồi gửi. AI không bao giờ tự gửi — tránh bịa sai
    • Cảnh báo — Nếu khách hỏi không liên quan shop hoặc yêu cầu gặp người thật, ShopReply hiện cảnh báo để bạn xử lý trực tiếp
  4. Mỗi lần bạn trả lời câu mới, ShopReply tự lưu vào DB (chưa duyệt). Bạn vào Bộ câu hỏi bấm Duyệt để kích hoạt auto-reply cho câu đó
Càng duyệt Q&A nhiều, bot càng thông minh. Sau 1-2 tuần, bot có thể tự động trả lời 80-90% câu hỏi thường gặp.
Auto-Reply Log - Nhật ký tự động trả lời
Tab Auto-Reply Log — xem lại các câu bot đã tự trả lời, đánh giá OK/Sai để bot học hỏi

Tùy chỉnh cài đặt

Mở cài đặt ShopReply để điều chỉnh ngưỡng tự động trả lời, giọng văn, và các nền tảng:

Settings - Cài đặt ShopReply
Tab Settings — điều chỉnh ngưỡng auto-reply (mặc định 0.80), suggest (0.65), giọng văn, bật/tắt FB/Zalo

Khởi động cùng Windows (tùy chọn)

Để ShopReply tự động chạy mỗi khi bật máy:

  1. Click phải biểu tượng ShopReply ở khay hệ thống
  2. Chọn "Start with Windows" (sẽ hiện dấu check khi đã bật)
  3. Để tắt: click lại "Start with Windows" lần nữa

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

ShopReply có gửi dữ liệu lên cloud không?

Không. Toàn bộ dữ liệu (câu hỏi, câu trả lời, lịch sử chat) đều được lưu và xử lý trên máy của bạn. Không gì bị gửi ra ngoài.

Tại sao lần đầu chạy bị chậm?

Lần đầu tiên, ShopReply cần tải model embedding (khoảng 100MB) để hiểu nội dung câu hỏi. Chỉ cần đợi 1 lần, các lần sau sẽ nhanh.

Làm sao biết bot đang chạy?

Nhìn góc dưới phải màn hình (khay hệ thống) — có biểu tượng hình tròn xanh chữ "S" là đang chạy.

Bot trả lời sai thì sao?

Mở cài đặt ShopReply > tab "Nhật ký" (Auto-Reply Log) > Tìm câu trả lời sai > click "Sai" (Wrong) > Sửa lại câu trả lời đúng > Lưu. Bot sẽ học từ bản sửa và không lặp lại lỗi đó.

Có thể dùng trên nhiều máy không?

Có thể, nhưng mỗi máy cần cài riêng. Dữ liệu không đồng bộ giữa các máy (vì là local).

Tôi muốn đổi port (không dùng 3000)?

Tạo file .env cạnh file ShopReply-Backend.exe, ghi nội dung: SHOPREPLY_PORT=8080 (thay 8080 bằng port mong muốn), rồi khởi động lại ShopReply.

Tôi tắt máy mà không tắt ShopReply trước?

Không sao. Lần sau bật máy, chỉ cần chạy lại ShopReply-Backend.exe (hoặc bật "Start with Windows" để tự động).

Không cài Ollama có sao không?

Không sao. ShopReply vẫn trả lời tự động bằng Q&A database. Ollama chỉ cần khi bạn muốn AI gợi ý câu trả lời cho những câu hỏi hoàn toàn mới chưa có trong database.

Liên hệ hỗ trợ

Nếu bạn gặp vấn đề hoặc cần hỗ trợ, liên hệ qua:

Ủng hộ tác giả

Nếu ShopReply giúp ích cho bạn, hãy mua cho tác giả một ly cà phê nhé!
Mọi sự ủng hộ đều giúp tôi tiếp tục phát triển và cải thiện sản phẩm.

Donate QR

PHAM VAN SUNG
TPBank — 67319051997

Scan QR bằng ứng dụng ngân hàng bất kỳ. Số tiền tùy tâm.