Integrate Slack Notifications

개요

파일 전송 작업의 상태 변화를 실시간으로 전달받으려면 Slack 알림을 연동할 수 있습니다.

연동을 완료하면 전송이 시작(Started), 완료(Completed), 실패(Failed) 되는 등 지정한 이벤트가 발생할 때마다 선택한 Slack 채널로 알림 메시지가 자동으로 전송됩니다.

전체 과정은 ① Slack에서 Webhook URL 발급 → ② 제품에서 알림 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

Slack Webhook URL 발급

먼저 Slack에서 외부 메시지를 받을 Incoming Webhook URL을 발급받습니다.

이를 위해 Slack 앱을 하나 생성하고 기능만 활성화한 후 알림을 받을 채널을 지정합니다.

Step 1. Slack 앱 생성

Slack API 페이지(https://api.slack.com/apps)에 접속한 후 Create New App → From scratch를 선택합니다.

앱 이름(예: INNORIX APP)을 입력하고 워크스페이스를 선택한 뒤 Create App을 클릭합니다.

Step 2. Incoming Webhooks 활성화

앱 설정 화면의 왼쪽 사이드바에서 Incoming Webhooks를 선택합니다.

상단의 Activate Incoming Webhooks 토글을 On으로 변경합니다.

Step 3. 워크스페이스에 웹훅 추가

화면 하단의 Add New Webhook to Workspace를 클릭합니다.

알림을 받을 채널을 선택한 뒤 Allow를 클릭합니다.

Step 4. Webhook URL 복사

Webhook URLs for Your Workspace 항목에 생성된 URL을 복사합니다.

Webhook URL은 비밀번호와 같은 정보입니다. URL을 알고 있는 사람은 누구나 해당 채널로 메시지를 전송할 수 있으므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다.

URL 형식은 다음과 같습니다.

확인 사항

• ✔ Slack 앱이 생성되었습니다.
• ✔ Incoming Webhook이 활성화되었습니다.
• ✔ Webhook URL을 복사했습니다.

Slack 알림 설정

발급받은 Webhook URL을 제품의 알림 설정에 입력합니다.

Notifications 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Webhook URL 입력

Webhook URL 항목에 복사한 URL을 붙여넣습니다.

Step 2. Sender 입력

Sender 항목에 알림 메시지에 표시될 발신자 이름을 입력합니다.

어떤 시스템에서 온 알림인지 구분할 수 있도록 지정합니다. (예: SAC-CA-Desk)

Step 3. Channel 입력

Channel 항목에 알림을 받을 채널명을 입력합니다. (예: #all-innorix)

실제 알림이 전송되는 채널은 Webhook URL에 연결된 채널이므로, Slack Webhook URL 발급에서 Webhook을 생성할 때 선택한 채널과 동일하게 입력합니다.

Step 4. 알림 이벤트 선택

Events 항목에서 알림을 받을 이벤트를 선택합니다.

여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 메시지가 전송됩니다.

Step 5. 설정 저장

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항

• ✔ Webhook URL이 입력되었습니다.
• ✔ Sender와 Channel이 설정되었습니다.
• ✔ 알림받을 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트 중 하나를 발생시킵니다.

Step 2. Slack 채널 확인

지정한 Slack 채널에 알림 메시지가 도착했는지 확인합니다.

정상적으로 연동되었다면 Sender 이름과 함께 이벤트 알림이 표시됩니다.

확인 사항

• ✔ Slack 채널에 알림이 도착했습니다.
• ✔ Sender 이름이 올바르게 표시됩니다.
• ✔ 발생한 이벤트가 정확하게 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 지정한 Slack 채널로 알림이 자동으로 전송됩니다.

문제 해결 (Troubleshooting)

알림이 오지 않는 경우 아래 항목을 확인하세요.