Slack アプリを構成

Slack ワークスペースでカスタム OAuth アプリケーションを作成し、Slack スポークで OAuth 2.0 認証を有効にします。

始める前に

必要なロール：admin

このタスクについて

Slack アカウントから、次の手順を完了します。アプリを作成したり、以下の構成の概要に従って既存のアプリを構成することもできます。

手順

1. Slackワークスペースを作成します。
   ワークスペースの作成方法については、「Create a Slack workspace (Slack ワークスペースの作成)」を参照してください。次の画像は、一般的な Slack ワークスペースを示しています。

   

2. Slack API コンソールに移動します。
3. [アプリを作成] をクリックします。
4. [アプリを作成] ウィンドウで、アプリを作成するための最適な方法を選択します。

   

5. 基本情報ページのアプリの認証情報ページから、Slack アプリのクライアント ID、クライアントシークレット、署名シークレットの各値をコピーして記録します。

   

   詳細については、後のステップの 「クライアント ID とクライアントシークレットの取得 」を参照してください。

6. OAuth と権限のページ：
   1. [リダイレクト URL] にServiceNowインスタンス URL を次のフォーマットで指定します：https://<instance-name>.service-now.com/oauth_redirect.do
   2. 次のボットトークンスコープを追加します。
      • channels:history
      • channels:manage
      • channels:read
      • chat:write
      • chat:write.customize
      • groups:read
      • im:read
      • mpim:read
      • groups:history
      • groups:write
      • im:history
      • im:write
      • mpim:history
      • mpim:write
      • users:read
      • users:read.email
      • files:read

      詳細については、「 スコープと権限」を参照してください。

      注:

      ここで説明するスポークの設定手順には、ボットユーザートークンのみが必要です。ボットトークンスコープの使用中は、「ユーザーを作成」および「ユーザーを非アクティブ化」アクションを使用できません。これらのアクションを使用するには、Slack アカウントからユーザートークンを取得する必要があります。
7. スラッシュコマンドのページで、コマンドを作成して次の値を指定します。

   フィールド	値
   コマンド	/now
   要求 URL	https://<instance-name>.service-now.com/api/sn_slack_ah_v2/command_service/<slack-app-name>
   簡単な説明	コマンドに関する説明です。
   使用上のヒント	渡すことができるパラメーターのリストです。たとえば、[operation] [table] です。

   詳細については、「Slash コマンドを作成」の手順を参照してください。

8. インタラクティブ機能とショートカットのページ：
   1. インタラクティブ機能を有効にし、[要求 URL] に ServiceNow インスタンス URL を https://<instance-name>.service-now.com/api/sn_slack_ah_v2/slack/<slack-app-name>/interactivepayload という形式で指定します。
      詳細については、「 ユーザーインタラクションのためのアプリの準備」セクションを参照してください 。
   2. メッセージに表示されるショートカットを作成し、 [コールバック ID] に値 post_message_now を入力します。
      詳細については、「ショートカットを作成」セクションを参照してください。
9. Slack ボットを作成し、ボットを Slack アプリと必要なチャネルに追加します。
   詳細については、「ワークスペース用のボットの作成」を参照してください。