가이드 FAQ

이 문서가 필요한 경우

먼저 이슈스티커 안에서 프로젝트 멤버인지 확인하세요. 외부 연동 화면은 프로젝트 설정 권한이 있는 멤버에게만 열릴 수 있습니다.

Jira나 Notion 안에서도 권한이 필요합니다. 이슈스티커에서 권한을 허용했더라도, 해당 Jira 프로젝트나 Notion 데이터베이스에 접근 권한이 없으면 목록이 보이지 않습니다.

브라우저에서 이미 로그인된 계정이 원하는 계정인지 확인합니다. 회사 계정과 개인 계정을 함께 쓰는 경우 다른 계정으로 권한을 허용하는 일이 잦습니다.

연결을 다시 시도할 때는 외부 서비스의 권한 관리 화면에서 기존 이슈스티커 연결을 제거한 뒤 다시 연결하면 더 깔끔합니다.

Extension과 SDK는 프로젝트에 등록된 도메인에서만 동작합니다. URL 전체가 아니라 origin 단위로 맞춰야 합니다. 현재 화면에서 window.location.origin으로 확인되는 값과 등록값이 같아야 합니다.

경로가 붙은 https://app.example.com/dashboard가 아니라, origin인 https://app.example.com을 등록하세요.

SDK API key는 프로젝트 단위로 발급됩니다. 운영 서비스에 넣는 key와 테스트용 key는 분리하는 편이 좋습니다.

발급된 key는 처음 한 번만 확인할 수 있다고 생각하고 관리하세요. key가 외부에 노출되었거나 더 이상 쓰지 않는다면 새 key를 만들고 기존 key를 비활성화합니다.

처음 연결할 때는 이슈 생성, 이슈 조회, 미디어 업로드에 필요한 scope부터 작게 시작하세요. 실제 운영 흐름이 안정된 뒤 필요한 권한만 늘리는 편이 안전합니다.

현재 문서화된 headless API는 issue-sticker/runtime의 초기화, 종료, 이벤트 구독입니다. UI 없이 런타임 상태를 연결하는 용도이며, 공개된 이슈 생성 API를 대신하지 않습니다.

이슈 생성까지 직접 제어해야 하는 경우에는 제품에 맞는 공개 API가 준비된 뒤 별도 문서를 확인해야 합니다.

선택한 Jira 프로젝트와 이슈 타입에 실제로 연결된 필드인지 확인하세요. Jira에서는 같은 필드라도 프로젝트나 이슈 타입에 따라 보이지 않을 수 있습니다.

커스텀 필드는 Jira 권한, 화면 설정, 필드 컨텍스트 영향을 받습니다. Jira 관리자 화면에서 해당 필드가 선택한 이슈 타입 화면에 포함되어 있는지 확인해야 합니다.

OAuth 권한 화면에서 그 데이터베이스를 허용했는지 확인합니다. Notion은 워크스페이스 전체가 아니라 선택한 페이지와 데이터베이스 단위로 권한이 열릴 수 있습니다.

권한을 다시 열어 데이터베이스를 포함한 뒤 이슈스티커에서 목록을 새로고침하세요.

외부 서비스 API, webhook, 큐 처리 시간 때문에 상태 반영이 조금 늦을 수 있습니다. 테스트할 때는 변경 후 잠시 기다리고 새로고침해 보세요.

몇 분이 지나도 계속 반영되지 않으면 OAuth 연결 상태, webhook secret, 선택한 프로젝트나 데이터베이스를 차례대로 확인합니다.