Cập nhật trạng thái khách hàng
Scope yêu cầu: customer:write. Agent cần quyền sửa (crm.customer → edit) và khách hàng phải nằm trong phạm vi sửa của agent. Chỉ đổi field status — cùng quy tắc như PATCH /customers khi chỉ gửi status (xem Cấu hình khách hàng → Trạng thái). reason là bắt buộc nếu chính sách của tenant yêu cầu. Mỗi tenant tự cấu hình danh sách trạng thái và có thể thêm/sửa/xoá; mẫu mặc định khi khởi tạo gồm:
| Trạng thái | status | | --- | --- | | Hoạt động | active | | Không hoạt động | inactive | | Rủi ro | atRisk | | Rời bỏ | lost |
Headers
X-Api-Key
Request
This endpoint expects an object.
customerId
customerId do API trả về (11 ký tự [0-9A-Z]). Gửi id nội bộ (UUID) sẽ bị từ chối.
status
Mã giá trị lựa chọn của thuộc tính Trạng thái. Mẫu mặc định: active, inactive, atRisk, lost.
reason
Response
Đã cập nhật — {customerId, success}.
customerId
success
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
502
Bad Gateway Error
503
Service Unavailable Error