Hướng dẫn sử dụng Reviews Pro by HabaChat

1. Cài đặt

1. Tải file zip từ trang tài khoản HabaChat của bạn.
2. Vào back office → Modules → Module Manager → Upload a module, chọn file zip.
3. Cài xong, mở module bằng menu Improve → Reviews Pro (hoặc nút Configure trong Module Manager).
4. Kiểm tra nhanh: tab 📊 Tổng quan phải mở được và không có banner đỏ. Nếu module báo thiếu bảng hoặc thiếu hook, bấm nút sửa chữa mà nó đưa ra — phần kiểm tra này chạy được kể cả khi chưa có bản quyền.

Nâng cấp lên phiên bản mới: tải zip mới và upload đè lên như trên. Đừng chép file qua FTP mà không tăng version — PrestaShop chỉ chạy script nâng cấp khi nó nhận ra số phiên bản thay đổi.

2. Bản quyền và dùng thử

1. Mở tab 🔑 Bản quyền.
2. Chưa mua: bấm bắt đầu dùng thử 30 ngày. Một cú bấm, không cần mã, đầy đủ tính năng.
3. Đã mua: dán mã kích hoạt (dạng v2.…) vào ô Mã kích hoạt rồi bấm Kích hoạt. Mã gắn với tên miền của shop; đổi tên miền thì xin cấp lại mã.
4. Hết hạn thì shop không hỏng: đánh giá đã đăng vẫn hiển thị, sao Google vẫn còn, chỉ trang quản trị này bị khoá cho tới khi gia hạn.

3. Kiểm tra theme và chọn vị trí hiển thị

Làm việc này ngay sau khi cài, trước khi cấu hình bất cứ thứ gì khác.

1. Mở tab 🎯 Hiển thị & Kiểm tra theme.
2. Bấm 🔄 Kiểm tra lại ngay. Module tải một trang sản phẩm thật của bạn qua HTTP và báo: block có hiện không, nằm ở đâu, sao trang danh mục có không.
3. Đèn xanh là xong — không cần làm gì thêm.
4. Muốn đổi chỗ: chọn một trong các vị trí có hình (Dưới phần mô tả, Trong tab thông tin, Cuối trang sản phẩm), lưu, rồi kiểm tra lại.
5. Muốn đặt vào đúng một chỗ riêng: chọn Tôi tự chọn chỗ → Mở bộ chọn trực quan. Trang shop hiện ra, bạn rê chuột, bấm vào vị trí muốn đặt; module tự sinh neo và điền vào ô Anchor.
6. Bán cho khách EU: bật Hiện dòng công bố và sửa câu chữ cho hợp với cách bạn kiểm chứng đánh giá. Đây là yêu cầu của luật Omnibus.

4. Nhập đánh giá cũ

1. Mở tab 📥 Nhập dữ liệu.
2. Nếu shop đang có productcomments, module sẽ báo số đánh giá tìm thấy.
3. Đọc cảnh báo về việc gộp đa tiêu chí thành một điểm trung bình, tick ô xác nhận, rồi bấm nhập. Quá trình chạy theo từng lô qua AJAX, có thanh tiến trình.
4. Có bảng trỏ sản phẩm: giữ nguyên ID để nhập vào đúng sản phẩm đó, gõ ID khác để chuyển hướng, gõ shop để biến thành đánh giá cửa hàng, hoặc xoá trống để bỏ qua nhóm đó.
5. Đánh giá thu ngoài site (điện thoại, Facebook, sàn khác) thì nhập bằng CSV. Lưu ý: đánh giá nhập tay không bao giờ được gắn nhãn "Khách đã mua hàng".
6. Nên Export ra CSV một lần sau khi nhập xong để có bản sao lưu — file xuất ra nhập ngược vào được.

5. Bật email xin đánh giá

Đây là phần mang lại đánh giá. Các phần khác chỉ là hiển thị.

