사이드바 "위젯 설정"(/widget)을 열면 위젯의 동작 설정과 사이트에 붙일 설치 코드가 있습니다. 어떤 기능을 켤지, 어떤 언어로 말할지를 사이트 코드를 고치지 않고 이 화면에서 바꿉니다.
멤버십이 있어야 열립니다. 설정 저장은 편집자 이상, 키 열람은 관리자만 할 수 있습니다.
위젯 키를 발급하고 재발급하는 곳은 이 화면이 아니라 "에이전트 연결"(/casting) 아래 접혀 있는 "위젯 키 직접 관리"입니다.
화면 구성
화면은 위에서부터 두 영역으로 이어집니다.
- 위젯 동작 설정: 기능 플래그와 위젯 언어를 바꾸는 곳
- 임베드 코드: 사이트에 붙일 설치 코드를 복사하는 곳
위젯 동작 설정
카드 오른쪽 위의 "version {version}"은 저장된 설정의 버전입니다. 아직 저장한 적이 없으면 저장할 때 처음 생성된다는 안내가 함께 표시됩니다.
| 항목 | 바꾸는 값 |
|---|---|
| "기능 플래그" | 위젯 기능의 켜짐·꺼짐. 목록이 비어 있으면 "기능 키 추가 (예: faq)"에 키를 넣고 "키 추가" |
| "위젯 언어" | ko · en · ja · zh 중 하나 |
"저장"을 누르면 "저장되었습니다 (version {version}). 위젯에는 다음 호출부터 반영됩니다."가 표시됩니다. 이미 열려 있는 방문자 화면은 새로고침해야 새 설정을 받습니다.
다른 사람이 같은 설정을 먼저 바꾼 경우에는 저장이 막히고 "다른 세션에서 설정이 먼저 변경되었습니다. 최신 설정을 불러온 뒤 다시 저장해주세요."가 표시됩니다. "최신본 불러오기"를 누른 뒤 다시 수정합니다. 두 사람의 변경이 서로를 덮어쓰지 않게 하기 위한 장치입니다.
뷰어 계정에서 저장하면 "설정 변경 권한이 없습니다(편집자 이상)."가 표시됩니다.
임베드 코드
"임베드 코드" 영역에 사이트에 붙일 설치 코드가 있습니다. 첫 번째 활성 위젯 키로 만들어지며, 키 값은 관리자 계정에만 채워져 표시됩니다. 위젯 키가 없으면 "에이전트 연결에서 먼저 연결"하라는 각주가 표시됩니다.
| 탭 | 대상 |
|---|---|
| "스크립트 태그" | HTML을 직접 넣을 수 있는 사이트. </body> 바로 위에 붙여넣기 |
| "React · Next.js" | 패키지 설치, 환경변수에 키 추가, 루트 레이아웃에 컴포넌트 배치 세 블록 |
각 블록의 "복사"로 코드를 가져갑니다. React 탭의 안내대로 키가 클라이언트 번들에 포함되므로 소스가 아니라 환경변수로 관리합니다.
위젯 키 직접 관리
담당자가 바뀌거나 사이트를 하나 더 열 때 위젯 키를 다시 꺼내 보게 됩니다. "에이전트 연결" 화면 아래 "위젯 키 직접 관리"를 펼치면 "위젯 키" 목록이 나옵니다. 부제대로 "도메인 여러 개 운영·키 재발급·삭제"가 여기서 이루어집니다.
| 동작 | 방법 |
|---|---|
| 발급 | "도메인 추가"에서 도메인(예: shop.example.com)과 종류("웹" · "카페24" · "앱")를 고른 뒤 "발급" |
| 키 보기·복사 | 관리자 계정에서만 키가 보이고 "키 복사"가 있습니다. 다른 역할에는 "키는 관리자에게만 표시됩니다"가 표시됩니다 |
| 재발급 | "키 재발급". 새 키는 한 번만 전체가 표시되고 이전 키는 즉시 무효가 됩니다 |
| 삭제 | 휴지통 버튼 후 "삭제 확인". 키가 비활성으로 바뀝니다 |
| 로더 주소 지정 | "JS SDK 로더 URL"에 https 주소를 넣고 "적용". 활성 키 전체에 적용됩니다 |
같은 도메인으로 여러 번 발급할 수 있고 발급할 때마다 고유한 키가 생깁니다. 테스트용과 운영용을 나눌 때 이 방식을 씁니다.
