가이드
위젯 맞춤 설정
채팅 위젯을 브랜드에 맞추세요. 코드를 바꿀 필요 없이 대시보드에서 색상, 로고, 메시지, 동작을 설정할 수 있어요.
맞춤 설정 방법
- 01
채널 열기
사이드바에서 "채널"을 클릭하세요. 채널 설정을 바꾸려면 소유자나 관리자여야 해요.
- 02
웹사이트 채널 선택
웹사이트 채널을 클릭한 뒤 "실시간 채팅" 탭을 여세요. 모든 위젯 맞춤 설정 옵션이 여기에 있어요.
- 03
설정 업데이트
브랜딩, 메시지, 동작 설정을 바꾸고 미리보기를 확인한 뒤 변경 사항 저장을 선택하세요.
- 04
변경 사항이 바로 적용돼요
위젯은 페이지를 불러올 때마다 구성을 가져오므로, 방문자가 다음에 웹사이트를 열 때 변경 사항이 반영돼요.
브랜딩
사이트에서 위젯이 어떻게 보일지 정하는 시각 설정이에요. 런처는 두 가지 스타일 중 하나를 쓸 수 있어요.
- 로고
- 아이콘
| 설정 | 설명 | 기본값 |
|---|---|---|
| 런처 스타일 | 직접 올린 이미지를 쓰려면 로고를, Sonny 기본 런처 아이콘 중 하나를 쓰려면 아이콘을 고르세요. | 아이콘 |
| 위젯 로고 | 런처 스타일이 로고일 때 표시돼요. 2MB 미만, 64x64px 이상의 JPEG, PNG, GIF, WebP 이미지를 업로드하세요. | 사용자 지정 로고 없음 |
| 아이콘 선택 | 런처 스타일이 아이콘일 때 표시돼요. 런처에 쓸 기본 아이콘을 고르세요. | 원형 말풍선 |
| 아이콘 색상 | 색상 선택기나 6자리 hex 값으로 선택한 런처 아이콘의 색을 정하세요. | #ffffff |
| 브랜드 색상 | 런처 버튼, 채팅 헤더, 보내기 버튼, 보낸 메시지 말풍선에 적용돼요. | #2563eb |
| 위젯 위치 | 위젯이 페이지의 오른쪽 아래와 왼쪽 아래 중 어디에 나타날지 고르세요. | 오른쪽 아래 |
메시지
방문자가 위젯을 쓸 때 보게 될 문구를 맞춤 설정하세요.
- 인사 메시지
- 방문자가 위젯을 열면 채팅 창 맨 위에 표시되는 문구예요. 대화의 분위기를 정하는 데 쓰세요.
- 기본값: "안녕하세요! 무엇을 도와드릴까요?" · 최대 500자
- 온라인 메시지
- 상담원이 한 명 이상 온라인일 때 채팅 헤더에 표시되는 상태 문구예요. 초록색 점과 함께 나타나요.
- 기본값: "보통 몇 분 안에 답변해요" · 최대 500자
- 오프라인 메시지
- 온라인인 상담원이 없을 때 채팅 헤더에 표시되는 상태 문구예요. 회색 점과 함께 나타나요.
- 기본값: "지금은 자리에 없어요. 메시지를 남겨 주시면 답변해 드릴게요" · 최대 500자
동작
방문자에게 위젯이 어떻게 동작할지 정하는 설정이에요.
- 이메일 요청 시점
- 방문자에게 이름과 이메일을 언제 물어볼지 정하세요. 연락처 정보를 먼저 받으려면 "첫 메시지 전"을, 방문자가 바로 채팅을 시작하고 나중에 정보를 받으려면 "첫 메시지 후"(기본값)를 고르세요.
- 채팅 전 설문
- 채팅을 시작하기 전에 방문자 정보를 물어보세요. 켠 다음 필수 필드에서 이름, 이메일 또는 둘 다를 고르세요. 최소 하나는 선택돼 있어야 해요.
- 운영 시간
- 요일별 운영 시간을 설정하세요. 위젯은 그 시간에 응대 가능한 상담원이 있을 때만 온라인으로 표시돼요. 운영 시간 밖에는 방문자에게 오프라인 메시지가 보이고, AI 자동 응답기를 쓴다면 대신 응대할 수 있어요.
- 위젯 표시 위치
- 선택한 페이지에만 위젯을 표시하거나, 다른 페이지에서 숨기거나, 방문자 그룹, URL 파라미터, 날짜 범위, 페이지 체류 시간 같은 조건이 맞을 때만 표시하세요. 표시 규칙 설정하기.
- 허용된 개발 도메인
- 위젯은 기본적으로 등록된 운영 도메인에서만 로드돼요. 개발 중 위젯을 테스트하려면 추가 도메인(예:
localhost:3000,staging.example.com)을 추가하세요.localhost는 항상 자동으로 허용돼요. - “Powered by Sonny” 숨기기
- 위젯에서 Sonny 브랜딩을 제거해요. 모든 AI 플랜이나 BYOK 활성화에 포함돼요.
- 방문자에게 전송 확인 표시
- Sonny가 방문자의 메시지를 받으면 메시지 아래에 체크 표시를 보여 줘요. 체크 표시가 상담원이 메시지를 읽었다는 뜻은 아니에요.
필수 정보와 인증
채팅 전 정보와 방문자 인증은 서로 다른 문제를 해결해요. 이메일을 필수로 하면 모든 새 대화에 이메일 신원이 있어야 해요. 유효한 서명된 신원이 있으면 충족되고, 브라우저 이메일 식별이 허용된 경우 방문자가 입력한 이메일도 충족돼요. 저장된 이름이나 완료된 설문은 이메일 신원이 아니므로, Sonny는 식별되지 않은 대화를 여는 대신 다시 물어봐요.
인증이 꺼져 있거나 선택 사항이면, 방문자가 입력한 이메일로 인증되지 않은 연락처가 만들어지고 기기 간 기록은 열리지 않아요. 신원 확인에 증명 필요를 쓰면 브라우저에서 입력한 이메일은 신원으로 인정되지 않으므로, 이메일이 필수 채팅 전 필드일 때는 서명된 JWT가 필요해요.
위젯 설치와 관리
설치 스니펫으로 웹사이트용 코드를 복사하세요. 실시간 미리보기에서 저장된 시각 설정이 어떻게 보일지 확인할 수 있어요. 더 이상 채널이 필요 없다면 웹사이트 연결 해제를 선택하고 확인하세요.
위젯 설정 가이드관련 문서
- 위젯 설정
스크립트 태그 하나로 웹사이트에 Sonny 실시간 채팅 위젯을 설치하세요.
- 방문자 식별
로그인한 사용자를 식별하고 웹사이트에서 사용자 지정 속성을 보내세요.
- 채널
고객이 실시간 채팅과 이메일로 연락하는 곳을 만들고 관리하세요.
- 실시간 방문자
지금 웹사이트를 둘러보는 사람을 확인하고 알맞은 순간에 대화를 시작하세요.