샵바이 (shop by)

📘

샵바이는 채널톡 공식 빌더사로, 클릭 몇 번만으로 3분 안에 설치가 가능합니다.

채널톡 설치하기

  1. NHN커머스 앱스토어에서 [설치하기] 버튼을 클릭해주세요.


  1. 설치할 쇼핑몰을 선택하고 [설치] 버튼을 클릭해주세요.


  1. 사용 권한 및 서비스 이용 약관 동의 화면에서 [동의 및 설치] 버튼을 클릭하면 채널톡 앱이 설치됩니다. 다음 단계인 앱 실행까지 진행하시면 연동이 완료됩니다.


  1. 쇼핑몰 관리자 어드민 > 앱 서비스 > 앱 리스트 에서 채널톡 앱의 [실행] 버튼을 클릭하면 채널톡 연동을 시작합니다. [연동 시작하기]를 눌러 순차적으로 진행해주세요.


  1. 채널톡 계정 생성 후 채널톡 버튼을 설치합니다.
  • 내 채널 목록에서 연결할 채널을 선택해 주세요. 만약 내 채널이 여러 개라면 사이트와 연동할 1개의 채널을 선택해 주세요.

  • 채널톡 스크립트 설치 버튼을 클릭하면 자동으로 설치됩니다.


  1. 채널톡 설치가 완료되었습니다! 웹사이트 우측 하단에 채널톡 버튼이 생성된 것을 확인해주세요. 이제 채널톡 관리자로 이동하여 채널 설정을 완료하고 고객과 상담을 시작할 수 있습니다.


3) 고객 주문 정보

고객과 상담 할 때, 오른쪽 사이드뷰 에서 주문 상품, 결제 금액, 결제 수단, 배송 정보까지 상세 주문 정보를 확인하실 수 있어요. (여기서 보이는 주문정보는 마케팅 캠페인이나 서포트봇 필터로 사용하실 수는 없습니다.)



샵바이에서 제공하는 고객 정보

채널톡을 설치한 후 기존 회원이 웹사이트에 방문하여 로그인 하거나 신규 회원이 회원가입할 때 해당 고객 정보가 채널톡으로 자동으로 연동됩니다.

1) 고객 프로필 정보

고객과 상담을 진행할 때 오른쪽 사이드뷰 에서 고객 정보를 확인하고 밀착형 응대를 진행해보세요. 아래 데이터 값을 기준으로 필터를 적용하여 CRM 마케팅에 활용할 수 있어요.

채널톡 고객 정보 및 DB 활용 가이드 https://channel.io/ko/guides/contacts

데이터 값설명비고
memberId각 회원을 구분하는 고유값 (회원 번호 등)
name회원 이름
email회원 이메일
mobileNumber회원 휴대폰 번호
groupName회원 등급
signedUpAt회원 가입일시
extMemberId샵바이 로그인 아이디외부연동 ID로 가입 시 null
unsubscribeEmail마케팅 이메일 수신거부
unsubscribeTexting마케팅 문자메시지 수신거부
lastCheckoutCompletedAt최근 주문 시간채널톡 설치 후 고객이 실제로 주문한 적이 있어야 집계됨

2) 이벤트(event) 정보

고객이 특정 행동을 하는 타이밍에 맞춰 메시지를 보내는 마케팅 캠페인 설정시 유용하게 사용할 수 있어요.

  • 이벤트의 하위 정보(property) 중 products 의 경우 개별 고객 정보의 상세 이벤트 데이터에서만 확인하실 수 있습니다. 마케팅 메시지(일회성, 캠페인)에서는 사용하실 수 없습니다.
데이터 값설명이벤트 스펙
SignUp회원 가입
CheckoutComplete주문 완료- id : 주문 번호 - totalAmount : 결제 금액 - paymentMethods : 결제 수단 - shippingAmount : 배송비 - productsSummary : 상품 요약 - products : 상품 정보 나열(상품 id, 이름, 개수, 가격)
ProductView상품 조회- id : 상품 id - name : 상품명 - amount: 상품 가격

