Notion 연동 가이드

이 문서가 필요한 경우

Notion 연동은 먼저 “어느 데이터베이스를 QA 보드로 쓸지”를 정해야 합니다. 기존 버그 보드가 있다면 그대로 연결하고, 없다면 제목, 상태, 담당자, 링크 정도가 있는 간단한 데이터베이스로 시작하세요.

이슈스티커는 선택한 데이터베이스에 페이지를 만들고 필요한 속성을 채웁니다.

처음부터 속성을 많이 만들 필요는 없습니다. 팀이 매일 보는 필드부터 연결하고, 회의나 릴리즈 정리에 필요한 필드는 실제 운영하면서 추가하세요.

이슈스티커 관리자에서 Notion 연동을 시작합니다. Notion 권한 화면이 열리면 사용할 워크스페이스를 고르고, 이슈스티커가 접근할 페이지나 데이터베이스를 허용합니다.

연동할 데이터베이스가 목록에 나오지 않으면 Notion 권한 화면에서 해당 데이터베이스가 포함되었는지 확인해야 합니다.

연결이 끝나면 접근 가능한 데이터베이스 목록이 표시됩니다. QA 이슈를 모을 데이터베이스를 선택하면 이슈스티커가 속성 목록을 읽어옵니다.

테스트용 데이터베이스가 있다면 먼저 그곳에 연결해 실제 페이지가 어떻게 만들어지는지 보는 편이 좋습니다.

이슈스티커 이슈 정보를 Notion 속성에 맞춥니다. 처음에는 아래 정도만 연결해도 충분합니다.

Notion 속성 타입이 맞지 않으면 값이 들어가지 않을 수 있습니다. 예를 들어 담당자는 People 속성, 상태는 Status 또는 Select 속성에 연결하는 식으로 맞춰 주세요.

Extension이나 SDK에서 만든 이슈를 Notion으로 보내면 선택한 데이터베이스에 새 페이지가 생깁니다. 페이지 본문에는 이슈 설명, 재현 URL, 브라우저 정보, 첨부 링크가 들어갑니다.

팀이 Notion에서 코멘트와 상태 관리를 이어간다면, 이슈스티커에는 원본 캡처와 재현 정보가 남고 Notion에는 처리 흐름이 쌓이는 구조가 됩니다.

Notion에서 상태나 담당자를 바꾼 뒤 이슈스티커에서 변경이 반영되는지 확인합니다. Notion은 일부 변경이 바로 전달되지 않을 수 있어, 동기화에는 시간이 걸릴 수 있습니다.

필드가 계속 비어 있다면 선택한 속성 타입과 권한 범위를 다시 확인하세요.

데이터베이스가 보이지 않으면 Notion 연결 권한을 다시 열고 해당 데이터베이스를 포함해 주세요. 담당자 값이 들어가지 않으면 Notion 사용자와 이슈스티커 멤버가 같은 이메일로 연결되어 있는지 확인하면 좋습니다.