Skip to main content
GET
식별자로 고객 조회

Authorizations

Authorization
string
header
required

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

Query Parameters

identifier_value
string
required

조회할 식별자 값입니다.

identifier_type
enum<string> | null

식별자 유형입니다. phone, email, external_id 중 하나입니다. 생략하면 phone, email, external_id 순서로 일치하는 첫 고객을 반환합니다.

Available options:
phone,
email,
external_id,
kakao,
vox_user,
device

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

고객 메모입니다.