파라미터 관리

상담 시 필요한 고객 유입 정보를 매칭하여 설정합니다.

파라미터는 '변수'로, 상담 시 필요한 고객의 유입 정보를 [채팅] > [고객정보]에 매칭하여 상담을 할 수 있습니다. 해당 기능은 개발자 지원이 필요합니다.

1. 고정 파라미터

고정 파라미터 변수명을 사용하면, [채팅] > [고객정보] > 기본 정보에 매칭되도록 사용할 수 있어요. 제공하는 고정 파라미터는 다음과 같습니다.

값 구분	변수	이름	데이터 타입	데이터 길이	입력 가능	데이터 샘플	설명
고객	site_uid	회원 고유 식별번호	String	255	Yes	loginid	회원을 식별하는 값(로그인 ID, 회원 고유번호 등)
고객	cus_extra_username	고객 이름	String	100	Yes	사람이름	고객 이름
고객	cus_extra_phone	고객 전화번호	String	100	Yes	01012345678	고객 전화번호
고객	cus_extra_email	고객 이메일	String	100	Yes	happytalk@ happytalk.io	고객 이메일
대화방	user_parameter	사용자변수	String	200	Yes	abcdabcd	커스텀 작업 시 활용

값 구분

변수

이름

데이터 타입

데이터 길이

입력 가능

데이터 샘플

설명

고객

site_uid

회원 고유 식별번호

String

255

Yes

loginid

회원을 식별하는 값(로그인 ID, 회원 고유번호 등)

고객

cus_extra_username

고객 이름

String

100

Yes

사람이름

고객 이름

고객

cus_extra_phone

고객 전화번호

String

100

Yes

01012345678

고객 전화번호

고객

cus_extra_email

고객 이메일

String

100

Yes

happytalk@ happytalk.io

고객 이메일

대화방

user_parameter

사용자변수

String

200

Yes

abcdabcd

커스텀 작업 시 활용

site_uid 는 고객 정보 중 ID,
cus_extra_username 은 이름,
cus_extra_phone 은 전화,
cus_extra_email 을 사용하면 이메일로 자동 유입되도록 사용할 수 있습니다.

각 파라미터 변수는 해피톡에서 제공하는 채팅 URL 뒤에 붙여 고객이 채팅 버튼 등을 클릭하여 인입 시 원하는 값을 불러오도록 해주셔야 합니다. 파라미터를 통하여 입력된 값은 가장 최근에 들어온 정보로 업데이트되는데요. 예를 들어 이미 파라미터를 통하여 인입된 정보가 있는 고객이 다른 변수로 재인입되는 경우 최신 고객 정보로 변경됩니다.

해피톡에서 제공하는 채팅 URL은 [서비스설정] > [기본 설정] > [채팅 버튼 설정] 에서 확인할 수 있어요. 커스텀 파라미터의 경우 설정 적용 시 채팅 URL 뒤에 자동으로 붙지만, 고정 파라미터의 경우 채팅 URL 복사 후 임의로 추가해 주셔야 합니다.

이제 17-2. 이미지와 같이 실제 적용 예시를 보여드릴게요. 😊

카카오톡채팅URL&site_uid=happytalk&cus_extra_username=operation&cus_extra_phone=16665263&cus_extra_email=help@happytalk.io

웹채팅V2URL&params=site_uid=happytalk,cus_extra_username=operation,cus_extra_phone=16665263,cus_extra_email=help@happytalk.io

여러 파라미터 변수를 사용하는 경우, 다른 파라미터와 구분을 해주어야 하는데요. 카카오톡 채널은 &, 웹채팅v2는 ,(콤마), 네이버톡톡은 | (Shiht key + ￦)로 사용합니다. 예를 들어, 아래와 같이 사용할 수 있습니다. (웹채팅v2는 앞에 params가 추가로 붙습니다.)

카카오톡채팅URL&site_uid={고객ID}&cus_extra_username={고객이름}&cus_extra_phone={전화번호}
웹채팅v2채팅URL&params=site_uid=('고객ID'),cus_extra_username=('고객이름'),cus_extra_phone=('전화번호')
네이버톡톡채팅URL|site_uid={고객ID}|cus_extra_username={고객이름}|cus_extra_phone={전화번호}

웹채팅v1 버전을 이용 중인 경우, ID는 site_uid가 아닌 uid로 사용할 수 있어요. 채팅 URL에서 is_login=N을 is_login=Y로 변경하고 뒤에 &uid={고객ID}를 넣어주시면 됩니다. (아이디를 확인할 수 없는 경우에는 in_login=N, &uid=빈 값으로 불러와야 합니다.) 웹채팅v1과 v2 버전의 차이는, 기본 설정 - 채팅 버튼 설정을 확인해 주세요. 🥰

