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

Gán người liên quan

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. action: ADD thêm vào (agent đã có sẵn thì bỏ qua, không lỗi), action: REMOVE gỡ ra.

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.

actionenumRequired
Allowed values:
agentIdslist of stringsRequired

uid nhân viên (xem GET /agents).

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