Skip to main content
위젯은 방문자마다 ID를 두고 채팅과 브라우저 통화를 그 ID로 한 고객에게 쌓아요. 서비스의 사용자 키를 방문자 ID로 넘기면 다른 기기에서 들어와도 같은 고객으로 이어져요. 위젯 방문자로 식별된 고객의 상세 화면에 메모리 두 건과 채팅 타임라인이 보이는 모습

방문자 ID로 같은 고객 잇기

서비스가 관리하는 사용자 키를 설치 코드의 data-visitor-id에 넣으세요. 로그인한 회원처럼 한 사람에게 늘 같은 값이면 되고, 길이는 255자까지예요. 이 값은 v3 API의 external_id와 다른 식별자예요.
방문자 ID는 워크스페이스 안에서 고유해요. 어느 위젯에서 시작했든 같은 값이면 채팅과 브라우저 통화가 같은 고객으로 묶여요. 전화 콜백은 방문자가 남긴 전화번호로 고객을 찾아요.
data-visitor-id는 브라우저에 그대로 보여서 방문자가 바꿀 수 있어요. 로그인 여부나 권한을 판단하는 데 쓰지 마세요.
이메일이나 순번 회원 번호처럼 추측하기 쉬운 값보다 무작위 토큰이나 해시한 값을 넣으세요.

익명 방문자 다루기

data-visitor-id를 빼면 위젯이 브라우저에 방문자 ID를 만들어 두고 다음 방문에도 다시 써요. 같은 브라우저에서 시작한 채팅과 통화는 한 고객으로 모여요. 이 ID는 사이트 단위라 한 사이트에 위젯을 여러 개 두어도 방문자는 하나예요. 다른 기기나 브라우저, 시크릿 창에서 들어오거나 브라우저 저장소를 지우면 기존 ID를 찾지 못해 새 고객이 생겨요. 같은 사람이면 고객에서 식별자를 추가하거나 두 고객을 병합하세요.

대시보드에서 방문자 찾기

방문자 ID만 있는 고객은 목록과 상세에 방문자 434BF96B처럼 ID에서 만든 짧은 코드로 보여요. 넘긴 값 자체는 화면에 보이지 않아요.
  • 넘긴 값으로 찾을 때: 고객 목록 검색창에 data-visitor-id 값을 그대로 넣으세요. 화면에 보이지 않아도 찾을 수 있어요.
  • CRM의 고객과 맞출 때: 고객 상세에서 식별자 추가로 외부 ID를 등록하세요. 방문자 ID와 외부 ID는 다른 식별자라 같은 문자열이어도 저절로 합쳐지지 않아요. 외부 ID를 등록해 두면 서버 연동에서 그 external_id로 시작한 대화도 이 고객의 기록으로 들어가요.

통화에서 일어나는 일

  • 첫 응답 전에 지난 메모리를 불러와요. 에이전트의 메모리 활성화가 켜져 있으면 같은 고객의 메모리를 읽고 응대를 시작해요. 설치 코드에서 따로 할 일은 없어요.
  • 대화가 끝나고 수십 초 뒤에 저장해요. 방문자가 메시지를 한 번도 보내지 않은 채팅은 저장하지 않아요.
  • 메모리는 고객과 에이전트 단위로 나뉘어요. 위젯마다 다른 에이전트를 연결하면 서로의 메모리를 보지 않아요. 저장 규칙은 메모리에 있어요.

문제가 생겼을 때

고객 상세의 다른 고객과 병합으로 두 고객을 합치세요. 앞으로는 로그인 직후부터 data-visitor-id를 넘기세요. 로그인 전 익명 대화, 로그인 뒤 대화, 다른 기기에서 한 대화는 각각 다른 고객으로 쌓여요. 방문자 ID가 바뀌면 진행 중이던 대화는 새 대화로 시작되고, 이전 대화는 이전 고객에 남아요.
위젯에 연결한 에이전트의 메모리 활성화가 켜져 있는지, 지난 대화를 같은 에이전트와 했는지 확인하세요. 직전 대화가 끝나지 않았거나 막 끝났다면 아직 저장 전일 수 있어요. 전화 콜백은 방문자 ID가 아니라 전화번호로 찾은 고객의 메모리를 써요.
원래 값은 고객 목록 검색창에 넣어 찾으세요. 화면에서도 봐야 하면 같은 값을 외부 ID로 추가하세요. 방문자 ID가 짧은 코드로만 보이는 건 정상이에요.

관련 문서

  • 위젯 개요: 위젯 만들기, 설치, 게시
  • 고객: 고객 식별자 추가와 중복 고객 병합
  • 메모리: 사실 저장과 응답 전 불러오기 규칙