이슈가 생기거나 검증이 실패하면 팀이 보는 채널로 바로 알림을 받을 수 있어요. 웹훅은 팀 전체(FULL) 권한이 있는 사람이 추가해요.
보낼 수 있는 이벤트
| 이벤트 | 언제 |
|---|---|
| 이슈 생성 | 새 이슈가 만들어졌을 때 |
| 검증 실패 · 막힘 | 핸드오프 · 테스트 실행 · 리뷰 · 발굴 기록이 실패나 막힘으로 바뀌었을 때 |
| 테스트 실행 끝남 | 테스트 실행이 통과 · 실패 · 막힘으로 끝났을 때 (케이스 수가 같이 와요) |
실패한 테스트 실행은 「검증 실패 · 막힘」 과 「테스트 실행 끝남」 둘 다에 해당해요. 둘 다 고르면 알림이 두 번 와요.
디스코드 · 슬랙 채널로 받기
- 받을 채널의 웹훅 주소를 만들어요
- 디스코드: 채널 설정 › 연동 › 웹후크 › 새 웹후크 › 웹후크 URL 복사
- 슬랙: 슬랙 앱 디렉터리의 Incoming Webhooks 에서 채널을 고르고 주소를 복사
- Prober 콘솔 왼쪽 팀 메뉴 설정 › 연동 맨 아래 웹훅 카드에서 웹훅 추가 를 눌러요
- 이름 · 주소를 넣고, 프로젝트(비우면 팀 전체)와 보낼 이벤트 를 골라 추가
- 목록의 테스트 를 눌러 「도착했어요」 가 뜨는지, 채널에 「Prober 웹훅 테스트」 카드가 왔는지 봐요
주소 모양을 보고 디스코드 · 슬랙인지 알아서 골라요. 주소는 저장한 뒤 다시 보이지 않아요(가린 주소만 보여요).
우리 서버로 받기 (일반 웹훅)
디스코드 · 슬랙이 아닌 https 주소를 넣으면 JSON 으로 보내요. 추가하면 서명 키(whsec_ 로 시작)가 한 번 보여요. 받는 서버는 이 키로 요청이 Prober 에서 왔는지 확인해요.
- 요청 헤더:
webhook-id(재시도해도 같아요. 같은 값이면 한 번만 처리하세요) ·webhook-timestamp·webhook-signature - 서명은 Standard Webhooks 규격이라 공개 라이브러리로 바로 확인할 수 있어요
- 2xx 로 10초 안에 답해 주세요. 리다이렉트는 따라가지 않아요
- 키를 잃어버렸으면 보낸 기록 · 설정 을 펼쳐 서명 키 보기, 바꾸려면 서명 키 새로 만들기 (옛 키도 24시간 같이 서명해요)
- 내부망(사설 IP · localhost) 주소는 받지 않아요
다 됐는지 확인
테스트 를 눌러 「도착했어요 · 204」 처럼 보이면 끝이에요. 이어서 그 프로젝트에 이슈를 하나 만들어 보면 채널에 「이슈 생성」 카드가 와요.
이럴 땐
- 「실패했어요 · 404」: 채널에서 웹훅이 삭제됐거나 주소를 잘못 붙여 넣었어요. 웹훅을 삭제하고 새 주소로 다시 추가해요
- 「자동으로 꺼짐」 이 붙었어요: 받는 쪽이 사흘 동안 계속 실패했거나 웹훅을 지웠다고(410) 답했어요. 받는 쪽을 고친 뒤 보낸 기록 · 설정 에서 켜기 를 눌러요. 놓친 알림은 보낸 기록에서 다시 보내기
- 잠깐 멈추고 싶어요: 잠시 끄기. 꺼진 동안 생긴 이벤트는 보내지 않아요
- 웹훅 카드가 안내 한 줄뿐이에요: 웹훅은 팀 전체(FULL) 권한만 다뤄요. 팀 관리자에게 요청해요
- AI 에이전트로 다루고 싶어요: MCP 를 연결하면
list_webhooks·create_webhook·update_webhook·test_webhook·list_webhook_deliveries를 쓸 수 있어요 (AI 앱에 연결하기)