ID를 기준으로 고객정보와 상담이력을 하나로 연동할 수 있는데요, 예를 들어 특정 ID로 다른 고객정보(이름, 전화 등)가 입력되어 있는 경우, site_uid 파라미터를 활용하여 동일한 ID로 인입되면 다른 고객정보(cus_extra_username 등) 파라미터는 사용하지 않았더라도 같은 정보로 보여집니다. site_uid 파라미터를 활용하여 ID 정보가 인입되는 경우 고객식별번호가 다르더라도 상담이력을 하나로 연동할 수 있습니다. __인입 채널이 다르더라도(예를 들어 같은 사용자가 웹채팅과 카카오톡 채널을 통해 따로 각각 인입되는 경우) 같은 ID로 수정해 주거나, 동일하게 같은 site_uid 파라미터로 인입된다면 상담 이력을 합칠 수 있어요.

site_uid를 활용하여 ID 정보가 인입되는 경우, ID가 확인되지 않는 사용자는 빈 값으로 들어오도록 해주셔야 합니다._ _(채팅URL&site_uid=&다른 파라미터) 만약, ID가 없을 때 임의의 값으로 설정하는 경우(예: site_uid=undefined) 해당 사용자들의 모든 고객정보와 상담이력이 하나로 연동되는 점 주의하여 사용해 주세요.

웹채팅은 site_uid를 같은 아이디로 들어오도록 작업하는 경우에는 모두 같은 상담방으로 인식됩니다. 카카오는 개별 카카오톡 계정으로 구분되므로 site_id가 달라도 다른 방으로 인식하는 차이가 있습니다.

고객식별번호는 고객 개개인을 식별하도록 돕는 고유의 값을 의미합니다. 카카오톡 채널과 네이버톡톡은 각각 카카오, 네이버에 로그인 후 인입되므로 해당 계정을 구분해 주는 난수값으로 표기됩니다. 상담방은 '고객식별번호'를 기준으로 생성되는데요, 웹채팅은 site_uid로 고객 ID가 인입되는 경우 고객식별번호가 "사이트아이디_고객 ID"로 변경되어 ID가 같으면 모두 동일한 상담방으로 인식됩니다. 카카오톡 채널과 네이버톡톡은 해당 채널의 계정에 로그인하여 인입되므로 site_uid가 달라도, 서로 다른 방으로 인식하게 됩니다. 예를 들어, site_uid로 고객 ID를 "happytalk"으로 생성하는 경우 - 웹채팅은 동일한 고객 ID로 인입되는 모든 사용자가 같은 상담방으로 인입되고, - 카카오톡 채널, 네이버톡톡은 고객 ID가 같아도 서로 다른 상담방으로 인입됩니다. - 채널 구분 없이 고객ID 외에 입력된 고객정보가 있는 경우 최신 값을 기준으로 동일하게 입력되고, 상담 이력도 모두 연동됩니다.

[채팅] > 고객정보 > 기본 정보에는 '전화'와 '휴대폰' 정보가 있습니다.

'전화'는 파라미터, 프로필봇, 개별 입력한 전화번호로, 수정이 가능합니다. 고정 파라미터(cus_extra_phone)로 인입된 정보는 '전화'에 입력됩니다.
'휴대폰'은 SMS, 카카오싱크 등 인증 수단을 통해 본인 인증이 완료된 휴대폰 번호를 의미합니다. 인증이 완료된 정보로, 임의로 수정할 수 없습니다.

파라미터 값은 한글을 입력할 경우 인코딩하여 사용해 주세요. 한글을 직접 입력하면, 인터넷 익스플로러(IE)에서 인입 시에는 위와 같이 파라미터 값이 깨져 보일 수 있습니다.

이외에도 [서비스설정] > [고급 설정] > [상담정보 관리] 의 커스텀 상담정보 URL에서는 파라미터로 상담방의 정보를 포함하여 전달할 수 있습니다. 이때 변수값은 []로 묶어서 사용합니다.

https://주소/?parameter1=[parameter1]&parameter2=[parameter2]

예를 들어 위와 같은 형태로 연결 URL을 설정하고 [parameter1]에 파라미터로 설정한 값을 불러오도록 해주시면 됩니다. 더 자세한 내용은 상담정보 관리를 참고해 주세요. 🥰

값 구분	변수	이름	데이터 타입	데이터 길이	입력가능	데이터 샘플	설명
대화방	category_id	상담분류번호(대분류)	Int	11	Yes	74133	상담 분류 관리의 대분류 id
대화방	division_id	상담분류번호(중분류)	Int	11	Yes	74134	상담 분류 관리의 중분류 id
대화방	category_name	상담분류명(대분류)	String	100	No	상품문의	상담 분류 관리의 대분류 이름
대화방	division_name	상담분류명(중분류)	String	100	No	일반상담	상담 분류 관리의 중분류 이름

값 구분

변수

이름

데이터 타입

데이터 길이

입력가능

데이터 샘플

설명

대화방

category_id