1. Mở tab ✉️ Thu thập.
2. Bật Email xin đánh giá.
3. Đặt Gửi sau khi giao (ngày) — mặc định 7. Hàng cần dùng lâu mới đánh giá được thì tăng lên 10–14.
4. Bật Email nhắc lại và đặt số ngày nhắc lại (mặc định 7 ngày sau thư đầu).
5. Bấm Xem thử email để đọc đúng thứ khách sẽ nhận. Nội dung có bản tiếng Việt và tiếng Anh, gửi theo ngôn ngữ của đơn hàng.
6. Muốn tặng quà: bật Tặng mã giảm giá, chọn phần trăm hay số tiền, và số ngày hiệu lực. Voucher phải được tặng cho mọi đánh giá, khen hay chê đều như nhau — tặng có điều kiện "đánh giá tốt mới cho" là vi phạm luật và rủi ro đó thuộc về bạn.
7. Auto-pilot chạy nền theo lượt truy cập của shop; ô trạng thái cho biết lần gửi cuối và số đơn đang chờ tới hạn.

6. Kiểm duyệt và ảnh

1. Tab ⭐ Đánh giá là hàng đợi. Lọc theo trạng thái, số sao, loại (sản phẩm hay cửa hàng), hoặc tìm theo tên, email, nội dung.
2. Duyệt/từ chối từng cái, hoặc tick nhiều rồi dùng thao tác hàng loạt — chạy theo lô qua AJAX nên shop dữ liệu lớn không bị timeout.
3. Bấm Trả lời để đăng câu trả lời của shop ngay dưới đánh giá. Bật AI thì có nút gợi ý câu trả lời; bạn vẫn đọc và sửa trước khi đăng.
4. Mặc định: đánh giá của khách đã mua hàng được duyệt tự động, đánh giá của khách lạ vào hàng đợi. Đổi được trong cài đặt.
5. Tab 🖼️ Ảnh đặt số ảnh và dung lượng tối đa, và có hàng đợi duyệt ảnh riêng — bạn duyệt ảnh mà không phải duyệt lại phần chữ.

7. Đánh giá cửa hàng và Google

1. Tab 🏪 Cửa hàng & Google → bật Cho phép đánh giá cửa hàng để hỏi luôn trong email xin đánh giá.
2. Bật Badge sao ở footer và đặt số đánh giá tối thiểu (mặc định 10) — badge "0 đánh giá" phản tác dụng.
3. Đặt đường dẫn trang đánh giá cửa hàng công khai.
4. Muốn có sao người bán trên Google: bật Google Customer Reviews, nhập Merchant Center ID, chọn vị trí badge. Đây là con đường duy nhất; đánh giá cửa hàng của HabaChat đẹp trên site của bạn nhưng không ra Google.

8. Xử lý sự cố

Duyệt đánh giá rồi mà trang sản phẩm không thấy. Shop đang dùng cache trang. Có Speed Pro thì module tự xoá cache khi bạn duyệt. Dùng cache của bên khác (Cloudflare, LiteSpeed, PrestaHero) thì bạn phải tự xoá — chúng tôi không can thiệp được vào phần mềm của người khác.

Kiểm tra theme báo không thấy block. Lưu lại vị trí một lần nữa rồi kiểm tra lại; nếu vẫn đỏ, đổi sang Cuối trang sản phẩm (an toàn nhất) hoặc dùng bộ chọn trực quan. Trường hợp hiếm, host chặn shop tự gọi HTTP tới chính mình — khi đó mở trang sản phẩm bằng mắt để xác nhận, kết quả đó mới là thật.

Khách không nhận được email. Kiểm tra cấu hình mail của PrestaShop trước (Advanced Parameters → E-mail, bấm gửi thử). Sau đó xem tab Thu thập: đơn phải ở đúng trạng thái đã giao và đã đủ số ngày chờ. Mỗi đơn chỉ được xin đánh giá một lần, không bao giờ gửi trùng.

Nhập từ productcomments xong thấy số sao khác trước. Đúng như cảnh báo trước khi nhập: các tiêu chí cũ đã được gộp thành một điểm trung bình. Ví dụ Chất lượng 5 sao, Giá 3 sao, Giao hàng 4 sao sẽ thành 4 sao.

Sao không lên Google sau vài tuần. Dùng công cụ Rich Results Test của Google trên một trang sản phẩm để xem markup có hợp lệ không. Nếu báo hai khối Product, nhiều khả năng một module SEO khác đang tự phát khối riêng — tắt phần JSON-LD của module đó, Reviews Pro luôn gộp chứ không phát khối thứ hai.