식별자로 고객 조회
인증된 조직에서 식별자로 고객 한 명을 찾습니다. 전화번호는 한국 표준 형식으로, 이메일은 소문자로 정규화하며 external_id의 앞뒤 공백은 제거합니다. identifier_type을 지정하면 해당 유형만 검색합니다. 생략하면 전화번호, 이메일, external_id 순서로 검색해 처음 일치한 고객을 반환합니다. 일치하는 고객이 없으면 404 CUSTOMER_NOT_FOUND를 반환합니다.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Query Parameters
조회할 식별자 값입니다.
식별자 유형입니다. phone, email, external_id 중 하나입니다. 생략하면 phone, email, external_id 순서로 일치하는 첫 고객을 반환합니다.
phone, email, external_id, kakao, vox_user, device Response
성공 응답
목록 항목 형상에 메타데이터와 인터랙션 요약을 추가한 고객 응답입니다.
식별자 검색, 생성, 수정, 병합에서 반환합니다. CustomerListItemResponse에는 인터랙션 요약이 없으므로 목록 조회의 집계 비용을 줄입니다. 인터랙션 요약은 이 응답을 사용하는 경로에서만 제공합니다.
메모리는 이 응답에 없으며 CustomerDetailResponse에만 있습니다. 식별자 검색, 생성, 수정, 병합에서는 메모리를 불러오지 않습니다. 메모리 필드를 포함하면 실제 메모리가 없는 것처럼 보이는 빈 그룹을 반환하므로 고객 단건 조회에서만 제공합니다.
고객 UUID입니다.
자동 추출한 고객 속성 값입니다. 이름에 해당하는 정의가 없어도 저장된 값을 유지합니다.
리소스 생성 시각입니다. 밀리초 단위 unix timestamp입니다.
리소스 수정 시각입니다. 밀리초 단위 unix timestamp입니다.
고객 신원 식별자 목록입니다.
고객 메타데이터입니다.
통화와 채팅 인터랙션의 집계 요약입니다.
고객 이름입니다.
고객 메모입니다.