Skip to main content
POST
고객 생성

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Body

application/json

생성할 고객 정보입니다. 식별자가 하나 이상 필요합니다.

고객을 생성하는 요청입니다. 조회 후 생성 방식이 아닙니다.\n\n식별자가 하나 이상 필요합니다. 식별자가 없는 고객은 생성할 수 없습니다.

identifiers
CustomerIdentifierInput · object[]
required

고객 식별자입니다. 하나 이상 필요합니다.

Minimum array length: 1
name
string | null

고객 이름입니다.

note
string | null

고객 메모입니다.

metadata
Metadata · object | null

고객 메타데이터입니다. 생략하거나 null이면 빈 객체를 생성합니다.

Response

성공 응답

목록 항목 형상에 메타데이터와 인터랙션 요약을 추가한 고객 응답입니다.

식별자 검색, 생성, 수정, 병합에서 반환합니다. CustomerListItemResponse에는 인터랙션 요약이 없으므로 목록 조회의 집계 비용을 줄입니다. 인터랙션 요약은 이 응답을 사용하는 경로에서만 제공합니다.

메모리는 이 응답에 없으며 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

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

name
string | null

고객 이름입니다.

note
string | null

고객 메모입니다.