3) 고객 주문 정보

📘

2023.12.08부터 주문 내역 정보가 연동됩니다.

샵바이를 통해 채널톡을 설치하신 경우 자사몰 내의 회원 주문 내역이 상담할 때 확인 가능합니다.

고객과 상담 할 때, 오른쪽 사이드뷰 에서 주문 상품, 결제 금액, 결제 수단, 배송 정보까지 상세 주문 정보를 확인하실 수 있어요. (여기서 보이는 주문정보는 마케팅 캠페인이나 서포트봇 필터로 사용하실 수는 없습니다.)


채널톡 설치 해제하기

  • 쇼핑몰 관리자 어드민 > 앱 서비스 > 앱 리스트 에서 채널톡 앱의 [실행] 을 클릭합니다. 바로 연결되는 채널톡 페이지에서 [설치 해제]를 눌러 진행해주세요. 설치를 해제해도 채널에서의 기존 상담 내역은 삭제되지 않습니다.

샵바이 앱 권한 업데이트

📘

2023.11.17 이전 샵바이를 통해 채널톡을 설치하신 경우 아래 과정을 진행해 주세요.

원활한 주문 내역 연동을 위해 추가 권한 업데이트가 필요합니다.

2023년 11월 17일부터 샵바이를 통해 채널톡을 설치한 경우, 상담할 때 자사몰 회원의 주문 내역이 상담 정보에 연동됩니다. 11월 17일 이전 설치 사용자는 다시 한번 권한을 동의하여 재연동을 완료해주세요.

  1. 샵바이 관리자 페이지에서 [앱 서비스] -> [앱 리스트]를 눌러주세요.

  1. 설치한 앱에서 [채널톡]을 찾아주시고 [실행] 버튼을 눌러주세요.


샵바이 프리미엄 가이드


채널톡은 샵바이 SDK를 활용해서 고객 정보를 불러옵니다.

샵바이 프리미엄 고객사의 경우 원활한 고객 정보 및 주문 정보 연동을 위해서 아래의 가이드에 따라 개발해주시기 바랍니다.

샵바이 개발자 문서 링크




스크립트 로드

아래의 문서를 참고하여 상점에 설치된 스크립트를 로드하도록 개발해야 합니다.

문서 링크


글로벌 변수 세팅

  1. 먼저 글로벌 객체 sb의 선언이 필요합니다.
var sb

profile 변수를 선언하고, 내부에 샵바이 회원 정보 조회 API를 활용해 회원의 정보를 가져올 수 있게 합니다.

API 문서 링크


// 오브젝트의 값들은 API의 결과물을 기반으로 할당되어야 합니다.
sb.profile = {
  "memberNo": 고객 고유번호 (비로그인 시에는 undefined or null),
  "directMailAgreed": 마케팅 이메일 수신 동의 여부 (true/false),
  "smsAgreed": 마케팅 SNS 수신 동의 여부 (true/false),
  "email": 고객 이메일,
  "mobileNo": 고객 핸드폰 번호,
  "memberGradeName": 고객 등급,
  "joinYmdt": 고객이 가입한 날짜 + 시간,
  "memberName" : 고객 이름
};

아래의 값은 예시입니다


sb.profile = {
  "memberNo": 1,
  "directMailAgreed": true,
  "smsAgreed": false,
  "email": "[email protected]",
  "mobileNo": "010-1234-1234",
  "memberGradeName": "실버",
  "joinYmdt": "2022-02-22 13:23:44",
  "memberName": "홍길동"
}

  1. 글로벌 변수 세팅이 올바르게 되었는지 콘솔에서 확인합니다.
  • console.log(window.sb.profile) 시 위 예시와 비슷한 오브젝트가 출력되어야 합니다.