チャンネル

概要

チャンネルページでは、QueryPie から送信される通知を受け取るためのチャンネルを登録・管理することができます。現在、QueryPie は 4種類のチャンネルを提供しています：Slack、Agit、HTTP、Email です。チャンネルを登録する前に、事前の統合ステップが必要です。

登録済みチャンネルの確認

現在登録されているチャネルのリストを表示するには、[ 管理者 ] > [ 概要 ] > [ 企業管理 ] > [ チャネル ] ページに移動します。チャネルは名前で検索でき、チャネルタイプでフィルタリングできます。

リスト内の項目をクリックすると、その詳細を表示および編集できます。

チャンネルの作成

新しいチャンネルを登録するには、「チャンネル」ページの右上にある「チャンネルを作成」ボタンをクリックしてください。チャンネル作成モーダルが開きます。

• タイトル: チャネルの名前を入力してください。

• チャネルタイプ：通知を受信するチャネルのタイプを選択します。追加入力フィールドは選択内容によって異なります。

  • Slack：Slack チャンネルに通知を送信します。

  • Agit：Agit に通知を送信します。

  • HTTP: Zapier や Okta Workflows などの HTTP API リクエストを使用します。

  • メール：メールで通知を送信する。

チャネルの種類 Slack

以下はチャンネル作成に必要な入力項目です：

Slackアプリの詳細な設定方法については、ドキュメント下部の「統合のためのSlackアプリ設定」をご参照ください。

• メッセージ送信方法 : メッセージの送信方法です。

  • API : Slack API を使ってメッセージを送信します。

    • APIを選択した場合、New Request Alert（バージョン 10.2.2から利用可能）に担当者を記載することが可能。

    • Bot User OAuth Token : メッセージを送信する Slack アプリの Bot User OAuth Token。

    • Channel ID : メッセージを送信するために Slack アプリが招待されている Slack チャンネル ID。

  • Webhook : Webhook 経由でメッセージを送信する。

    • リクエスト URL（必須） ：リクエストの送信先 URL。

      • Slack アプリで Webhook を設定した後、Webhook の URL 情報をコピー＆ペーストする必要があります。

チャネルの種類アジット

チャンネル作成に必要な入力項目は以下の通りです：

• リクエストURL（必須）：リクエストの送信先 URL。

• Agit チャネル：Agit チャネルに表示する名前を入力します。

チャネルタイプ：HTTP

必須入力フィールドは以下の通りです：

• リクエストURL（必須）：リクエストの送信先 URL。

• リクエスト・ヘッダ（JSON）：必要に応じて、呼び出しのリクエスト・ヘッダを入力します（JSON 形式）。

• 本文テンプレート：リクエスト・ボディ・テンプレート。

  • デフォルト値：{メッセージ}}。

  • アラートで定義されたメッセージの最初と最後に追加したい内容を入力します。

チャネルタイプ：メール

注意

メールタイプのチャネルを作成できるのは、メール送信用の SMTP サーバが QueryPie に登録されている場合のみです。

関連する設定を確認するには、[Admin] > [General] > [System] > [Integration]に移動し、[Email] タイルをクリックします。

必須入力フィールドは以下のとおりです：

• 電子メール受信者（必須）：メール受信者。

  • QueryPie に登録されているユーザを選択でき、そのユーザの登録メールアドレスにメールが送信されます。

• 本文テンプレート：リクエスト本文のテンプレート。

  • デフォルト値：{メッセージ}}。

  • アラートで定義されたメッセージの最初と最後に追加したい内容を入力します。

チャネルの削除

チャンネルを削除するには、「チャンネル」ページの「チャンネル」リストでチェックボックスを使用して希望のチャンネルを選択します。選択すると、「削除」ボタンが表示されます。ボタンをクリックすると、削除確認モーダルが表示されます。OKをクリックして削除を完了します。

Slack との統合

1. Slack アプリの作成

1. https://api.slack.com/apps。

2. Create an Appボタンをクリックします。

3. 画面上で、通知を送信したいアプリ名と Slack ワークスペースを選択する。

4. Create Appをクリックします。

2-1. Webhook タイプを使って統合する

1. アプリページ内のIncoming Webhooksメニューに移動します。

2. Activate Incoming Webhooks オプションを有効にします。

3. 下部にある Add New Webhook to Workspace をクリックします。

4. ワークスペース内でアラートを送信するチャネルを選択し、[許可]ボタンをクリックします。

5. 生成された Webhook URL をコピーし、QueryPie チャネル作成モーダルに貼り付けます。

2-2. APIタイプを使用して統合する

1. 作成したアプリをクリックしてアプリの設定ページに入り、アプリマニフェストメニューに移動します。

2. アプリのページで、AppManifest メニューに移動します。

3. 上部の黄色い通知バーを使用して、[Reinstall your app(Required)] を選択してアプリを再起動します。

4. [Reinstall to {Workspace_name}]ボタンをクリックし、アラートを送信する Slack チャンネルを選択し、[Allow]ボタンをクリックします。

   1. スコープを変更した場合は、この手順を繰り返して変更を適用する必要があります。

5. 選択した Slack チャンネルに移動し、作成したアプリを追加します（アプリが既に追加されている場合、このステップは省略できます）。

6. チャンネル名をクリックしてチャンネル詳細モーダルを開き、モーダルの下部からチャンネル ID をコピーします。コピーしたチャンネル ID を QueryPie チャンネル作成モーダルに貼り付けます。

   

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