Slack DM連携

Overview

Slack AppをQueryPieに連携し、QueryPieからDirect Message通知を受信できます。

本ドキュメントは10.2.6またはそれ以上のバージョンに適用されます。 10.2.5またはそれ以下のバージョンのSlack連携方法は10.1.0バージョンマニュアルドキュメントを参照してください。

構成時事前に必要な権限

Slack Workspace管理者権限アカウント（Slack WorkspaceにAppをインストールするために必要）
QueryPie OwnerおよびApproval Admin権限アカウント

Slack APIでDM App生成（via Manifest Files）

App Manifestを利用してQueryPie DM連携専用Slack Appを生成します。

https://api.slack.com/apps に移動してCreate an Appをクリックします。

Create an appモーダルで、App生成方式を選択します。From a manifestをクリックします。

Pick a workspaceモーダルでQueryPieと連携するSlack Workspaceを選択した後次の段階に進行します。

Create app from manifestモーダルでJSON形式のApp Manifestを入力します。
事前に埋められている内容を削除し以下のApp Manifestを貼り付けた後次の段階に進行します。
:light_bulb_on: {{..}}内の値は希望する値に変更してください。


{
  "display_information": {
      "name": "{{name}}"
  },
  "features": {
      "bot_user": {
          "display_name": "{{display_name}}",
          "always_online": false
      }
  },
  "oauth_config": {
      "scopes": {
          "bot": [
              "chat:write",
              "users:read.email",
              "users:read"
          ]
      }
  },
  "settings": {
      "interactivity": {
          "is_enabled": true
      },
      "org_deploy_enabled": false,
      "socket_mode_enabled": true,
      "token_rotation_enabled": false
  }
}

設定内容を検討しCreateボタンをクリックしてApp生成を完了します。

Slack WorkspaceにSlack Appインストール

Settings > Install AppでInstall to Workspaceボタンをクリックして生成されたアプリをSlack Workspaceにインストールします。
権限リクエストページで、許可をクリックします。

設定したSlack WorkspaceでSlack DM専用Appが生成されたことを確認できます。

Bot User OAuth Token取得

Features > OAuth & Permissionsメニュー内OAuth Tokens for Your Workspaceセクションで、Bot User OAuth Tokenをコピーして記録しておきます。

App-Level Token生成

App manifestでSlack appを生成する時Socket Modeと関連権限を有効化することはできますが、App Level Token（xapp-）は自動で生成されません。

App Level Tokenはセキュリティ資格証明（security credential）であるためmanifestで自動生成/露出されるとセキュリティ上危険
App manifestはアプリの構成（configuration）のみ定義し、実際の認証トークンは別途生成/管理される

以下の段階を実行してApp-Level Tokenを手動で生成します。

アプリ設定ページのSettings > Basic InformationメニューのApp-Level Tokensセクションに移動し、Generate Token and Scopeボタンをクリックします。

Generate an app-level tokenモーダルで、Add Scopeボタンをクリックした後connections:writeを追加します。

生成されたApp-Level Tokenモーダルで、アプリトークンをコピーして別途記録しておきます。App-Level Tokenはxapp-で始まります。

QueryPieでSlack DM設定

Admin > General > System > Integrations > Slackメニューに進入した後、Configureボタンをクリックして設定モーダルを開きます。

Administrator > General > System > Integrations > Slack > Create a New Slack Configuration

設定モーダルに先ほど記録しておいたApp TokenとBot User OAuth Tokenを入力します。
追加設定値は以下の通りです。DMでWorkflow通知を受けメッセージ内で承認/拒否を実行するにはすべての設定トグルを有効化します。
- Send Workflow Notification via Slack DM : ワークフローリクエストに対するSlack DM送信有効化
- Allow Users to approve or reject on Slack DM : Slack DM内で承認または拒否機能有効化
アクション許容タイプ例（左）/ アクション非許容タイプ例（右）
Saveボタンを押して設定を完了します。