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이면 해당 이름을 삭제합니다. 각 이름에는 활성 정의가 필요합니다.

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

고객 메모입니다.