Channels
Overview
Channels 페이지에서는 QueryPie에서 발송하는 알림을 수신할 채널을 등록 및 관리합니다. 현재 QueryPie에서 제공하는 채널 타입은 아래 2가지이며, 채널 등록 사전에 연동을 위한 작업이 필요합니다.
HTTP
Slack
등록된 채널 조회하기
Administrator > General > Company Management > Channels 페이지에서 현재 등록된 채널 목록을 조회할 수 있습니다. 채널명으로 검색이 가능하며, Channel Type으로 필터링할 수 있습니다.
채널 등록하기
Channels 페이지 우상단 Create Channel
버튼을 클릭하면 채널 생성 모달이 노출됩니다.
Title : 채널 이름
Type : 알림을 받을 채널 타입 - 선택지에 따라 입력값 상이함
HTTP : Zapier, Okta Workflows 등 HTTP API에 직접 요청하는 방식
Request URL (필수) : 요청을 보낼 URL
Request Header (JSON) : 필요시 호출을 위한 요청 헤더를 입력 (JSON 형식)
Body Template : 요청 바디 템플릿
기본값 : {{message}} - Alert 에서 정의되는 메시지를 그대로 발송하게 됨
Slack : Slack 채널로 알림 전송
Slack Type : Webhook 또는 API 방식 중 택일
자세한 내용은 하단 Slack 연동하기 참고
채널 삭제하기
Channels 페이지 내 채널 목록에서 삭제하려는 채널을 체크박스로 선택하면 Delete
버튼이 노출됩니다. 버튼을 클릭하면 삭제 확인 모달이 출력됩니다. OK
버튼을 클릭하면 삭제가 완료됩니다.
Slack 연동하기
1. App 생성하기
https://api.slack.com/apps 으로 이동합니다.
Create an App
버튼을 클릭합니다.위 화면에서 알림을 보낼 App Name 과 Slack Workspace 를 선택합니다.
Create App
을 클릭합니다.
2-1. Webhook 타입으로 연동하기
해당 앱 페이지 내에서
Incoming Webhooks
메뉴로 이동합니다.Activate Incoming Webhooks 옵션을 활성화합니다.
하단의
Add New Webhook to Workspace
를 클릭합니다.
Workspace 내에 경보를 보낼 채널을 선택한 뒤
허용
버튼을 클릭합니다.Webhook URL 정보가 위와 같이 생성되며, 해당 정보를 복사합니다.
QueryPie 의 채널 생성 화면에서 각각 아래와 같이 설정 후 채널 등록을 완료하면 됩니다.
Type : Slack 을 선택
Slack Type : Webhook을 선택
Request URL : 5번 과정에서 복사했던 URL을 붙여넣기
2-2. API 타입으로 연동하기
생성했던 App 을 클릭하여 앱의 Settings 화면으로 이동합니다.
해당 앱 페이지 내에서
App Manifest
메뉴로 이동합니다.
scopes 영역에
chat:write
를 추가한 뒤 저장합니다.이후에는 반드시 상단의 노란색 알림 바를 통해
Reinstall your app
을 통해 앱을 재시작합니다.Reinstall to Workspace
를 클릭하여 경보를 보낼 Slack 채널을 선택한 뒤허용
버튼을 클릭합니다.해당 Slack 채널로 이동하여 생성한 앱을 추가합니다.
해당 Slack 채널의 세부정보에서 채널 ID 를 복사합니다. (ex. C6FNHQA3)
Bot User OAuth Token
정보를 복사합니다.
QueryPie 의 채널 생성 화면에서 각각 아래와 같이 설정 후 채널 등록을 완료하면 됩니다.
OAuth Token : 8번 과정에서 복사했던 토큰을 붙여넣기
Slack Channel : 7번 고정에서 복사했던 채널의 ID 를 붙여넣기