웹훅으로 알림 보내기
웹훅으로 알림 이벤트를 팀이 확인하는 채널에 전달할 수 있습니다. Alpacon은 입력한 URL을 기준으로 Slack, Discord, Microsoft Teams, Telegram 또는 사용자 지정 HTTP 주소를 판별하고, 대상 서비스에 맞는 형식으로 메시지를 보냅니다. 이벤트와 수신자는 알림 이벤트와 전달 경로에서 확인하세요. 명령줄 관리와 페이로드 설정은 웹훅 CLI 참조를 참고하세요.
웹훅 만들기
- 워크스페이스 설정 → 연동 → 웹훅으로 이동합니다.
- 새 웹훅을 클릭합니다.
- 이름과 URL을 입력합니다. 제공업체는 URL에서 자동으로 판별되며, 필요하면 직접 지정할 수 있습니다. 공개 주소에서는 SSL 인증 확인을 켜고 웹훅을 활성화합니다.
- 저장합니다.
경고
웹훅의 SSL 검증을 끄면 메시지가 가로채일 수 있습니다. 공개 엔드포인트에서는 검증을 켜 두고, 신뢰할 수 있는 내부 주소나 로컬 테스트에서만 끄세요.
Slack 웹훅은 알림을 게시하기만 합니다. Slack에서 요청을 승인하려면 Slack 앱을 연결하세요. Slack을 참고하세요.
지원하는 서비스
| 제공업체 | URL 패턴 |
|---|---|
| Slack | hooks.slack.com |
| Discord | discord.com/api/webhooks |
| Microsoft Teams | *.logic.azure.com, *.webhook.office.com |
| Telegram | api.telegram.org |
| 사용자 지정 | 그 밖의 모든 URL |
서비스별 설정
Slack
- Slack 워크스페이스에서 앱으로 이동해 “Incoming WebHooks” 검색
- 채널에 추가한 뒤 웹훅 URL 복사
Discord
- 서버 설정 → 연동 → 웹훅으로 이동
- 웹훅을 만들고 채널을 선택한 뒤 URL을 복사합니다.
Microsoft Teams
Workflows 사용을 권장합니다:
- 사이드바의 채널 이름에 마우스를 올리고 더보기(…) → Workflows 클릭
- “웹훅 요청을 받으면 채널에 게시” 검색
- 설정을 마친 뒤 웹훅 URL 복사
기존 Incoming Webhook을 사용하는 방법입니다:
- 사이드바의 채널 이름에 마우스를 올리고 더보기(…) → 채널 관리 클릭
- 편집을 선택하고 Incoming Webhook을 검색한 뒤 추가 선택
- 설정한 뒤 웹훅 URL 복사
Telegram
- @BotFather에게 메시지를 보내 봇을 만들고 토큰 받기
- 채팅 ID를 확인한 뒤 다음 URL 구성:
https://api.telegram.org/bot<token>/sendMessage?chat_id=<id>
사용자 지정
POST 요청을 받는 HTTP 엔드포인트를 설정하고 URL을 직접 입력하세요.
웹훅 관리
- 웹훅 카드를 클릭해 상세 관리 화면 열기
- 설정 변경 또는 삭제