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

Tạo ghi chú

Scope yêu cầu: customer:write. Agent cần quyền xem (crm.customer → view) và khách hàng phải nằm trong phạm vi xem của agent (cùng điều kiện như trên web). clientRequestId giúp retry an toàn (idempotent).

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.

contentstringRequired
mentionedUserIdslist of stringsOptional

uid nhân viên được gắn thẻ (xem GET /agents).

attachmentIdslist of stringsOptional

id file từ storage-service.

clientRequestIdstringOptional<=64 characters

Tự sinh phía client, giúp retry an toàn (idempotent).

Response

Ghi chú vừa tạo — {id, success}.

idstringOptional
successbooleanOptional
accessTokenstringOptional

Chỉ có ở lượt đánh giá mở link.

expiresAtlongOptional

Chỉ có ở lượt đánh giá mở link.

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