사용 가이드
위젯 표시 위치 설정하기
채팅 위젯과 도움말 센터가 방해되는 페이지에서는 숨기고, 로그인한 고객에게, 캠페인 기간에, 또는 누군가 한동안 글을 읽은 뒤처럼 도움이 될 때 정확히 보여 주세요.
찾는 위치
채널을 열고 웹사이트 채널을 선택한 뒤 실시간 채팅 탭에서 위젯 표시 위치까지 스크롤하세요. 소유자와 관리자가 바꿀 수 있어요. 다 되면 변경 사항 저장을 선택하세요. 방문자는 다음에 페이지를 불러올 때 새 규칙을 적용받아요.
허용 목록과 차단 목록
페이지에서 세 가지 모드 중 하나를 고르세요.
- 모든 페이지에 표시: 기본값이에요. 페이지 목록을 쓰지 않아요.
- 이 페이지에만 표시: 허용 목록이에요. 패턴과 일치하는 곳에만 위젯이 나타나요.
- 이 페이지에서 숨기기: 차단 목록이에요. 패턴과 일치하는 곳을 빼고 어디에나 위젯이 나타나요.
페이지마다 패턴을 하나씩 추가하세요. /로 시작하면 모든 도메인의 경로와 일치하고, 도메인을 포함하면 특정 사이트만 대상으로 해요. *는 무엇이든 일치해요. 패턴에 ?가 없으면 대소문자와 쿼리 문자열은 무시돼요.
| 패턴 | 일치하는 페이지 |
|---|---|
/pricing | 정확히 /pricing(끝의 슬래시는 무시돼요) |
/blog/* | /blog/ 아래의 모든 페이지(/blog 자체는 제외) |
/blog* | /blog와 그 아래의 모든 페이지 |
*checkout* | checkout이 포함된 모든 경로 |
shop.example.com/* | 그 도메인의 모든 페이지(www.는 무시돼요) |
/pricing?plan=* | plan 파라미터가 있을 때의 /pricing만 |
조건에 따라 위젯 표시하기
다음 경우에만 표시에 조건을 최대 20개까지 추가하세요. 둘 이상이면 모든 조건 일치와 하나 이상의 조건 일치 중에서 고르세요. 위젯은 허용된 페이지이면서 조건이 일치할 때만 나타나요. 날짜와 시간은 워크스페이스 설정의 워크스페이스 시간대를 사용해요.
| 조건 | 확인하는 내용 | 예시 |
|---|---|---|
| 페이지 URL | 현재 페이지의 전체 주소예요. 패턴과 일치는 페이지 목록과 같은 와일드카드를 써요. | /pricing 포함 |
| URL 파라미터 | 캠페인이나 쿠폰 같은 쿼리 파라미터 하나예요. 파라미터가 있는지만 확인하려면 설정됨을 쓰세요. | utm_campaign 같음 summer-sale |
| 유입 경로(리퍼러) | 방문자가 들어오기 직전 페이지예요. | google. 포함 |
| 방문자 이메일 | 사이트가 identify로 보낸 이메일이나 방문자가 입력한 이메일이에요. “로그인한 방문자만”이라면 설정됨을 쓰세요. | @acme.com으로 끝남 |
| 방문자 속성 | 사이트가 identify나 setAttributes로 보내는 모든 속성이에요. 사용자 ID, 그룹, 플랜, 사용자 지정 필드 등이 해당돼요. 텍스트, 숫자, 참/거짓을 정확히 비교해요. | group이 vip, beta 중 하나 |
| 날짜 | 오늘 날짜가 시작일부터 및/또는 종료일까지인지 확인해요(양쪽 날짜 포함). | 2026-11-24부터 2026-11-30까지 |
| 요일 및 시간 | 요일과 시간 범위예요. 종료 시간이 시작 시간보다 앞서면 자정을 넘겨 이어져요. | 월–금, 09:00부터 17:00까지 |
| 기기 | 휴대폰, 또는 태블릿과 컴퓨터예요. | 휴대폰 |
| 브라우저 언어 | 방문자의 브라우저 언어예요. de는 de-CH와 de-AT도 포함해요. | de와 같음 |
| 페이지 체류 시간 | 방문자가 현재 페이지를 연 뒤 지난 초 수예요. 시간이 되면 바로 위젯이 나타나요. | 최소 15초 |
규칙은 싱글 페이지 앱에서 방문자가 다른 페이지로 이동할 때, 사이트가 새 속성을 보낼 때, 그리고 날짜나 일정 조건이 있으면 1분마다 다시 확인돼요. 규칙 때문에 위젯이 숨겨질 때 채팅이 열려 있다면 닫혀요. 대화는 위젯이 다시 나타날 때를 위해 보관돼요.
규칙이 확인할 값 보내기
방문자 이메일과 속성 조건은 사이트가 위젯에 넘긴 값을 읽어요. 인증된 신원(userJwt)을 쓰는 로그인한 방문자의 경우, 이메일 조건이 필요하다면 email도 함께 넘기세요.
<script>
// Send the values your display rules check
sonny('identify', {
email: 'anna@acme.com',
attributes: { userId: 'u_123', group: 'vip', seats: 12 }
});
// Later, when something changes
sonny('setAttributes', { group: 'beta' });
</script>코드로 규칙 덮어쓰기
직접 작성한 코드가 항상 우선해요. sonny('show')와 sonny('hide')는 페이지를 다시 불러올 때까지 규칙을 무시해요.
<script>
sonny('hide'); // hide the widget, whatever the rules say
sonny('show'); // show it again, whatever the rules say
sonny('open'); // opens the chat, and shows the widget if rules hid it
</script>알아 두면 좋아요
- 표시 규칙은 위젯을 숨길 뿐 접근을 제한하지는 않아요. 누구나 여전히 위젯을 불러올 수 있어요.
- 규칙은 도움말 탭을 포함한 위젯 전체에 적용돼요. 공개 도움말 센터 사이트에는 영향이 없어요.
- iOS 및 Android SDK는 표시 규칙을 무시해요. 채팅을 열 시점은 앱이 정해요.
- 실시간 방문자에는 위젯이 숨겨진 페이지에 있는 사람도 계속 표시돼요.