파라미터 관리란?
상담 시 필요한 고객 유입 정보(이름, 전화번호, 이메일 등)를 채팅 URL의 변수(파라미터)로 매칭하여, 고객 인입 시 고객정보에 자동으로 반영되도록 설정하는 메뉴예요. 개발자 지원이 필요해요.
Pro 플랜 이상에서만 사용할 수 있어요.
1. 이 메뉴에서 할 수 있는 일
•
고정 파라미터 활용: 해피톡에서 제공하는 기본 변수(site_uid, cus_extra_username, cus_extra_phone, cus_extra_email, user_parameter 등)를 사용하여 고객 기본 정보에 자동 매칭할 수 있어요.
•
커스텀 파라미터 설정: 고정 파라미터 외에 추가로 필요한 정보(유입 경로, 유저 구분 등)를 최대 10개까지 설정하여 활용할 수 있어요.
•
상담 분류 자동 지정: 상담분류번호 파라미터(category_id, division_id)를 활용하여 인입 시 자동으로 상담 분류를 지정할 수 있어요.
•
고객 ID 기반 상담이력 연동: site_uid 파라미터를 활용하면 채널이 달라도 동일 고객의 상담이력과 고객정보를 하나로 연동할 수 있어요.
활용 Tip
고정 파라미터는 채팅 URL 뒤에 직접 추가해야 하고, 커스텀 파라미터는 설정 후 채팅 URL에 자동 반영돼요.
여러 파라미터를 사용할 때 채널별 구분자가 달라요: 카카오톡 &, 웹채팅v2 ,(콤마), 네이버톡톡 |(파이프).
커스텀 파라미터는 20자까지만 사용할 수 있어요. 더 긴 값이 필요하면 user_parameter(200자)를 활용하세요.
2. 언제 사용하나요?
상황 | 설명 | 비고 |
고객 기본 정보 자동 수집 | 고객 인입 시 이름, 전화번호, 이메일 등을 자동으로 고객정보에 반영하고 싶을 때 | 고정 파라미터 사용 |
고객 유입 경로 추적 | 고객이 어디에서 유입되었는지(광고, 특정 페이지 등) 추적하고 싶을 때 | 커스텀 파라미터 사용 |
채널 간 상담이력 통합 | 웹채팅, 카카오톡, 네이버톡톡 등 다양한 채널에서 동일 고객의 상담이력을 하나로 관리하고 싶을 때 | site_uid 활용 |
상담 분류 자동 지정 | 고객 인입 시 상담 분류를 자동으로 배정하여 상담 배분에 활용하고 싶을 때 | category_id / division_id |
커스텀 상담정보 연동 | 상담정보 관리의 URL에 파라미터 값을 전달하고 싶을 때 | 변수값을 []로 묶어 사용 |
3. 어떻게 사용하나요?
3.1 고정 파라미터 사용
•
설정 위치: 채팅 URL 뒤에 직접 추가해요.
•
반영 시점: 고객 인입 즉시
•
주의사항: 고정 파라미터로 인입된 정보는 가장 최근 값으로 업데이트돼요.
•
주요 고정 파라미터 목록:
값 구분 | 변수 | 이름 | 데이터 타입 | 데이터 길이 | 데이터 샘플 | 설명 |
고객 | site_uid | 회원 고유 식별번호 | String | 255 | loginid | 회원을 식별하는 값(로그인 ID, 회원 고유번호 등) |
고객 | cus_extra_username | 고객 이름 | String | 100 | 홍길동 | 고객 이름 |
고객 | cus_extra_tel_phone | 고객 전화번호 | String | 100 | 0212345678 | 고객 일반 전화번호 |
고객 | cus_extra_phone | 고객 휴대폰번호 | String | 100 | 01012345678 | 고객 휴대폰번호 |
고객 | cus_extra_email | 고객 이메일 | String | 100 | 고객 이메일 | |
대화방 | user_parameter | 사용자변수 | String | 200 | abcdabcd | 커스텀 작업 시 활용 (200자) |
대화방 | category_id | 상담분류번호(대분류) | Int | 11 | 1 | 상담 분류 관리의 대분류 id |
대화방 | division_id | 상담분류번호(중분류) | Int | 11 | 2 | 상담 분류 관리의 중분류 id |
대화방 | title | 상담제목 | String | - | 문의드립니다 | 대화방 상담 제목 |
대화방 | bot_start | 아이봇 빌더 시작여부 | Boolean | - | true | 카카오i 오픈빌더 챗봇 시작 시 사용 |
위 목록은 자주 사용되는 주요 고정 파라미터예요. 전체 목록은 파라미터 관리 화면의 '고정 파라미터 정보' 영역에서 확인할 수 있어요.
3.2 site_uid를 활용한 상담이력 연동
site_uid를 활용하여 ID 정보가 인입되는 경우, ID가 없을 때 임의의 값으로 설정하면(예: site_uid=undefined) 해당 사용자들의 모든 고객정보와 상담이력이 하나로 연동되는 점 주의해 주세요.
•
설정 위치: 채팅 URL의 site_uid 파라미터
•
설정 값: 고객 고유 ID 값
•
반영 시점: 고객 인입 즉시
•
주의사항: ID가 확인되지 않는 사용자는 반드시 빈 값으로 설정해야 해요.
1) 채널별 상담방 인식 차이
•
웹채팅: 동일한 site_uid로 인입되면 모두 같은 상담방으로 인식돼요.
•
카카오톡 채널/네이버톡톡: 각 채널의 계정으로 구분되므로, site_uid가 같아도 서로 다른 상담방으로 인식돼요.
•
채널 구분 없이 고객 ID 기준으로 고객정보와 상담이력은 모두 연동돼요.
3.3 고객정보 전화/휴대폰 구분
파라미터 값에 한글을 입력할 경우 인코딩하여 사용해 주세요. 한글을 직접 입력하면 인터넷 익스플로러(IE)에서 값이 깨질 수 있어요.
•
전화: 파라미터(cus_extra_tel_phone), 프로필봇, 상담사 직접 입력으로 등록되며 수정 가능해요.
•
휴대폰: 파라미터(cus_extra_phone), SMS, 카카오싱크 등 인증을 통해 확인된 번호로 임의 수정이 불가해요.
3.4 상담 분류 파라미터 활용
값 구분 | 변수 | 이름 | 데이터 타입 | 데이터 길이 | 설명 |
대화방 | category_id | 상담분류번호(대분류) | Int | 11 | 상담 분류 관리의 대분류 id |
대화방 | category_name | 상담분류명(대분류) | String | 100 | 상담 분류 관리의 대분류 이름 |
대화방 | division_id | 상담분류번호(중분류) | Int | 11 | 상담 분류 관리의 중분류 id |
대화방 | division_name | 상담분류명(중분류) | String | 100 | 상담 분류 관리의 중분류 이름 |
3.5 커스텀 파라미터 설정
•
설정 값: 사용 토글을 ON으로 변경 후 파라미터 설명 입력
•
반영 시점: 저장 후 즉시 (채팅 URL에 자동 반영)
커스텀 파라미터는 20자까지 사용할 수 있어요. 20자가 넘는 값이 필요한 경우 고정 파라미터 중 사용자변수(user_parameter, 200자)를 사용해 주세요.
3.6 웹채팅v2 버튼 소스 내 파라미터 설정
카페24, 고도몰 등 호스팅몰을 이용 중인 경우 채팅 버튼 소스 내 partner_id와 shop_id 영역은 고정값이므로 수정 또는 삭제하면 안 돼요.
•
•
설정 값: // 부분을 삭제하고 파라미터를 ,(콤마)로 구분하여 입력
// 고정 및 Custom 파라미터 추가 영역, 파라미터가 여러개인 경우 ,(콤마)로 구분
window.__ht_wc.params = 'site_uid=abcd1234,parameter1=param1';
Plain Text
복사
3.7 카카오i 오픈빌더 시작 파라미터
•
설정 위치: 카카오톡 채팅 URL 뒤에 &bot_start=true 추가
•
설정 값: true
•
반영 시점: 즉시
•
주의사항: 카카오i 오픈빌더 챗봇을 사용하는 경우에만 적용돼요.
3.8 커스텀 파라미터 확인
•
커스텀 파라미터로 인입된 정보는 채팅 > 고객정보 > 추가 정보와 상담관리에서 확인할 수 있어요.
•
커스텀 파라미터는 해당 상담방의 인입 정보로, 인입 시마다 들어온 값이 있어야 확인할 수 있어요.
•
상담관리 > Reporting > 상담 내역에서도 파라미터 정보를 확인하고 엑셀로 다운로드할 수 있어요.
4. 알아두면 좋은 점
•
파라미터 값에 한글을 사용할 경우 반드시 URL 인코딩하여 사용해야 해요.
•
고정 파라미터는 채팅 URL에 수동으로 추가해야 하지만, 커스텀 파라미터는 설정 후 채팅 URL에 자동 반영돼요.
•
site_uid로 인입된 고객은 고객식별번호가 "사이트아이디_고객ID"로 변경돼요.
•
•
파라미터로 인입된 정보는 가장 최근 값으로 업데이트되므로, 다른 변수로 재인입 시 최신 정보로 변경돼요.
•
Pro 플랜 이상에서 사용 가능해요.