위젯 설치(웹 사이트 연동)

먼저 위젯을 사이트에 띄우는 것부터 시작해보겠습니다. 다음 4단계로 진행합니다.

연동 설정 페이지 들어가기

워크스페이스 좌측 상단 설정 아이콘 > 채팅 설정 > 연동 / 개발 > 연동 설정

워크스페이스 좌측 상단의 설정(톱니바퀴) 아이콘을 클릭해 채팅 설정으로 이동합니다.

이어서 채팅 설정 사이드바에서 연동 / 개발 > 연동 설정 항목을 클릭해 연동 설정 페이지로 이동합니다.

채팅 설정 사이드바 — 기본 설정·상담 설정·AI / 자동화·연동 / 개발·기타 묶음이 차례로 있고, '연동 / 개발' 묶음과 그 첫 항목인 '연동 설정' 이 빨간 박스로 강조되어 있다

웹사이트 연동 추가하기

우측 상단 + 연동 추가 버튼을 누르면 서비스 연동 모달이 열립니다. 모달에서 웹사이트 항목의 연동하기 버튼을 누릅니다.

서비스 연동 모달 위쪽 — 웹사이트·카카오톡·네이버 톡톡·라인·이메일·게시판 문의가 차례로 있고, 아직 붙이지 않은 네이버 톡톡·라인에는 연동하기 버튼이, 이미 붙인 웹사이트·카카오톡·게시판 문의에는 연동됨 표시와 추가연동 버튼이, 이메일에는 연동됨 표시와 비활성 이미 연결됨 버튼이 있다 — 모달 위쪽만 잘라낸 화면이고 아래로 더 스크롤됩니다. 이미 붙인 채널은 연동하기 대신 추가연동이 나오는데, 이메일만 워크스페이스당 하나라서 추가연동 대신 비활성 '이미 연결됨' 이 됩니다.

이미 등록된 웹사이트가 있어도 추가연동 버튼을 눌러 또 하나의 웹사이트 연동을 등록할 수 있습니다(예: 프로덕션·스테이징용 위젯을 분리해 운영).

웹사이트 외에도 카카오톡 · 네이버 톡톡 · 라인 · 이메일 · WhatsApp 채널을 같은 방식으로 추가해 모든 문의를 한곳에서 함께 응대할 수 있습니다.

Plugin Key 생성하기

추가된 웹사이트 카드를 클릭하면 상세 화면으로 이동합니다. 상세 화면은 위쪽이 위젯 설정 카드와 미리보기이고, 그 아래에 설치 코드 와 Plugin Key 관리 카드가 차례로 놓여 있습니다. 아래로 스크롤해 Plugin Key 관리 카드의 + 키 생성 버튼을 눌러 위젯에 사용할 Plugin Key를 발급합니다.

+ 키 생성 버튼을 누르면 다음 두 가지 항목을 입력하는 모달이 열립니다. 둘 다 선택 사항이며, 비워두고 바로 생성 을 눌러도 됩니다.

이름 (선택) — 키를 구분할 라벨 (최대 20자, 예: 프로덕션 웹사이트)
허용 도메인 (선택) — 이 키로 위젯을 띄울 수 있는 도메인. Enter 또는 , 로 하나씩 추가하며, 비워두면 모든 도메인에서 사용할 수 있습니다

키 생성 모달 — 이름(선택) 입력란과 0/20 글자수, 허용 도메인(선택) 입력란과 추가 버튼, 아래에 취소·생성 버튼이 있다

생성된 키는 Plugin Key 관리 표에 pk_live_****1a2b 처럼 가려진 형태로 나타나며, 한 웹사이트 연동에 여러 개의 키를 만들어 환경(개발/스테이징/프로덕션)별로 분리해 운영할 수 있습니다. 표에서는 이름·키·도메인·상태·생성일을 확인하고, 행 오른쪽 ⋮ 메뉴로 키를 수정하거나 폐기할 수 있습니다.

Plugin Key 관리 카드 — 우측 상단 + 키 생성 버튼, 그 아래 이름·키·도메인·상태·생성일 열을 가진 표. 키는 pk_live_****0f07 처럼 뒤 네 자리만 보이고 상태는 활성 또는 폐기됨으로 표시되며 행 오른쪽에 ⋮ 메뉴가 있다 — 폐기된 키는 회색 처리되고 상태가 폐기됨으로 바뀝니다.

키를 만든 직후 화면에서 Plugin Key 와 Secret Key 를 복사해 두세요

키 값 전체가 보이는 화면은 생성 직후 한 번뿐입니다. 이 창을 닫으면 Plugin Key 는 표에서 pk_live_****1a2b 처럼 뒤 네 자리만 남고, Secret Key 는 다시 볼 수 없습니다.

Plugin Key — 아래 4단계의 설치 코드에 넣을 값입니다. 반드시 여기서 복사해 두세요.
Secret Key — 로그인 사용자를 식별하는 회원 인증 에 쓰입니다. 자사 백엔드의 환경 변수에 안전하게 보관하세요. 회원 인증을 쓰지 않는다면 무시해도 됩니다.

다시 발급하는 기능은 없습니다. 값을 잃어버렸다면 그 키를 폐기하고 새 키를 만들어야 하며, Secret Key 를 새로 만들면 기존 memberHash 는 모두 무효가 됩니다.

설치 코드 사이트에 붙여넣기

설치 코드 카드의 스크립트를 복사한 뒤, 위젯을 띄울 웹사이트의 </body> 태그 바로 위에 붙여넣습니다. 스크립트에는 워크스페이스가 쓰는 CDN 주소와 API 주소가 이미 채워져 있으며, 우측 상단 복사 버튼으로 한 번에 클립보드에 담을 수 있습니다.

설치 코드 카드 — 검은 배경의 스크립트 블록 우측 상단에 복사 버튼이 있고, pluginKey 자리에 {PLUGIN_KEY} 자리표시자가 들어 있다. 블록 아래에 키를 바꾸라는 안내 문구와 설치 가이드 문서 보기 링크가 있다 — 스니펫의 CDN·API 주소는 지금 접속한 대시보드 주소를 따라갑니다. 이 화면은 dev 대시보드에서 찍어 dev 주소가 들어가 있고, talk.zeroworks.ai 로 접속하면 운영 주소가 들어갑니다.

붙여넣기 전에 pluginKey 를 실제 키 값으로 바꾸세요

설치 코드의 pluginKey 자리는 직접 채워야 합니다. 3단계에서 키를 만들 때 복사해 둔 전체 Plugin Key 로 바꿔주세요.

그 자리에 {PLUGIN_KEY} 가 있든 pk_live_****1a2b 같은 값이 있든 마찬가지입니다. 표에 보이는 pk_live_****1a2b 는 뒤 네 자리만 남긴 가려진 값이라, 그대로 붙여넣으면 위젯이 뜨지 않습니다.

HTML·Pure JS·React·Next.js 등 환경별 상세 설치 방법은 위젯 설치 가이드 를 참고하세요.

도움말

스크립트를 붙여넣고 사이트를 새로고침했을 때 우측 하단에 채팅 버블이 나타나면 연동이 정상적으로 완료된 것입니다. 표시되지 않는다면 위젯 설치 가이드의 설치 확인 표로 점검해보세요.