이슈스티커이 문서가 필요한 경우
- QA 보드, 운영 요청, 고객 피드백을 Notion 데이터베이스에서 관리하는 경우
- 이슈스티커에서 생성하는 이슈를 Notion 페이지로 한 번에 관리하고 싶은 경우
시작하기 전에
이슈를 받을 데이터베이스를 먼저 정하세요. 기존 버그 보드가 있으면 그대로 쓰고, 없다면 제목, 상태, 담당자, 링크 정도만 있는 데이터베이스로 시작하면 됩니다.
연결에는 해당 데이터베이스에 접근할 수 있는 Notion 계정이 필요합니다.
끝나면 확인할 것
- 이슈를 받을 Notion 데이터베이스를 정했습니다.
- 이슈 생성 화면에 노출할 속성을 골랐습니다.
- 이슈를 생성하면 Notion 페이지가 자동으로 함께 생성되고, Notion에서 바뀐 값은
필드 동기화로 가져올 수 있습니다.
1. OAuth 연결하기
관리자 콘솔의 프로젝트 설정에서 Notion 연동을 시작합니다. Notion 권한 화면이 열리면 사용할 워크스페이스를 고르고, 이슈스티커가 접근할 페이지나 데이터베이스를 허용합니다.
여기서 허용하지 않은 데이터베이스는 다음 단계 목록에 나오지 않습니다.
2. 데이터베이스 선택하기
접근 가능한 데이터베이스 목록에서 이슈를 모을 곳을 선택하면 이슈스티커가 속성 목록을 읽어옵니다.
3. 연동할 필드 정하기
선택한 데이터베이스의 속성을 그대로 읽어옵니다. 이슈 생성 화면에 노출할 속성만 켜세요. 입력 형식은 Notion에 설정된 속성 타입을 그대로 따릅니다.
제목, 상태, 담당자, 우선순위 정도면 시작하기에 충분합니다. 나머지는 Notion에서 후속 정리하도록 두세요.
4. 페이지 생성 확인하기
Extension이나 SDK에서 이슈를 만들면 선택한 데이터베이스에 페이지가 생성됩니다. 페이지 본문에는 이슈스티커에 작성한 설명이 제목, 목록, 굵게, 표 같은 서식을 유지한 채 들어갑니다. 재현 URL, 브라우저 정보, 스크린샷 같은 나머지 정보는 페이지 본문이 아니라 이슈스티커 이슈 상세에서 확인하세요.
5. 동기화되는 범위 확인하기
제목은 양방향으로 동기화됩니다. 이슈스티커에서 제목을 고치면 Notion 페이지의 제목 속성이 바뀌고, Notion에서 제목 속성을 고치면 이슈스티커 제목이 바뀝니다.
설명은 Notion → 이슈스티커 방향으로만 동기화됩니다. 이슈를 생성할 때 이슈스티커의 설명이 Notion 페이지 본문으로 한 번 들어가고, 그 이후로는 Notion 페이지 본문이 설명의 원본이 됩니다. Notion에서 본문을 고치면 이슈스티커 설명에 반영되지만, 이슈스티커에서 설명을 고쳐도 그 내용은 Notion으로 전달되지 않습니다. 설명을 계속 관리하고 싶다면 Notion 페이지에서 편집하세요.
제목, 목록, 체크박스, 인용, 코드블록, 굵게·기울임·링크 같은 서식은 양쪽 방향 모두 유지됩니다. Notion에서 하위 항목을 들여써서 계층을 만들면 그 구조도 그대로 들어옵니다. 다만 Notion 페이지 안에 따로 만든 하위 페이지의 내용은 설명에 포함되지 않습니다.
Notion에서 무엇을 바꾸든 제목, 속성, 설명이 함께 최신 값으로 맞춰집니다. 상태나 담당자만 바꿔도 그 시점의 페이지 본문을 다시 읽어 설명에 반영합니다. 반영이 바로 보이지 않는다면 이슈 팝오버의 Notion 연동 영역에서 필드 동기화를 누르세요. 그 자리에서 Notion의 최신 값을 다시 읽어옵니다.
문제가 생겼을 때 먼저 확인할 것
- 데이터베이스가 보이지 않으면 Notion 연결 권한을 다시 열고 해당 데이터베이스를 포함합니다.
- 담당자 값이 들어가지 않으면 Notion 사용자와 이슈스티커 멤버가 같은 이메일로 연결되어 있는지 확인합니다.
- 값이 계속 비어 있으면 해당 속성이 켜져 있는지와 권한 범위를 확인합니다.