Thu thập và quản lý đánh giá của khách trên website: nhúng widget đánh giá vào trang sản phẩm, duyệt nội dung và phản hồi từ cửa hàng.
📌 Vị trí: Phân hệ NextX Chat → Hộp thư → Đánh giá sản phẩm.
1. Màn hình đánh giá
Màn đánh giá: điểm trung bình và phân bổ sao ở đầu, bộ lọc và danh sách đánh giá bên dưới.
| Thành phần | Cách hoạt động | Dùng khi nào |
|---|---|---|
| 1 · Ba nút cấu hình | Cấu hình widget · Thử API · Hướng dẫn tích hợp. | Lần đầu tích hợp vào website. |
| 2 · Điểm trung bình & phân bổ sao | Điểm tổng (thang 5) kèm thanh phân bổ từ 5★ xuống 1★. | Đánh giá sức khoẻ uy tín sản phẩm. |
| 3 · Bộ lọc | Tất cả loại · Tất cả trạng thái · Mới nhất, ô Tìm nội dung và Mã sản phẩm. | Lọc riêng đánh giá 1–2 sao để xử lý. |
| 4 · Danh sách đánh giá | Khi trống hiển thị Chưa có đánh giá nào. |
2. Cấu hình widget đánh giá
Nhấn Cấu hình widget → tuỳ chỉnh giao diện bên trái, xem trước kết quả ngay bên phải.
| Trường | Cách nhập | Lưu ý |
|---|---|---|
| 1 · Hai tab | Giao diện (tuỳ chỉnh) và Mã nhúng (lấy code dán vào web). | Khai xong Giao diện rồi sang lấy Mã nhúng. |
| 2 · Tiêu đề khối | Tên hiển thị trên website (mặc định Đánh giá sản phẩm). | |
| 3 · Màu chính & Màu sao | Mã màu HEX cho nút/phản hồi và cho ngôi sao. | Đặt trùng màu thương hiệu của website. |
| 4 · Giao diện nền & Ngôn ngữ | Sáng / tối; ngôn ngữ hiển thị. | Chọn nền khớp với web để widget không lạc lõng. |
| 5 · Hai công tắc | Hiện thanh tổng hợp sao và Hiện form viết đánh giá. | Tắt form nếu chỉ muốn hiển thị đánh giá cũ. |
| 6 · Nút Lưu cấu hình | Nhấn để áp dụng. | |
| 7 · Khối Xem trước | Mô phỏng widget thật trên website. | Kiểm tra màu sắc trước khi nhúng. |
💡 Khối Xem trước cập nhật ngay khi bạn đổi màu — chỉnh tới khi ưng rồi mới sang tab Mã nhúng lấy code. Nếu đổi màu sau khi đã nhúng, website tự cập nhật mà không cần dán lại code.
3. Thử API tích hợp
Nhấn Thử API → gửi thử một đánh giá để kiểm tra kết nối trước khi giao cho đội kỹ thuật website.
| Thành phần | Cách dùng | Lưu ý |
|---|---|---|
| 1 · Widget Token dùng để gọi | Chuỗi token xác thực, kèm nút Chép. | Xem cảnh báo bên dưới. |
| 2 · Mã sản phẩm (productRef) | Mã định danh sản phẩm trên website của bạn. | Phải khớp mã bên web thì đánh giá mới gắn đúng sản phẩm. |
| 3 · Nhãn endpoint | Gửi đánh giá. POST /api/v1/comm/widget/reviews · | |
| 4 · Loại & Số sao (1–5) | Loại REVIEW và số sao thử nghiệm. | |
| 5 · Tên khách | Tên hiển thị của người đánh giá. | |
| 6 · Nội dung | Nội dung đánh giá thử. | |
| 7 · Request phía khách gọi | Đoạn mã mẫu đầy đủ kèm nút Chép. | Gửi đoạn này cho lập trình viên website. |
⚠️ Widget Token là khoá bí mật. Ai có token này đều gửi được đánh giá vào hệ thống của bạn. Chỉ chia sẻ cho đội kỹ thuật website, không đăng công khai hay để lộ trong mã nguồn phía trình duyệt.
4. Hướng dẫn tích hợp — tab Giới thiệu & Hướng dẫn
Nhấn Hướng dẫn tích hợp → “Cách đưa khối Đánh giá sản phẩm của NextX lên website của bạn.”
| Thành phần | Nội dung | Dùng để làm gì |
|---|---|---|
| 1 · Tải tài liệu (.docx) | Tải file hướng dẫn đầy đủ. | “File .docx chi tiết từng API, cách thiết lập và gắn vào website — gửi cho team web của khách.” |
| 2 · Hai tab | Giới thiệu & Hướng dẫn và Tài liệu tích hợp. | |
| 3 · Tính năng này làm gì? | “Thu thập đánh giá, hỏi–đáp và khiếu nại của khách ngay trên website, tập trung về NextX để nhân viên trả lời/duyệt. Đánh giá đã duyệt hiển thị lại trên web kèm dữ liệu SEO (sao vàng trên Google).” | Giải thích giá trị cho khách hàng. |
| 4 · Sáu thẻ tính năng | Thu thập đánh giá · Trả lời tập trung · Tốt cho SEO · Khiếu nại → CRM · Ảnh đính kèm · Bình chọn hữu ích. | Xem mục 💡 bên dưới. |
| 5 · Cách hoạt động | Bốn bước: khách viết đánh giá → website gọi API kèm Widget Token → nhân viên trả lời/duyệt/ẩn trong NextX → website gọi API lấy danh sách đã duyệt để hiển thị lại kèm JSON-LD cho SEO. |
💡 Hai điểm đáng giá nhất: Tốt cho SEO — “JSON-LD AggregateRating giúp Google hiển thị sao vàng” trên kết quả tìm kiếm, tăng tỉ lệ nhấp; và Khiếu nại → CRM — “Khiếu nại tự tạo phiếu CRM để chăm sóc theo SLA”, không để sót phản ánh của khách.
5. Hướng dẫn tích hợp — tab Tài liệu tích hợp
Tab Tài liệu tích hợp: tài liệu API đầy đủ dành cho đội kỹ thuật website — “bản tích hợp bằng API (không cần nhúng widget)”.
| Nhóm mục | Nội dung | Dành cho ai |
|---|---|---|
| BẮT ĐẦU | Tổng quan · Xác thực. | Đọc trước tiên. |
| USE CASES | Gửi & hiển thị đánh giá · Đính kèm ảnh · Webhook real-time. | Tình huống tích hợp thực tế. |
| API — ĐÁNH GIÁ | sao. POST Gửi đánh giá · GET Danh sách + tổng hợp | Lập trình viên. |
| API — ẢNH | POST Xin URL upload ảnh. | |
| API — TƯƠNG TÁC | POST Vote hữu ích. | |
| Thông tin kết nối | Base URL · Xác thực (X-Widget-Token) · Định dạng (JSON, UTF-8). | Cấu hình kết nối. |
⚠ ️ Khối thông báo cuối trang ghi rõ: “Đang chạy môi trường thử nghiệm. Khi lên production Base URL sẽ đổi sang https://api.nextx.vn — NextX sẽ báo khi sẵn sàng.” Đừng để đội web cố định (hard-code) Base URL thử nghiệm vào bản chạy thật.