> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 고객

> 전화, 문자, 채팅 상대를 고객별로 정리하고 대화 맥락을 이어서 활용합니다.

vox.ai는 전화, 문자, 채팅 상대를 사람 단위 고객으로 자동 정리합니다.
고객별 대화 내용을 메모리로 기억해 다음 응대에 활용합니다.

예를 들어 고객이 전화로 문의한 뒤,
다음 날에는 채팅으로 다시 연락합니다.
에이전트는 이전 대화 맥락을 이어서 응대합니다.

## 기본은 자동입니다

별도 설정 없이도 같은 고객을 다시 알아봅니다.

* 전화와 문자는 상대방 전화번호로 연결합니다.
* 웹사이트 위젯은 브라우저 식별자로 연결합니다.
* 어떤 채널에서도 고객을 식별할 수 없으면 익명 고객을 만듭니다.

나중에 고객이 식별되면 기존 고객과 병합할 수 있습니다.

## 내 시스템의 고객과 연결하기

기본 자동 연결만 사용한다면 설정할 것이 없습니다.
CRM처럼 내 시스템이 이미 관리하는 고객 ID로 대화를 모으고 싶을 때만
아래 두 가지 방법으로 연결합니다.

* **서버 연동** — 내 시스템의 고객 ID를 `external_id`로 전달하면
  해당 대화가 그 고객에게 연결됩니다.
* **웹사이트와 앱** — 내 서비스가 관리하는 방문자 ID를 전달하면
  같은 방문자의 대화가 한 고객으로 이어집니다.

설정 방법은 [JavaScript SDK](/docs/sdk/javascript) 문서를 참고하세요.

## 고객 데이터 확인·관리

대시보드에서 고객 정보와 대화 이력을 확인합니다.
API에서는 고객 조회와 병합, 삭제를 지원합니다.
API에서 고객을 만들거나 찾을 때는
`phone`, `email`, `external_id`만 사용합니다.
자세한 내용은 [v3 API 참조](/api-reference/v3/introduction)를 확인하세요.

<Note>
  서로 다른 고객에 나뉘어 저장된 기록은 자동으로 합쳐지지 않습니다.
  같은 사람인지 확인한 뒤 병합하세요.
</Note>

## 채널별 동작 상세

<Accordion title="채널별 고객 연결 방식">
  | 채널            | 고객 연결 방식                                            |
  | ------------- | --------------------------------------------------- |
  | 전화, 문자        | 상대방 전화번호로 자동 연결                                     |
  | 웹사이트 위젯       | 브라우저 식별자로 자동 연결. `data-visitor-id`를 전달하면 해당 방문자로 연결 |
  | 웹 SDK         | 브라우저 식별자로 자동 연결. `visitorId`를 전달하면 해당 방문자로 연결       |
  | 앱 SDK         | `visitorId`를 전달하면 해당 방문자로 연결. 값이 없으면 익명 고객 생성       |
  | 서버 연동         | `external_id`를 전달하면 해당 고객으로 연결. 값이 없으면 익명 고객 생성     |
  | 카카오 상담톡       | 서버가 카카오 사용자 키로 자동 연결                                |
  | vox.ai 로그인 세션 | 서버가 로그인 사용자로 자동 연결                                  |
  | 공유 링크         | 서버가 브라우저 기기 식별자로 자동 연결                              |

  카카오 상담톡 사용자 키, vox.ai 로그인 사용자,
  브라우저 기기 ID는 서버가 자동으로 연결합니다.
  직접 설정할 필요가 없습니다.
  고객 조회 API 응답에 표시될 뿐입니다.
</Accordion>

<Warning>
  상담원에게 이관하면 메모리는 이관 전 구간까지만 이어집니다.
</Warning>

***

<Accordion title="연관 검색어">
  고객, 고객 관리, 고객 메모리, 고객 식별, 고객 병합, 익명 고객, customer, external\_id, visitorId, CRM 연동
</Accordion>
