/
(10.0.1-ko) Channels
Document toolboxDocument toolbox

(10.0.1-ko) Channels

Owned by Katie Noh
Last updated: 8월 06, 2024Version comment

Overview

Channels 페이지에서는 QueryPie에서 발송하는 알림을 수신할 채널을 등록 및 관리합니다. 현재 QueryPie에서 제공하는 채널 타입은 아래 3가지이며, 채널 등록 사전에 연동을 위한 작업이 필요합니다.

  • HTTP

  • Agit

  • Slack

 

등록된 채널 조회하기

Administrator > General > Company Management > Channels 페이지에서 현재 등록된 채널 목록을 조회할 수 있습니다. 채널명으로 검색이 가능하며, Channel Type으로 필터링할 수 있습니다.

스크린샷 2024-08-04 오후 6.52.18.png
Administrator > General > Company Management > Channels

 

채널 삭제하기

Channels 페이지 내 채널 목록에서 삭제하려는 채널을 체크박스로 선택하면 Delete 버튼이 노출됩니다. 버튼을 클릭하면 삭제 확인 모달이 출력됩니다. OK 버튼을 클릭하면 삭제가 완료됩니다.

스크린샷 2024-07-28 오후 10.20.04.png
Administrator > General > Company Management > Channels > Delete 확인 모달

 

채널 등록하기

Channels 페이지 우상단 Create Channel 버튼을 클릭하면 채널 생성 모달이 노출됩니다.

스크린샷 2024-07-28 오후 10.04.33.png
Administrator > General > Company Management > Channels > Create Channel

  • Title : 채널 이름

  • Type : 알림을 받을 채널 타입 - 선택지에 따라 입력값 상이함

    • HTTP : Zapier, Okta Workflows 등 HTTP API에 직접 요청하는 방식

      • Request URL (필수) : 요청을 보낼 URL

      • Request Header (JSON) : 필요시 호출을 위한 요청 헤더를 입력 (JSON 형식)

      • Body Template : 요청 바디 템플릿

        • 기본값 : {{message}} - Alert 에서 정의되는 메시지를 그대로 발송하게 됨

    • Agit : 아지트 내 Incoming Webhook으로 알림 전송

      • Request URL : 아지트에서 제공하는 Webhook URL

      • Agit Channel : 알림 수신할 아지트 이름

      • 자세한 내용은 하단 Agit 연동하기 참고

    • Slack : Slack 채널로 알림 전송

      • Slack Type : Webhook 또는 API 방식 중 택일

      • 자세한 내용은 하단 Slack 연동하기 참고

 

Slack 연동하기

1. App 생성하기

스크린샷 2024-03-05 오후 4.10.15.png
Slack 내 App 생성

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

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

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

  4. Create App 을 클릭합니다.

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

스크린샷 2024-08-04 오후 7.07.16.png
Slack 내 Incoming Webhook 설정

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

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

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

image-20240305-110658.png
Slack 내 Webhook 추가 화면

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

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

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

    1. Type : Slack 을 선택

    2. Slack Type : Webhook을 선택

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

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

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

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

image-20240305-112509.png
Slack 내 App Manifest 메뉴

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

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

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

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

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

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

스크린샷 2024-08-04 오후 7.08.35.png
Slack 내 OAuth & Permissions 페이지 - 토큰 복사

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

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

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

 

Agit 연동하기

  1. 아지트 화면 우상단의 메뉴에서 Incoming Webhook 을 클릭합니다.

스크린샷 2024-08-04 오후 7.09.19.png
Agit 내 Incoming Webhook 메뉴

  1. 알림을 발송할 그룹을 선택 후 Add Incoming Webhook Integration 버튼을 클릭합니다.

  2. 상세화면의 Webhook URL 을 복사해준뒤 웹훅 설정을 저장합니다.

스크린샷 2024-08-04 오후 7.10.42.png

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

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

 

Related content