상담분류번호(대분류)

Int

Yes

74133

상담 분류 관리의 대분류 id

대화방

division_id

상담분류번호(중분류)

Int

Yes

74134

상담 분류 관리의 중분류 id

대화방

category_name

상담분류명(대분류)

String

100

상품문의

상담 분류 관리의 대분류 이름

대화방

division_name

상담분류명(중분류)

String

100

일반상담

상담 분류 관리의 중분류 이름

각 상담방의 상담 분류를 구분해 주는 상담분류번호와 상담분류명 파라미터도 있는데요. 상담분류번호(category_id / 웹채팅v2에서는 categoryID 입니다.)를 채팅 URL에 구분하여 자동으로 상담 분류를 구분하거나, 상담 배분(상담 분류별 상담원 지정배분)에 활용할 수 있습니다.

상담분류명은 상담 제목 메시지에 넣어 고객 인입 시에 구분하여 활용할 수 있어요. 상담 분류와 관련된 더 자세한 내용은 상담 분류 관리에서 확인할 수 있습니다. 🥰

카카오톡 채널에서 카카오i 오픈빌더 챗봇을 사용하는 경우, 채팅 URL에 botstart 파라미터를 사용하여 바로 상담톡으로 연결되는 게 아닌 오픈빌더 챗봇으로 시작하도록 사용할 수 있습니다. 카카오톡 채팅 URL 뒤에 &bot_start=true 를 붙여주면 됩니다.

2. 커스텀 파라미터

고정 파라미터에서 제공하지 않는 값은 커스텀 파라미터를 설정하여 활용할 수 있습니다.

[서비스설정] > [고급 설정] > [파라미터 관리] > Custom 파라미터 설정에서 원하는 변수를 사용에 체크하고, 파라미터 설명에 기입합니다. 예를 들어 '유입경로' 정보를 받으려면, parameter1 사용에 체크하고 설명에 입력해 주세요.

커스텀 파라미터를 설정하면, [서비스설정] > [기본 설정] > [채팅 버튼 설정] 에서 채팅창url복사 시 자동으로 구분되어 입력되어 있는 것을 확인할 수 있습니다. 채팅 URL 뒤에 &parameter1={유입경로}&parameter2={유저구분}과 같이 각 파라미터 변수 뒤에 고객이 채팅 버튼 클릭하여 인입 시 값을 불러오도록 해주시면 됩니다.

[서비스설정] > [기본 설정] > [채팅 버튼 설정 v2] 에서 소스보기를 통해 채팅 버튼 소스를 확인할 수 있는데요. 이 소스 내에 고정 및 커스텀 파라미터를 // 부분을 삭제하고 여러 파라미터는 ,(콤마)로 구분하여 입력할 수 있습니다.

// 고정 및 Custom 파라미터 추가 영역, 파라미터가 여러개인 경우 ,(콤마)로 구분
window.__ht_wc.params = 'site_uid=abcd1234,parameter1=param1';

예를 들어 위와 같이 인입된 파라미터는 버튼 소스 내에 아래와 같이 설정되어 있습니다.

<script>
  window.__ht_wc = window.__ht_wc || {};
  window.__ht_wc.host = 'design.happytalkio.com';
  window.__ht_wc.site_id = '사이트아이디(변경불가); // site_id
  window.__ht_wc.site_name = '상호명(프로필명)'; // 회사 이름
  window.__ht_wc.category_id = '대분류번호'; // 대분류 id
  window.__ht_wc.division_id = '중분류번호'; // 중분류 id
  
  // 고정 및 Custom 파라미터 추가 영역, 파라미터가 여러개인 경우 ,(콤마)로 구분
window.__ht_wc.params = 'site_uid=happytalk123,parameter1=happybook,parameter2=paid user';
  // 앱 개발시, 웹뷰 Local Storage 사용가능하도록 처리
    
  (function() {
    var ht = document.createElement('script');
    ht.type = 'text/javascript';
    ht.async = true;
    ht.src = ('https:' == document.location.protocol ? 'https://' : 'http://') + window.__ht_wc.host + '/web_chatting/tracking.js';
    var s = document.getElementsByTagName('script')[0];
    s.parentNode.insertBefore(ht, s);
  })();
</script>

카페24, 고도몰 등 호스팅몰을 이용 중인 고객사의 경우 채팅 버튼 소스 내에 위와 같이 partner_id와 shop_id가 있는데요. 위 영역은 고정으로 수정 또는 삭제하면 정상적으로 채팅 버튼이 설치되지 않습니다.

커스텀 파라미터는 20자까지 사용할 수 있습니다. 20자가 넘는 경우에는, 그 이후 값은 잘려서 노출됩니다. 웹채팅을 사용하고, 20자가 넘는 값이 필요한 경우 고정 파라미터 중 사용자변수(user_parameter)를 사용해 주세요. user_parameter는 200자까지 사용 가능합니다.