Hội thoại

Trò chuyện với AI trong ứng dụng hoặc hệ thống chăm sóc khách hàng của bạn, hỗ trợ phản hồi dạng streaming, chuyển tiếp đến nhân viên, kết thúc và đánh giá hội thoại.

POST /v1/chat

{
  "message": "有没有 400 美元以内的潜水表？",
  "conversation_id": null,
  "user": {"id": "u_123", "name": "李四", "email": "li@example.com", "ip": "85.214.132.117", "language": null},
  "stream": false
}

Khi không truyền conversation_id, một cuộc hội thoại mới sẽ được tạo; giá trị này được trả về trong phản hồi và cần gửi kèm trong các tin nhắn tiếp theo.
user do máy chủ của bạn gửi trực tiếp cho chúng tôi (bên gọi API Key là đáng tin cậy); chỉ khi có thông tin này mới tra cứu được đơn hàng.
Ngôn ngữ phản hồi mặc định: nếu truyền user.language (ví dụ de, zh-CN, pt-BR) thì dùng ngôn ngữ đó; nếu không, truyền user.ip, chúng tôi sẽ xác định theo vị trí; nếu không truyền cả hai, dùng ngôn ngữ mặc định trong phần quản trị. Sau khi khách hàng yêu cầu đổi ngôn ngữ trong cuộc hội thoại, ưu tiên yêu cầu của khách hàng.
Khi stream: false, trả về {"conversation_id", "message", "status", "products"}; message là null nghĩa là cuộc hội thoại đang được nhân viên hỗ trợ, tin nhắn đã được chuyển cho nhân viên.
Khi stream: true, trả về SSE, các sự kiện xem bảng dưới đây.

Sự kiện `type`	Nội dung
`user_message`	Tin nhắn của người dùng đã được lưu
`delta`	Một đoạn văn bản `text` của câu trả lời, nối theo thứ tự
`products`	Thẻ sản phẩm do AI tìm thấy
`language`	Khách hàng yêu cầu đổi ngôn ngữ phản hồi; `language` là mã ngôn ngữ mới
`status`	Trạng thái cuộc hội thoại thay đổi (ví dụ chuyển sang nhân viên)
`replace`	Dùng `text` thay thế toàn bộ câu trả lời đã nhận (khi xảy ra lỗi thì thay bằng câu trả lời dự phòng)
`queued_for_human`	Cuộc hội thoại đang được nhân viên hỗ trợ, không có câu trả lời của AI
`done`	Tin nhắn và trạng thái cuộc hội thoại được lưu cuối cùng
`error`	Có lỗi

Các API khác

Phương thức	Đường dẫn	Mô tả
GET	`/v1/conversations`	Danh sách cuộc hội thoại, `?status=&end_user_id=`
GET	`/v1/conversations/{id}/messages`	Cuộc hội thoại và toàn bộ tin nhắn
POST	`/v1/conversations/{id}/messages`	Hệ thống chăm sóc khách hàng của bạn trả lời với vai trò nhân viên: `{"content", "agent_name"}`; cuộc hội thoại ngay sau đó chuyển sang trạng thái nhân viên hỗ trợ
POST	`/v1/conversations/{id}/status`	Thao tác từ phía nhân viên hỗ trợ: `{"status": "ai"}` chuyển lại cho AI, `{"status": "closed"}` kết thúc cuộc hội thoại
POST	`/v1/conversations/{id}/close`	Khách hàng kết thúc cuộc hội thoại trong App của bạn; cuộc hội thoại đã kết thúc cũng trả về thành công
POST	`/v1/conversations/{id}/rating`	Khách hàng đánh giá sau khi cuộc hội thoại kết thúc: `{"rating": "good" \| "bad", "comment": "可选，最多 500 字"}`; có thể sửa lại

Trạng thái cuộc hội thoại: ai (AI trả lời), pending_human (chờ nhân viên), human (nhân viên đang hỗ trợ), closed (đã kết thúc).

Cuộc hội thoại còn có: closed_by cho biết ai đã kết thúc (customer khách hàng, agent nhân viên hỗ trợ, ai AI kết thúc sau khi khách hàng cho biết không còn vấn đề nào khác), rating / rating_comment / rated_at là đánh giá của khách hàng.

Kết thúc cuộc hội thoại: Trong cửa sổ web, phần đầu có nút "Kết thúc cuộc hội thoại" (xác nhận hai lần); trong WeChat Mini Program, khách hàng gửi "结束" cũng sẽ kết thúc; khi bật "AI tự động kết thúc cuộc hội thoại" trong "Cài đặt bot", nếu khách hàng nói rõ không còn vấn đề nào khác, AI chào tạm biệt rồi kết thúc cuộc hội thoại. Sau khi kết thúc, cửa sổ web sẽ mời khách hàng đánh giá hài lòng / không hài lòng và có thể để lại lời nhắn; trong WeChat, mời khách hàng trả lời 1 hoặc 2; sau đó nếu khách hàng gửi tin nhắn lại thì đó là cuộc hội thoại mới.

Phân công sau khi chuyển sang nhân viên: Trong "Cài đặt bot", chọn cách phân công — giao cho nhân viên có ít cuộc hội thoại nhất (mặc định), phân công luân phiên, hoặc để nhân viên tự nhận. Phân công tự động chỉ giao cho nhân viên đã chọn "Trực tuyến" và đang mở trang quản trị; mỗi người có giới hạn số cuộc hội thoại hỗ trợ đồng thời (thiết lập ở trang "Nhóm"); nếu nhân viên được phân công không phản hồi quá thời gian đã đặt (mặc định 2 phút) thì sẽ được phân công lại. Trong cuộc hội thoại, assigned_member_id là nhân viên được phân công, assigned_at là thời điểm phân công, handoff_at là thời điểm chuyển sang nhân viên. Khi tất cả nhân viên đều đã đầy, khách hàng sẽ xếp hàng; cửa sổ web hiển thị còn bao nhiêu người phía trước.

Giờ làm việc và lời nhắn: Sau khi bật giờ làm việc trong "Cài đặt bot", ngoài giờ làm việc, khi khách hàng chuyển sang nhân viên sẽ không xếp hàng; cửa sổ web hiện biểu mẫu để lại lời nhắn (tên, email hoặc số điện thoại, vấn đề); với cuộc hội thoại trên WeChat và Open API, AI sẽ mời khách hàng để lại lời nhắn; trong giờ làm việc nhưng không có nhân viên trực tuyến cũng vậy. Lời nhắn sẽ tạo ticket; khi nhân viên trả lời, nếu cuộc hội thoại gốc chưa kết thúc thì câu trả lời sẽ được gửi vào cuộc hội thoại; nếu khách hàng để lại email thì cũng sẽ gửi email dưới danh nghĩa cửa hàng. Khi chỉ đẩy sang hệ thống của bạn (chọn "Đẩy sang hệ thống của tôi" ở cách chuyển sang nhân viên) thì không xét giờ làm việc.

Trang này có hữu ích không?

Cập nhật lần cuối: 31 tháng 10, 2026