챗봇 위젯 스타일 지정
약 5분이면 완료할 수 있습니다. 플로팅 바에서 라이브 위젯을 업데이트하고 변경 사항을 저장할 수 있습니다.
이 가이드에서는 챗봇 위젯의 이미지, 색상, 텍스트 및 자동 열기 동작을 변경하는 방법을 안내합니다.
이동 경로: Communication Hub → Chatbot → Widget Style
빠른 참조
| 작업 | 클릭 위치 | 결과 |
|---|---|---|
| 위젯 미리보기 | Getting Started / Conversation | 각 레이아웃에서 게스트에게 어떻게 보이는지 확인 |
| 런처 아이콘 편집 | Images & Branding | 게스트가 클릭하는 플로팅 버튼 변경 |
| 봇 아바타 편집 | Images & Branding | 채팅 안에 표시되는 이미지 변경 |
| 자동 열기 동작 조정 | Launcher (Chat Button) | 데스크톱과 모바일에서 위젯이 열리는 시점 제어 |
| 헤더 및 메시지 색상 편집 | Header, Bubbles, Input | 브랜드 스타일에 맞게 조정 |
| 환영 텍스트 및 정책 링크 편집 | Welcome Screen | 게스트가 처음 보는 화면 제어 |
| 변경 사항 저장 또는 취소 | 페이지 하단의 플로팅 바 | 현재 편집 내용 적용 또는 되돌리기 |
요금제 이용 권한
- 위젯 스타일을 지정하려면 유료 플랜이 필요합니다.
- Widget Style에는
chatbot_setup:manage권한이 필요합니다. - 이 권한이 없으면 AVA가 페이지를 숨기고 직접 링크를 차단합니다.
- 무료 요금제 계정에는 업그레이드 안내가 표시되며 스타일을 저장할 수 없습니다.
업그레이드하려면 Settings → Billing & Subscription으로 이동하세요.
위젯 스타일 업데이트
-
미리보기 모드 버튼을 사용합니다.
- Getting Started
- Conversation
✓ 선택한 모드에 맞게 미리보기가 업데이트됩니다.
-
Images & Branding을 열어 시각적 요소를 업데이트합니다.
-
플로팅 버튼 이미지에는 Launcher Icon을 사용합니다.
-
채팅 안에 표시되는 이미지에는 Bot Avatar를 사용합니다.
✓ 이 이미지들은 위젯의 서로 다른 부분에 사용됩니다.
-
**Launcher (Chat Button)**을 열어 자동 열기 동작을 조정합니다.
-
Desktop과 Mobile에 사용할 설정을 선택합니다.
-
Enable with delay를 선택했다면 지연 시간을 초 단위로 선택합니다.
✓ 위젯은 기기 유형별로 선택한 열기 동작을 사용합니다.
-
Header, Bubbles, Input 및 Welcome Screen을 열어 텍스트와 색상을 업데이트합니다.
-
Welcome Screen에서 Terms & policies 섹션을 엽니다.
-
필요에 따라 Privacy Policy 또는 Terms Of Service를 켭니다.
-
URL을 입력하거나
.pdf또는.md파일을 업로드합니다.
✓ 업로드한 파일이 정책 URL을 자동으로 입력합니다.
- 플로팅 바에서 Save chatbot style settings를 클릭합니다.
✓ 변경하면 버튼이 표시됩니다.
접근 권한 확인
Widget Style을 보거나 편집하려면 chatbot_setup:manage가 필요합니다.
페이지 또는 링크가 보이지 않으면 관리자에게 역할을 업데이트해 달라고 요청하세요.
접근 권한 문제 해결
확인되는 현상: Widget Style이 없거나 직접 링크가 열리지 않습니다.
해결 방법:
-
관리자에게 Superadmin → Permissions → Roles를 열어 달라고 요청합니다.
-
역할에
chatbot_setup:manage가 포함되어 있는지 확인합니다. -
역할이 변경된 후 로그아웃했다가 다시 로그인합니다.
-
Communication Hub → Chatbot → Widget Style을 엽니다.
✓ 역할에 접근 권한이 있으면 페이지와 사이드바 링크가 표시됩니다.
이미지 이해하기
각 위치에 맞는 이미지를 사용하세요.
| 이미지 | 표시 위치 | 영향을 받는 항목 |
|---|---|---|
| Launcher Icon | 채팅 외부의 플로팅 버튼 | 게스트가 채팅을 열 때 클릭하는 버튼 |
| Bot Avatar | 헤더, 봇 메시지 및 환영 화면 | 게스트가 대화 안에서 보는 얼굴 |
이전 위젯 스타일을 저장했다면 첫 번째 저장 시 해당 이미지가 자동으로 Bot Avatar로 이동합니다.
정책 관리
-
Welcome Screen을 엽니다.
-
Terms & policies 섹션을 엽니다.
-
Vouch Policy를 활성화된 상태로 둡니다.
-
필요할 때 Privacy Policy 또는 Terms Of Service를 켭니다.
-
레이블과 URL을 추가하거나
.pdf또는.md파일을 업로드합니다. -
Save chatbot style settings를 클릭합니다.
✓ 미리보기에 환영 화면에서 활성화된 링크가 표시됩니다.
변경 사항 유지 또는 되돌리기
페이지 하단에 플로팅 작업 표시줄이 있습니다.
- 편집 내용을 유지하려면 Save chatbot style settings를 클릭합니다.
- 마지막으로 저장한 버전으로 돌아가려면 Discard changes를 클릭합니다.
필드를 변경한 후에만 플로팅 바가 표시됩니다.
팁
- 가독성을 위해 텍스트 대비를 높게 유지하세요.
- 저장하기 전에 두 미리보기 모드를 모두 확인하세요.
- 링크가 모바일 화면에 맞도록 정책 이름을 짧게 유지하세요.
- 웹사이트 및 게스트 이메일과 일관된 색상을 사용하세요.
- 이 페이지에서는 첨부 파일 버튼 스타일을 편집할 수 없습니다.
문제 해결
미리보기가 업데이트되지 않음
확인되는 현상: 편집 후에도 미리보기가 그대로입니다.
해결 방법:
- Getting Started와 Conversation 사이를 전환합니다.
- 페이지를 새로고침합니다.
- 변경을 다시 시도합니다.
저장이 실패하거나 되돌아감
확인되는 현상: 저장 후에도 스타일이 유지되지 않습니다.
해결 방법:
- Save chatbot style settings를 다시 클릭합니다.
- 성공 메시지가 표시될 때까지 기다립니다.
- 플랜에서 위젯 스타일 지정을 허용하는지 확인합니다.
잘못된 이미지가 표시됨
확인되는 현상: 플로팅 버튼은 바뀌지만 채팅 아바타는 바뀌지 않습니다.
해결 방법:
- Images & Branding을 엽니다.
- 플로팅 버튼에는 Launcher Icon을 편집합니다.
- 채팅 안의 이미지에는 Bot Avatar를 편집합니다.
- 변경 사항을 저장합니다.
업로드가 사용 중 상태를 반환함
확인되는 현상: 이미지 또는 정책 업로드가 사용 중이라는 메시지와 함께 실패합니다.
해결 방법:
- 10초간 기다립니다.
- 업로드를 다시 시도합니다.
- 여러 직원이 동시에 업로드 중이라면 업로드 시간을 나누어 진행합니다.
- 계속 발생하면 지원팀에 문의하세요.
정책 업로드 실패
확인되는 현상: 업로드 시 정책 필드 아래에 오류가 표시됩니다.
해결 방법:
.pdf또는.md파일만 사용합니다.- 업로드할 수 있을 정도로 파일 크기를 작게 유지합니다.
- 업로드가 사용 중이라고 표시되면 10초간 기다린 후 다시 시도합니다.
- 업로드를 다시 시도한 다음 Save chatbot style settings를 클릭합니다.
정책 링크가 표시되지 않음
확인되는 현상: 미리보기에 Privacy Policy 또는 Terms Of Service가 없습니다.
해결 방법:
- Welcome Screen을 엽니다.
- 정책 토글을 켭니다.
- 유효한 URL을 추가합니다.
- 설정을 다시 저장합니다.
취소해도 페이지가 복원되지 않음
확인되는 현상: Discard changes를 클릭한 후에도 저장하지 않은 편집 내용이 페이지에 표시됩니다.
해결 방법:
- 컨트롤이 새로고침될 때까지 기다립니다.
- Discard changes를 다시 시도합니다.
- 필요하면 페이지를 새로고침합니다.
여전히 해결되지 않나요?
다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 여러 번 시도해도 스타일이 저장되지 않음
- ❌ 저장 후에도 미리보기가 새로고침되지 않음
- ❌ 문제가 30분 넘게 지속됨
함께 보내면 좋은 정보:
- Widget Style 페이지의 스크린샷
- 시도한 스타일 변경 내용
- 문제가 시작된 시간