Slack 연동
이슈 등록, 상태 변경, 댓글 등 주요 이벤트를 Slack으로 전달하세요
목차
Slack 연동이란?
Slack 연동을 설정하면 QA Note의 주요 이벤트를 Slack 채널로 실시간 알림 받을 수 있습니다. 팀이 Slack에서 바로 새 이슈를 확인하고, 상태 변경과 댓글 추가를 추적할 수 있습니다.
연동 설정
1. Slack 앱 연결
프로젝트 설정 → 연동 탭에서 Slack 연결 버튼을 클릭합니다. Slack OAuth 인증을 통해 워크스페이스에 QA Note 봇이 설치됩니다.
2. 채널 선택
연결 후 알림을 받을 Slack 채널을 선택합니다. 검색을 통해 원하는 채널을 찾을 수 있으며, public/private 채널 모두 지원됩니다.
3. 알림 이벤트 설정
어떤 이벤트에 대해 알림을 받을지 개별적으로 설정할 수 있습니다.
| 이벤트 | 설명 | 기본값 |
|---|---|---|
| 이슈 등록 | 새 이슈가 등록되었을 때 | 켜짐 |
| 댓글 추가 | 이슈에 새 댓글이 달렸을 때 | 꺼짐 |
| 상태 변경 | 이슈 상태가 변경되었을 때 | 꺼짐 |
| 담당자 지정 | 이슈에 담당자가 지정되었을 때 | 꺼짐 |
알림 메시지 형태
Slack 알림은 Block Kit을 사용하여 구조화된 메시지로 전달됩니다.
이슈 등록 알림
- 등록자 이름, 이슈 제목(대시보드 링크 포함), 설명 미리보기
- 상태와 우선순위 표시
- 프로젝트 이름, 페이지 URL
- 이슈 보기 버튼
댓글 추가 알림
- 댓글 작성자, 댓글 내용 미리보기
- 원본 이슈 링크
- 댓글 보기 버튼
상태 변경 알림
- 변경 전 → 변경 후 상태 (이모지 포함)
- 변경한 사용자 이름
담당자 지정 알림
- 지정한 사용자, 지정된 담당자
- 원본 이슈 링크
개인 알림 설정
프로젝트 채널 알림과 별도로, 각 팀원이 개인 Slack 알림을 설정할 수 있습니다.
- 채널 알림: 특정 채널에 개인 알림을 보냅니다.
- DM 알림: QA Note 봇이 Slack DM으로 직접 알림을 보냅니다.
이벤트별로 필터링할 수 있어, 예를 들어 "내가 담당자로 지정된 이슈만 DM으로 받기"와 같은 설정이 가능합니다.
메시지 업데이트
Slack Bot Token 방식으로 연결하면, 이슈 상태가 변경될 때 기존 Slack 메시지가 자동으로 업데이트됩니다. 채널에서 최신 상태를 바로 확인할 수 있습니다.
연결 테스트
설정 완료 후 테스트 버튼으로 Slack 연결이 정상인지 확인할 수 있습니다. 테스트 성공 시 선택된 채널에 테스트 메시지가 전송됩니다.
연결 해제
프로젝트 설정에서 연결 해제 버튼을 클릭하면 Slack 연동이 해제됩니다. 기존 Slack 메시지는 유지되며, 이후 새 알림이 전송되지 않습니다.