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 생성하기

1. https://api.slack.com/apps 으로 이동합니다.

2. Create an App 버튼을 클릭합니다.

3. 위 화면에서 알림을 보낼 App Name 과 Slack Workspace 를 선택합니다.

4. Create App 을 클릭합니다.

2-1. Webhook 타입으로 연동하기

1. 해당 앱 페이지 내에서 Incoming Webhooks 메뉴로 이동합니다.

2. Activate Incoming Webhooks 옵션을 활성화합니다.

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

4. Workspace 내에 경보를 보낼 채널을 선택한 뒤 허용 버튼을 클릭합니다.

5. Webhook URL 정보가 위와 같이 생성되며, 해당 정보를 복사합니다.

6. QueryPie 의 채널 생성 화면에서 각각 아래와 같이 설정 후 채널 등록을 완료하면 됩니다.

   1. Type : Slack 을 선택

   2. Slack Type : Webhook을 선택

   3. Request URL : 5번 과정에서 복사했던 URL을 붙여넣기

2-2. API 타입으로 연동하기

1. 생성했던 App 을 클릭하여 앱의 Settings 화면으로 이동합니다.

2. 해당 앱 페이지 내에서 App Manifest 메뉴로 이동합니다.

3. scopes 영역에 chat:write 를 추가한 뒤 저장합니다.

4. 이후에는 반드시 상단의 노란색 알림 바를 통해 Reinstall your app 을 통해 앱을 재시작합니다.

5. Reinstall to Workspace 를 클릭하여 경보를 보낼 Slack 채널을 선택한 뒤 허용 버튼을 클릭합니다.

6. 해당 Slack 채널로 이동하여 생성한 앱을 추가합니다.

7. 해당 Slack 채널의 세부정보에서 채널 ID 를 복사합니다. (ex. C6FNHQA3)

8. Bot User OAuth Token 정보를 복사합니다.

9. QueryPie 의 채널 생성 화면에서 각각 아래와 같이 설정 후 채널 등록을 완료하면 됩니다.

   1. OAuth Token : 8번 과정에서 복사했던 토큰을 붙여넣기

   2. Slack Channel : 7번 고정에서 복사했던 채널의 ID 를 붙여넣기