사용 가이드

위젯 표시 위치 설정하기

채팅 위젯과 도움말 센터가 방해되는 페이지에서는 숨기고, 로그인한 고객에게, 캠페인 기간에, 또는 누군가 한동안 글을 읽은 뒤처럼 도움이 될 때 정확히 보여 주세요.

찾는 위치

채널을 열고 웹사이트 채널을 선택한 뒤 실시간 채팅 탭에서 위젯 표시 위치까지 스크롤하세요. 소유자와 관리자가 바꿀 수 있어요. 다 되면 변경 사항 저장을 선택하세요. 방문자는 다음에 페이지를 불러올 때 새 규칙을 적용받아요.

허용 목록과 차단 목록

페이지에서 세 가지 모드 중 하나를 고르세요.

  • 모든 페이지에 표시: 기본값이에요. 페이지 목록을 쓰지 않아요.
  • 이 페이지에만 표시: 허용 목록이에요. 패턴과 일치하는 곳에만 위젯이 나타나요.
  • 이 페이지에서 숨기기: 차단 목록이에요. 패턴과 일치하는 곳을 빼고 어디에나 위젯이 나타나요.

페이지마다 패턴을 하나씩 추가하세요. /로 시작하면 모든 도메인의 경로와 일치하고, 도메인을 포함하면 특정 사이트만 대상으로 해요. *는 무엇이든 일치해요. 패턴에 ?가 없으면 대소문자와 쿼리 문자열은 무시돼요.

패턴일치하는 페이지
/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도 함께 넘기세요.

HTML
<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')는 페이지를 다시 불러올 때까지 규칙을 무시해요.

HTML
<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는 표시 규칙을 무시해요. 채팅을 열 시점은 앱이 정해요.
  • 실시간 방문자에는 위젯이 숨겨진 페이지에 있는 사람도 계속 표시돼요.

관련 문서