Skip to main content
PATCH
고객 수정

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

customer_id
string<uuid>
required

고객 식별자입니다.

Body

application/json

수정할 고객 필드입니다.

고객에서 하나 이상의 필드를 수정하는 요청입니다.\n\n생략한 필드는 유지합니다. metadata는 최상위 키를 병합합니다.

name
string | null

고객 이름입니다. 생략하면 현재 값을 유지합니다.

note
string | null

고객 메모입니다. 생략하면 현재 값을 유지합니다.

metadata
Metadata · object | null

고객 메타데이터입니다. 전달한 키를 추가하거나 수정하며 생략한 키는 유지합니다. 키 삭제는 지원하지 않습니다.

identifiers
CustomerIdentifierInput · object[] | null

이 고객에게 추가할 식별자입니다. 생략하면 식별자를 수정하지 않습니다.

attributes
Attributes · object | null

수정할 고객 속성 값입니다. 전달한 이름만 변경하며, null이면 속성 정의가 비활성화되거나 삭제된 경우에도 해당 값을 삭제합니다. null이 아닌 값을 설정하려면 활성 속성 정의가 필요합니다.

Response

성공 응답

식별자 검색, 생성, 수정, 병합 경로에서 반환하는 고객 응답입니다.

메모리는 고객 단건 조회가 반환하는 CustomerDetailResponse에만 있습니다.

id
string
required

고객 UUID입니다.

attributes
Attributes · object
required

자동 추출한 고객 속성 값입니다. 이름에 해당하는 정의가 없어도 저장된 값을 유지합니다.

created_at
integer
required

리소스 생성 시각입니다. 밀리초 단위 unix timestamp입니다.

updated_at
integer
required

리소스 수정 시각입니다. 밀리초 단위 unix timestamp입니다.

identifiers
CustomerIdentifierResponse · object[]
required

고객 신원 식별자 목록입니다.

metadata
Metadata · object
required

고객 메타데이터입니다.

interaction_summary
CustomerInteractionSummary · object
required

통화, 채팅, SMS 인터랙션의 집계 요약입니다.

name
string | null

고객 이름입니다.

note
string | null

고객 메모입니다.