Hồ sơ khách hàng và phiếu hỗ trợ
Tra cứu và đồng bộ hồ sơ khách hàng, tạo phiếu hỗ trợ từ hệ thống của bạn.
4.4 Hồ sơ khách hàng
Các cuộc hội thoại của cùng một khách hàng được gộp vào một hồ sơ khách hàng, và contact_id trong cuộc hội thoại trỏ đến hồ sơ đó. Quy tắc nhận diện: ID thành viên do bạn ký (user_token hoặc user.id do API truyền) > người dùng theo kênh (như openid WeChat) > khách truy cập trang web. Khách ẩn danh sau khi đăng nhập sẽ được hợp nhất vào hồ sơ thành viên; hai thành viên khác nhau sẽ không tự động hợp nhất. Nếu trùng email hoặc số điện thoại, hệ thống chỉ hiển thị gợi ý trong trang quản trị và nhân viên CSKH sẽ hợp nhất thủ công.
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
| GET | /v1/contacts?user_id= hoặc ?email= | Tra cứu hồ sơ khách hàng theo ID thành viên hoặc email của bạn |
| GET | /v1/contacts/{id} | Hồ sơ khách hàng: tên, email, số điện thoại, nhãn tags, ghi chú notes, trường tùy chỉnh attributes, số cuộc hội thoại, thời gian ghé thăm gần nhất, ID thành viên user_ids |
| PATCH | /v1/contacts/{id} | Đồng bộ thông tin từ hệ thống của bạn: name, phone, tags (tối đa 30), notes, attributes (thay thế toàn bộ, tối đa 30 trường). Chỉ truyền các trường cần thay đổi |
4.5 Phiếu hỗ trợ
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
| POST | /v1/tickets | Tạo phiếu hỗ trợ, ví dụ từ biểu mẫu "Liên hệ với chúng tôi" trên website: subject, description, priority (urgent / high / normal / low), name / email / phone của khách hàng, có thể liên kết tùy chọn với conversation_id hoặc contact_id. Nếu có email, phản hồi của nhân viên CSKH sẽ được gửi qua email cho khách hàng |
| GET | /v1/tickets/{id} | Phiếu hỗ trợ và dòng thời gian (tin nhắn của khách hàng, phản hồi của nhân viên CSKH, thay đổi trạng thái; không bao gồm ghi chú nội bộ) |
Trạng thái phiếu hỗ trợ: open chờ xử lý, pending chờ khách hàng, resolved đã giải quyết, closed đã đóng. Thời hạn xử lý được đặt theo mức độ ưu tiên trong "Cài đặt bot".
Trang này có hữu ích không?
Cập nhật lần cuối:
