Skip to navigation
Khách hàngTương tác

Chuyển phụ trách

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. keepPreviousAsRelated: true giữ người phụ trách cũ lại làm nhân viên liên quan thay vì gỡ hẳn. changeReason là bắt buộc nếu chính sách tenant yêu cầu và người phụ trách thực sự thay đổi.

Headers

X-Api-KeystringRequired

Request

This endpoint expects an object.
customerIdstringRequired<=64 characters

id (UUIDv7) hoặc uid (11 ký tự [0-9A-Z]) của khách hàng.

agentIdstringRequired

uid nhân viên phụ trách mới (xem GET /agents).

keepPreviousAsRelatedbooleanOptional

Giữ người phụ trách cũ lại làm nhân viên liên quan.

changeReasonstringOptional<=2000 characters

Response

Khách hàng sau khi cập nhật.

idstringOptional
uidstringOptional
tenantIdstringOptional
lifecycleStagesstringOptional
statusstringOptional
fullNamestringOptional
phonestringOptional

Có thể đã bị che.

emailstringOptional

Có thể đã bị che.

attributesmap from strings to anyOptional

Khoá theo fieldCode.

assignedAgentIdstringOptional
createdAtlongOptional
Epoch millis.
lastModifiedAtlongOptional
Epoch millis.
createdByobjectOptional
lastModifiedByobjectOptional
createdViaobjectOptional

Kênh tự động đã thực hiện thao tác ghi; null nếu nhân viên thao tác trực tiếp.

lastModifiedViaobjectOptional

Kênh tự động đã thực hiện thao tác ghi; null nếu nhân viên thao tác trực tiếp.

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