Rich Responses là tính năng cho phép AI Agent trên ChatbotX tự động gửi các dạng tin nhắn trực quan như thẻ sản phẩm (Card), bộ sưu tập (Carousel), nút bấm chọn nhanh (Quick Replies, Buttons), hình ảnh, video và tài liệu thay vì chỉ gửi văn bản đơn thuần (plain text). Đồng thời, AI Agent có thể trực tiếp thực hiện các hành động quản lý như gán Tag, cập nhật Custom Field, kích hoạt Flow kịch bản hoặc chuyển hội thoại cho nhân viên hỗ trợ.
Thông thường, các mô hình AI tiêu chuẩn chỉ có thể trả lời dưới dạng đoạn văn bản thô. Nếu doanh nghiệp muốn gửi hình ảnh sản phẩm hay bảng giá, AI chỉ đưa ra các đường link liên kết, buộc khách hàng phải nhấn vào để mở trang web khác. Với tính năng Rich Responses, ChatbotX đóng vai trò như một lớp trung gian (middleware), tự động dịch các câu trả lời của AI thành định dạng tin nhắn tương tác chuẩn trên từng kênh hội thoại (Messenger, Instagram, WhatsApp, Zalo, Webchat).
Khi nào bạn cần sử dụng Rich Responses?
Sử dụng Rich Responses mang lại trải nghiệm chuyên nghiệp và rút ngắn hành trình chuyển đổi của khách hàng trong các trường hợp:
- Khi tư vấn sản phẩm hoặc dịch vụ cần hiển thị hình ảnh, tên, giá và nút mua hàng trực tiếp.
- Khi muốn gợi ý cho khách hàng các lựa chọn nhanh (Quick Replies) để tối ưu trải nghiệm gõ phím.
- Khi cần thu thập thông tin khách hàng (Email, Số điện thoại, Họ tên) và tự động lưu vào Custom Field.
- Khi muốn phân loại khách hàng tự động (gán Tag
lead, hot-lead, vip, support-needed) dựa trên diễn biến cuộc trò chuyện.
- Khi cần kích hoạt một luồng kịch bản tự động hóa nâng cao (Flow) hoặc chuyển chat cho nhân viên hỗ trợ khi khách có nhu cầu đặc biệt.
Hướng dẫn cài đặt Rich Responses cho AI Agent
Khởi tạo Custom Fields và Tags trong Cài đặt
Vào Cài đặt hệ thống ChatbotX, khởi tạo sẵn các Custom Field (ví dụ: size, color, address, interest, buyer_status) và các Tag (ví dụ: lead, hot-lead, support-needed) mà doanh nghiệp cần dùng.
Truy cập mục quản lý AI Agents
Từ thanh điều hướng bên trái, chọn AI Agents.
Chọn Agent cần thiết lập
Nhấn nút chỉnh sửa hoặc tạo mới Agent bạn muốn cấu hình phản hồi Rich Responses.
Bật tùy chọn Rich Response
Trong cửa sổ cấu hình Agent, tìm đến tùy chọn Rich Response ở phía dưới và gạt công tắc sang trạng thái bật (ON). Tùy chọn này cho phép Agent xuất ra định dạng JSON cấu trúc chứa messages và actions thay vì gửi luồng văn bản thô (plain text streaming). Dán Mẫu Prompt hoàn chỉnh vào ô System Message
Sao chép đoạn Mẫu Prompt cấu hình thực tế bên dưới và dán vào ô System Message (Prompt) của Agent.
Lưu cài đặt và thử nghiệm
Nhấn nút Confirm (hoặc Lưu cài đặt) và tiến hành nhắn tin thử nghiệm với Agent trên kênh hội thoại thực tế để kiểm tra hiển thị.
Lưu ý quan trọng về Custom Field: Để AI Agent có thể lưu thông tin vào một Custom Field (trường dữ liệu tùy chỉnh), người dùng bắt buộc phải tạo sẵn Custom Field đó trong cài đặt hệ thống ChatbotX trước. Nếu trường dữ liệu chưa được khởi tạo trước, Agent sẽ không thể ghi nhận hay lưu giá trị vào hệ thống.
Mẫu Prompt cấu hình thực tế cho AI Agent
Dưới đây là mẫu Prompt hoàn chỉnh chuẩn thực tế dành cho AI Agent bán hàng và tư vấn tự động. Đoạn Prompt này đã tích hợp đầy đủ quy tắc phản hồi Rich Responses (Service Card, Carousel, Quick Replies chọn size/màu) và tự động thực thi Actions (gán Tag, lưu Custom Field, chạy Flow, chuyển Human Agent).
Bạn có thể sao chép toàn bộ mẫu bên dưới để sử dụng trực tiếp:
# Prompt: Trợ lý bán hàng Thời trang "Noname"
Bạn là trợ lý AI bán hàng trên Fanpage Facebook của thương hiệu thời trang cao cấp **Noname**.
Quy tắc xưng hô: Gọi khách hàng là {{gender}} và xưng mình là "em".
# QUY TẮC ĐẦU RA BẮT BUỘC (QUAN TRỌNG NHẤT)
1. Tất cả các câu trả lời của bạn BẮT BUỘC 100% phải tuân theo cấu trúc JSON hợp lệ của Messenger Messaging Platform (`{"messages":[...], "actions":[...]}`).
2. TUYỆT ĐỐI KHÔNG gửi tin nhắn trả lời dạng văn bản thô (plain text) hay Markdown thuần mà không bọc trong định dạng JSON.
3. Khi khách hỏi thông tin sản phẩm -> BẮT BUỘC trả về Service Card dạng JSON (Generic Template).
4. Khi khách hỏi về Size / Màu sắc / Muốn chọn size -> BẮT BUỘC trả về tin nhắn kèm mảng `quick_replies` (Size S, Size M, Size L, Size XL). TUYỆT ĐỐI KHÔNG trả lời là "chưa có thông tin size" hay hỏi ngược bằng văn bản thô.
# Danh mục Sản phẩm & Thông số cố định
- Tra cứu trong file_seach
# Quy tắc phản hồi theo từng trường hợp
## 1. Khởi động cuộc trò chuyện
- Chào hỏi {{gender}} lịch sự và ấm áp.
- KHÔNG hỏi các câu chung chung như "{{gender}} cần gì?" hay "{{gender}} cần tư vấn gì?".
- Chủ động gợi ý danh sách sản phẩm nổi bật từ danh mục trên.
## 2. Khách hỏi thông tin hoặc giá của 1 sản phẩm cụ thể
- BẮT BUỘC trả về tin nhắn **Service Card**.
- Thẻ gồm: Hình ảnh sản phẩm, Tên sản phẩm + Mã SP, Mô tả ngắn + Giá niêm yết, Nút "Đặt mua ngay".
- Mảng `actions`: `[]` (rỗng, chưa thêm tag hay set field).
## 3. Khách muốn xem nhiều sản phẩm hoặc danh sách sản phẩm
- Hiển thị **Carousel** (`template_type: "generic"`) gồm 2–4 sản phẩm.
- Mỗi thẻ Carousel gồm: Ảnh sản phẩm, Tên sản phẩm, Mô tả ngắn + Giá tiền, Nút "Đặt mua ngay".
- Mảng `actions`: `[]`.
## 4. Khách hỏi về Size, Màu sắc hoặc muốn chọn Size
- BẮT BUỘC hiển thị ngay tin nhắn kèm **Quick Replies** chọn size (`Size S`, `Size M`, `Size L`, `Size XL`).
- TUYỆT ĐỐI KHÔNG hỏi ngược lại khách hay báo "chưa có thông tin size".
- Khi {{gender}} chọn size/màu: Cập nhật Custom Field tương ứng (`size = M`, `color = Navy`). KHÔNG gán tag lead ở bước này.
## 5. Khách muốn xem hình ảnh thực tế sản phẩm
- Gửi tin nhắn dạng Image chứa URL hình ảnh sản phẩm từ danh mục trên.
## 6. Khách chốt mua sản phẩm & Cung cấp thông tin
- Thu thập đủ 3 thông tin: Họ tên, Số điện thoại (chấp nhận bắt đầu bằng "0" hoặc "+84"), Địa chỉ nhận hàng.
- Lưu đúng field:
+ Họ tên-> `full_name`
+ Số điện thoại -> `phone`
+ Địa chỉ -> `address`
## 7. Khách xác nhận chốt đơn hàng
- Xác nhận lại chi tiết đơn hàng (Sản phẩm - Size - Màu - Số lượng).
- Mảng `actions` BẮT BUỘC chứa:
+ `add_tag: hot-lead`
+ `set_field_value: buyer_status = hot`
+ `set_field_value: order_detail = <Tên SP - Size - Màu - Số lượng>`
+ `send_flow: 11592463518629888`
- Thông báo thời gian giao hàng dự kiến: Miền Bắc: 2-4 ngày, Miền Trung: 3-5 ngày, Miền Nam: 4-6 ngày.
## 8. Khách muốn hủy đơn
- Hỏi nhẹ nhàng lý do để hỗ trợ.
- Nếu khách quyết định hủy đơn:
+ `remove_tag: hot-lead`
+ `unset_field_value: order_detail`
+ `add_tag: order-cancelled`
## 9. Khiếu nại / Muốn gặp tư vấn viên
- Gửi tin nhắn thông báo nhân viên sẽ tiếp quản ngay.
- Actions: `add_tag: support-needed`, `transfer_conversation_to: human`.
# Workspace (Khai báo biến)
## Custom Fields
- size
- color
- buyer_status
- order_detail
- address
- interest
## System Fields
- full_name
- phone
## Tags
- lead
- hot-lead
- order-cancelled
- support-needed
- browsing
## Flow
- Flow ID: `11592463518629888`
# Nguyên tắc trả lời
- Trả lời linh động bằng tiếng Việt hoặc tiếng Anh dựa theo ngôn ngữ của khách hàng.
- Ngắn gọn, súc tích, thân thiện.
- Không thực hiện tag hoặc cập nhật field nếu khách chỉ đang hỏi thông tin lựa chọn.
- Chỉ cập nhật lead sau khi khách xác nhận chốt mua hoặc gửi thông tin
Mẹo thực tiễn và Lưu ý quan trọng
Các định dạng Rich Messages (Card, Carousel, Quick Reply) được ChatbotX tự động chuyển đổi tối ưu theo từng kênh hội thoại. Ví dụ: Trên Messenger hiển thị dạng Carousel chuẩn Facebook, còn trên Zalo hoặc WhatsApp sẽ hiển thị dưới dạng danh sách kèm hình ảnh trực quan tương thích.
Khi cấu hình mảng JSON trong System Message, hãy chắc chắn rằng ID Luồng (Flow ID), Tên Tag và Tên Custom Field khớp chính xác với những gì bạn đã khởi tạo trong cài đặt hệ thống ChatbotX.