위젯 설치(웹 사이트 연동)
먼저 위젯을 사이트에 띄우는 것부터 시작해보겠습니다. 다음 4단계로 진행합니다.
- 연동 설정 페이지 들어가기
워크스페이스 좌측 상단 설정 아이콘 > 채팅 설정 > 연동 / 개발 > 연동 설정
워크스페이스 좌측 상단의 설정(톱니바퀴) 아이콘을 클릭해 채팅 설정으로 이동합니다.
이어서 채팅 설정 사이드바에서 연동 / 개발 > 연동 설정 항목을 클릭해 연동 설정 페이지로 이동합니다.
- 웹사이트 연동 추가하기
우측 상단 + 연동 추가 버튼을 누르면 서비스 연동 모달이 열립니다. 모달에서 웹사이트 항목의 연동하기 버튼을 누릅니다.
이미 등록된 웹사이트가 있어도 추가연동 버튼을 눌러 또 하나의 웹사이트 연동을 등록할 수 있습니다(예: 프로덕션·스테이징용 위젯을 분리해 운영).
웹사이트 외에도 카카오톡 · 네이버 톡톡 · 라인 · 이메일 채널을 같은 방식으로 추가해 모든 문의를 한곳에서 함께 응대할 수 있습니다.
- Plugin Key 생성하기
추가된 웹사이트 카드를 클릭하면 상세 화면으로 이동합니다. 상세 화면 상단의 Plugin Key 관리 영역에서 + 키 생성 버튼을 눌러 위젯에 사용할 Plugin Key를 발급합니다.
+ 키 생성 버튼을 누르면 다음 두 가지 항목을 입력하는 모달이 열립니다. 둘 다 선택 사항이며, 비워두고 바로 생성 을 눌러도 됩니다.
- 이름 (선택) — 키를 구분할 라벨 (최대 20자)
- 허용 도메인 (선택) — 이 키로 위젯을 띄울 수 있는 도메인 (비워두면 모든 도메인에서 사용 가능)
생성된 키는 Plugin Key 관리 표에
pk_live_****1a2b형식으로 나타나며, 한 웹사이트 연동에 여러 개의 키를 만들어 환경(개발/스테이징/프로덕션)별로 분리해 운영할 수 있습니다.회원 인증을 쓸 거라면 Secret Key 도 함께 받으세요키 생성 직후 Secret Key 가 표시되는 화면이 한 번만 나옵니다. 로그인 사용자를 식별하는 회원 인증 을 사용할 계획이라면, 이 Secret Key 를 그 자리에서 복사해 자사 백엔드의 환경 변수에 안전하게 보관하세요. 닫고 나면 다시 표시할 수 없으며, 분실하면 Secret 재생성으로 새 키를 발급해 기존
memberHash를 모두 무효화해야 합니다. 회원 인증을 쓰지 않는다면 무시해도 됩니다. - 설치 코드 사이트에 붙여넣기
Plugin Key를 발급하면 설치 코드 섹션이 활성화됩니다. 섹션을 펼쳐 스크립트를 복사한 뒤, 위젯을 띄울 웹사이트의
</body>태그 바로 위에 붙여넣습니다.
스크립트 안의
{PLUGIN_KEY}자리는 발급한 Plugin Key 값으로 자동으로 채워져 표시되며, 우측 상단 복사 버튼으로 한 번에 클립보드에 담을 수 있습니다. HTML·Pure JS·React·Next.js 등 환경별 상세 설치 방법은 위젯 설치 가이드 를 참고하세요.도움말스크립트를 붙여넣고 사이트를 새로고침했을 때 우측 하단에 채팅 버블이 나타나면 연동이 정상적으로 완료된 것입니다. 표시되지 않는다면 위젯 설치 가이드의 설치 확인 표로 점검해보세요.