Channels

Overview

ChannelsページではQueryPieから送信する通知を受信するチャンネルを登録および管理します。 現在QueryPieで提供するチャンネルタイプはSlack、Agit、HTTP、Emailの4つであり、チャンネル登録事前に連携のための作業が必要です。

登録されたチャンネル照会

Administrator > General > Company Management > Channelsページで現在登録されたチャンネルリストを照会できます。 チャンネル名で検索が可能で、Channel Typeでフィルタリングできます。

リスト内項目をクリックすると詳細情報を照会および変更できます。

チャンネル登録

Channelsページ右上のCreate Channelボタンをクリックするとチャンネル作成モーダルが表示されます。

• Title : チャンネル名
• Channel Type : 通知を受信するチャンネルタイプを選択します。選択肢により下部追加入力項目が異なります。
  • Slack : Slackチャンネルで通知送信
  • Agit : アジットで通知送信
  • HTTP : Zapier、Okta WorkflowsなどHTTP APIに直接リクエストする方式
  • Email : メールで通知送信

Channel TypeをSlackで選択した場合

チャンネル作成のための入力内容は以下の通りです。

• Message Sending Method : メッセージ送信方式
  • API : Slack APIを活用したメッセージ送信
    • APIを選択した場合、New Request Alertで承認者（assignee）メンションが可能です。（10.2.2バージョン以降）
    • Bot User OAuth Token : メッセージを送信するSlack AppのBot User OAuth Token
    • Channel ID : メッセージを送信するSlack Appが招待されているSlack Channel ID
  • Webhook : ウェブフック方式でメッセージ送信
    • Request URL（必須） : リクエストを送信するURL
      • Slack AppでWebhook設定後、Webhook URL情報をコピーして貼り付けする必要があります

Channel TypeをAgitで選択した場合

チャンネル作成のための入力内容は以下の通りです。

• Request URL （必須） : リクエストを送信するURL
• Agit Channel : アジットチャンネルに表示する名前入力

Channel TypeをHTTPで選択した場合

チャンネル作成のための入力内容は以下の通りです。

• Request URL （必須） : リクエストを送信するURL
• Request Header (JSON) : 必要時呼び出しのためのリクエストヘッダーを入力（JSON形式）
• Body Template : リクエストボディテンプレート
  • デフォルト値：{{message}}
  • Alertで定義されるメッセージの前後に共通で追加したい内容を記入

Channel TypeをEmailで選択した場合

チャンネル作成時入力内容は以下の通りです。

• Email Recipients （必須） : メール受信者
  • QueryPieに登録されたユーザーを選択でき、登録されたメールアドレスでメールが送信されます
• Body Template : リクエストボディテンプレート
  • デフォルト値：{{message}}
  • Alertで定義されるメッセージの前後に共通で追加したい内容を記入

チャンネル削除

Channelsページ内チャンネルリストで削除したいチャンネルをチェックボックスで選択するとDeleteボタンが表示されます。 ボタンをクリックすると削除確認モーダルが出力されます。OKボタンをクリックすると削除が完了します。

Slack連携のためのSlack App設定方法

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をクリックします。

1. Workspace内に警報を送信するチャンネルを選択した後 許可 ボタンをクリックします。
2. 生成されたWebhook URL情報をコピーした後、QueryPieチャンネル作成モーダルに貼り付けます。

2-2. APIタイプで連携

1. 生成したAppをクリックしてアプリのSettingsページに進入した後、App Manifestメニューに移動します。
2. scopes領域にchat:write, users:read, users:read.emailを追加した後保存します。
   

3. 上部の黄色い通知バーを通じてReinstall your appでアプリを再起動します。（必須）
4. Reinstall to {Workspace_name} ボタンをクリックして通知を送信するSlackチャンネルを選択した後 許可 ボタンをクリックします。
   1. Scopeを変更した後適用するには、この段階を再度実行する必要があります。
5. 該当Slackチャンネルに移動して生成したアプリを追加します。（既にアプリを追加した状態であればこの段階はスキップできます）
6. チャンネル名をクリックしてChannel Detailモーダルを開き、モーダル下部でChannel IDをコピーします。コピーしたChannel IDをQueryPieチャンネル作成モーダルに貼り付けます。
   

7. OAuth & PermissionsページでBot User OAuth Tokenをコピーし、QueryPieチャンネル作成モーダルに貼り付けます。