Skip to main content
고객 레코드는 한 고객과 주고받은 모든 인터랙션을 묶는 단위입니다. 통화 기록, 채팅, 메모리, 고객 속성이 모두 고객에게 귀속되므로, 고객 상세 화면 한 곳에서 그 고객과의 이력 전체를 볼 수 있습니다. 전화 채널만 사용한다면 고객을 미리 등록하지 않아도 됩니다. 일치하는 고객이 없을 때 대화 시작과 함께 자동 생성됩니다.

고객이 만들어지는 방식

전화 채널에서는 통화 상대방의 전화번호로 고객을 식별합니다. 일치하는 고객이 없으면 통화 시작 시 고객 레코드를 자동으로 만들고, 통화 기록과 추출한 정보를 그 고객에게 귀속합니다. CRM 등 외부 시스템의 고객 ID를 쓰고 있다면 customer_external_id를 전달하세요. API로 발신 통화를 만들 때 이 값을 전달하면 전화번호 대신 외부 ID로 고객을 조회하거나 만들고, 통화를 해당 고객에게 바로 귀속합니다. 이미 만들어 둔 고객 레코드가 있다면 customer_id에 고객 ID를 전달해 해당 고객을 직접 지정할 수도 있습니다. API 채팅과 SDK 웹 세션도 같은 방식으로 전달해야 고객에게 귀속됩니다.

채널별 지원 범위

이럴 때 사용하세요

재문의 이력 연결

같은 번호로 다시 전화한 고객의 이전 통화, 메모리와 속성을 한 곳에서 확인합니다.

CRM 고객 연결

발신 통화와 API 채팅에 외부 고객 ID를 전달해 vox.ai의 고객과 CRM 레코드를 연결합니다.

중복 고객 정리

서로 다른 식별자로 나뉜 레코드가 같은 고객임을 확인한 뒤 하나로 병합합니다.

예시: CRM 고객에게 발신하기

CRM의 고객 ID가 cus_1024인 고객이 있다고 가정합니다. 발신 통화를 만들 때 customer_external_id에 같은 값을 전달하면 해당 통화와 이후 추출 결과가 이 고객에게 귀속됩니다. API 채팅에서도 cus_1024를 계속 사용하면 채널이 달라도 같은 고객 이력에 기록됩니다.
수신 통화는 발신 전화번호로 고객을 찾습니다. 고객이 다른 번호로 전화하면 별도 고객이 생길 수 있으므로, 같은 사람임을 확인한 뒤 병합하세요.

고객 정보 관리하기

고객 상세 화면에서 이름과 메모를 수정하고, 외부 시스템 연동에 사용하는 메타데이터를 추가·수정·삭제할 수 있습니다. 대화에서 자동 추출된 고객 속성과 메모리는 같은 화면에서 확인할 수 있습니다. 고객 속성 값은 고객 상세 화면에서 직접 수정할 수 없습니다. 자동 추출 결과를 정정해야 한다면 v3 API를 사용하세요. 메모리는 잘못되거나 오래된 항목을 대시보드에서 삭제할 수 있지만, 추가와 수정은 지원하지 않습니다. 전화번호·이메일·외부 ID 같은 식별자는 대시보드에서 편집할 수 없고, v3 API로 추가하거나 삭제할 수 있습니다. 고객 레코드 자체의 생성·병합·삭제도 API를 지원합니다. 자세한 방법은 v3 API 참조를 확인하세요.

권장 운영법

  • 변하지 않는 외부 ID를 사용하세요. CRM의 내부 고객 키처럼 다른 고객에게 재사용하지 않고 바꾸지 않는 값을 권장합니다. 이름이나 이메일처럼 수정될 수 있는 값을 외부 ID로 쓰지 마세요.
  • 모든 API 채널에서 같은 ID를 전달하세요. 발신 통화에는 ID를 전달하고 채팅에서는 생략하면 고객 이력이 나뉩니다.
  • 병합 전 식별자를 확인하세요. 서로 다른 사람을 병합하면 통화 기록, 메모리와 채팅이 한 고객에게 모입니다. 전화번호와 외부 ID를 모두 확인한 뒤 병합하세요.
  • 식별자와 고객 정보의 역할을 나누세요. 고객을 찾는 키는 식별자로 관리하고, 분류나 검색에 쓸 값은 고객 속성으로 관리하세요.
병합하면 중복 고객의 식별자·통화 기록·채팅·메모리는 기준 고객으로 옮기지만, 이름·메모·고객 속성은 폐기합니다. 필요한 값은 병합 전에 기준 고객으로 옮기세요.

고객, 고객 레코드, 고객 식별, 고객 귀속, customer, customer_external_id, 외부 ID, 전화번호 식별, CRM 연동