Skip to navigation

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-KeystringRequired

Request

This endpoint expects an object.
customerIdstringRequiredformat: "^[0-9A-Z]{11}$"

customerId do API trả về (11 ký tự [0-9A-Z]). Gửi id nội bộ (UUID) sẽ bị từ chối.

statusstringRequired

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.

reasonstringOptional<=2000 characters

Response

Đã cập nhật — {customerId, success}.

customerIdstringOptional
successbooleanOptional

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