이 문서가 필요한 경우
- 이슈스티커를 처음 도입해서 관리자 콘솔부터 세팅해야 하는 경우
- Extension과 SDK 중 무엇을 쓰든 공통으로 필요한 준비를 한 번에 끝내고 싶은 경우
끝나면 확인할 것
- 워크스페이스와 첫 프로젝트를 만들었습니다.
- 이슈를 남길 도메인을 프로젝트에 등록했습니다.
- 함께 볼 팀원을 워크스페이스 멤버로 초대했습니다.
- SDK를 쓴다면 프로젝트용 SDK API key를 발급해 안전한 환경 변수에 넣었습니다.
1. 계정과 워크스페이스 만들기
관리자 콘솔에서 가입하면 워크스페이스를 만들 수 있습니다. 워크스페이스는 팀 단위 공간이고, 실제 이슈는 그 아래 프로젝트에 쌓입니다.
2. 프로젝트 만들기
프로젝트는 이슈를 관리할 사이트나 서비스 단위입니다. 처음에는 서비스 이름을 그대로 쓰세요. Admin, Marketing, Customer App처럼 팀에서 부르는 이름이면 충분합니다.
3. 허용 도메인 등록하기
이슈스티커는 프로젝트에 등록된 도메인에서만 동작합니다. 관리자 콘솔의 프로젝트 도메인 관리에서 실제로 이슈를 남길 주소를 등록하세요.
- 운영:
https://app.example.com - 스테이징:
https://staging.example.com - 로컬 확인:
http://localhost:3000
서브도메인이 여러 개라면 와일드카드로 한 번에 등록할 수 있습니다. https://*.example.com처럼 적으면 하위 서브도메인이 모두 허용되고, 플랜의 도메인 사용량은 1개로 계산됩니다.
SDK는 등록되지 않은 도메인에서 초기화 단계부터 막히고, Extension은 연결되지 않은 도메인에서 캡처와 스티커가 켜지지 않습니다.
Extension을 쓴다면 사이드패널에서 현재 보고 있는 도메인을 바로 연결하거나 관리자에게 요청할 수도 있습니다. 실제 흐름은 Chrome Extension 시작하기에서 확인하세요.
4. 팀 초대하기
관리자 콘솔의 워크스페이스 > 멤버 관리에서 멤버 초대를 누릅니다. 초대는 소유자와 관리자만 보낼 수 있습니다.
- 초대할 이메일을 입력해 목록에 추가합니다. 한 번에 최대 50명까지 넣을 수 있습니다.
- 멤버마다 역할을 배정합니다. 관리자는 프로젝트, 멤버, 연동 설정까지 관리하고, 멤버는 배정된 프로젝트의 이슈를 다룹니다.
- 초대를 보내면 결과가 멤버마다 표시됩니다. 이미 멤버이거나 형식이 잘못된 주소는 발송되지 않고 그 사유를 알려줍니다.
발송한 초대는 14일간 유효합니다. 대기 중 초대 목록에서 남은 기간을 확인하고, 답이 없으면 재발송하거나 취소할 수 있습니다. 취소하면 이미 보낸 초대 링크도 더 이상 쓸 수 없습니다.
초대받은 사람이 메일의 링크로 가입하면 워크스페이스 멤버로 합류합니다. 멤버 권한이나 초대 메일이 헷갈리면 가이드 FAQ에서 확인 지점을 먼저 보세요.
5. 외부 도구 연결하기 (선택)
Jira, Notion 등 프로젝트 관리 도구를 연동할 수 있습니다. 기존 워크플로우를 유지하면서도 이슈 관리를 더 전문적이고 편리하게 할 수 있도록 도와줍니다.
6. SDK API key 발급하기 (SDK 전용)
여기부터는 SDK Widget과 SDK Headless를 쓸 때만 필요합니다. Extension만 쓴다면 준비는 여기서 끝입니다.
프로젝트 설정에서 SDK API key를 생성합니다. 생성된 전체 key는 한 번만 보이니 설치 코드와 key를 안전한 환경 변수로 옮겨두세요.
이제 사용하려는 방법에 따라 다음 문서로 이동해주세요.
- SDK Widget 시작하기 — 기본 위젯 UI를 그대로 씁니다.
- SDK Headless 시작하기 — 화면을 직접 만들어 붙입니다.