Slack 연결: 단계별 가이드
실행 요약을 채널에 게시하며, NEXUS_SLACK_NOTIFY=true이면 실패, 불안정, 카오스 또는 시각적 회귀 테스트마다 메시지를 하나씩 게시합니다. 실패 알림 메시지에는 Jira 티켓이 있는 경우 해당 티켓 링크가 포함됩니다. 이 가이드는 처음부터 연결 확인까지 안내하고, 발생할 수 있는 오류와 그 원인 및 해결 방법을 정리합니다.
최종 업데이트:
자격 증명은 비공개로 유지하세요. 토큰, 키, 비밀번호, 웹후크 URL을 채팅에 붙여넣지 마세요. Studio → 설정 → 연동에만 입력하세요. 입력한 정보는 작업 공간의 .env 파일에 저장되며 점으로 표시됩니다. AI 도우미도 마찬가지입니다: 이 안내를 따라 진행하도록 도와줄 수는 있지만, 토큰을 알려줄 필요는 없습니다.
준비 사항
- 앱을 추가할 수 있는 Slack 워크스페이스.
- 메시지를 받을 채널의 수신 웹후크 URL 하나.
자격 증명 발급
- Slack에서 수신 웹훅(https://api.slack.com/messaging/webhooks)이 있는 앱을 만들고 채널을 선택하세요.
- 웹훅 URL을 복사하세요. https://hooks.slack.com/services/로 시작합니다. URL 자체가 비밀 정보입니다.
- 클립보드에 보관하세요. Studio(다음 단계) 외에는 어디에도 붙여넣지 마세요.
Studio에서 연결
- Studio에서 설정 → 연동 → Slack을 여세요.
- 웹훅 URL을 붙여넣고 저장 & 테스트 전송을 누르세요. 채널로 테스트 메시지가 전송됩니다.
SLACK_ENABLED를 켜세요. 실패한 테스트마다 메시지를 하나씩 보내려면NEXUS_SLACK_NOTIFY도 켜세요.
작동 확인
- 테스트 메시지 전송을 누르면 "전송됨."이라는 응답이 나오고 채널에 메시지가 표시됩니다.
- 아무 테스트나 실행하세요. 실행 요약이 채널로 전송됩니다.
자주 발생하는 오류
| 관찰되는 결과 | 원인 | 해결 방법 |
|---|---|---|
| "웹훅 없음" | SLACK_WEBHOOK_URL이 비어 있습니다. | 설정 → 연동에서 웹훅 URL을 붙여넣고 저장하세요. |
"SLACK_WEBHOOK_URL이 Slack 수신 웹훅이 아닙니다" | 값이 https://hooks.slack.com/services/로 시작하지 않습니다. | Slack 앱의 수신 웹훅 페이지에서 웹훅 URL을 다시 복사하세요. |
| HTTP 404 "no_service" 또는 HTTP 403 "invalid_token" | 웹훅이 해지 또는 삭제되었거나, 작업 공간에서 앱이 제거되었습니다. | 새 수신 웹훅을 만들고 새 URL을 저장하세요. |
| HTTP 404 "channel_not_found" 또는 HTTP 410 "channel_is_archived" | 웹훅이 메시지를 게시하는 채널이 삭제되었거나 보관 처리되었습니다. | 활성 채널에 새 웹훅을 만드세요. |
| "Slack에 연결할 수 없습니다 (ENOTFOUND)" 또는 "20초 이내에 응답하지 않았습니다" | VPN이나 프록시, 또는 네트워크 연결 부재로 이 PC에서 Slack에 연결할 수 없습니다. | 동일한 PC에서 네트워크를 확인하고 다시 시도하세요. |
| 테스트는 작동하지만 실패 알림이 게시되지 않음 | SLACK_ENABLED가 false이거나 실행 요약만 켜져 있습니다: 테스트별 메시지를 보내려면 NEXUS_SLACK_NOTIFY=true가 필요합니다. | 두 스위치를 모두 켜세요. |
설정 키
| 키 | 주요 기능 | 유효한 값 | 확인 방법 |
|---|---|---|---|
SLACK_ENABLED | Slack으로 알림 보내기 | true 또는 false | 테스트 메시지가 도착한 후 켜세요. |
SLACK_WEBHOOK_URL | 알림을 받을 Slack 채널 (비밀 정보, 이 컴퓨터에만 저장됨) | https://hooks.slack.com/services/… (다른 형식은 허용되지 않음) | 테스트 메시지 전송을 누르면 채널에 메시지가 게시됩니다. |
NEXUS_SLACK_NOTIFY | 실패 건별 Slack 알림 | true 또는 false | 실행 요약뿐 아니라 실패한 테스트마다 메시지가 하나씩 전송됩니다. |
더 보기: 모든 연동, 설정 안내, 문제 해결. 다른 안내: Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
아직 해결되지 않았나요? Studio에 표시되는 오류 문구를 그대로 적어 [email protected]으로 보내 주세요. 토큰은 포함하지 마세요.