Slack連携による生産性向上の施策（その２）〜Slack App編〜

Last updated at 2024-04-26Posted at 2024-04-16

はじめに

こちらの記事は三部構成になっております。

また、全ての記事の内容を含んだ動画も用意しております。
動画で確認したい方はコチラまで。
※動画開始50分頃からの内容になります。

Slack App登録の前に

Slack Appから呼び出されるAPIの準備をします。

Lambda関数作成

AWSのコンソール画面でサービス名に lambda と入力し、サービス一覧から【Lambda】をクリック
AWS Lambdaのサービス画面の【関数の作成】ボタンをクリック
関数名に作成するLambda関数名を入力し、今回はランタイムを【Python 3.11】を選択して【関数の作成】ボタンをクリック
このようにLambda関数が作成されます

API Gatewayの設定

作成されたLambda関数の【トリガーを追加】ボタンをクリック
トリガー追加画面のソースを選択から【API Gateway】を選択、Intentラジオボタンから【Create a new API】を選択、API Typeラジオボタンから【REST API】を選択、Securtyリストボックスから【Open】を選択し【追加】ボタンをクリック
こちらでAPI Gatewayのトリガーが作成されます
トリガーの詳細はこちら、このAPI endpointは後ほど使います
post_question-APIリンクをクリックし、APIの詳細設定を変更します
API Gateway設定画面の右下にある【統合リクエスト】をクリック
画面を下にスクロールすると、統合リクエストの設定があるので【編集】ボタンをクリック
統合リクエストの編集画面の【Lambdaプロキシ統合】のスイッチをOFFに設定し、【保存】ボタンをクリック
統合リクエストの設定内容が変更されているのを確認して、画面右上の【APIをデプロイ】ボタンをクリック
デプロイ画面のステージから【default】を選択し、【デプロイ】ボタンをクリック
デプロイが成功したと表示されたので、これで完了

Lambda関数のコーディング

デフォルトで画面のようなコードが既に作成されております
Slack App作成の際に、APIの認証処理が実行されるので、その認証処理を先に作ります。下記の内容をコードソースに記載します

lambda_function.py

import json

def lambda_handler(event, context):
    # TODO implement
    print(event)
    return {
        'statusCode': 200,
        'body': json.dumps(
            {
                'challenge': event['challenge']
            }
        )
    }

3. コード修正内容を確認して、【Deploy】ボタンをクリック
　

4. これで準備完了です

Slack Appの作り方

初期作成

Slack Appのサイトへアクセスし、【Create an App】ボタンをクリック
App作成画面の【From scratch】をクリック
App NameにSlack App名を入力し、Pick a workspace to develop your app in:にSlack Appを作成するワークスペースを選択し、【Create App】ボタンをクリック
こちらで、Slack Appの基本情報の画面が表示され初期登録が完了です

OAuth & Permissions 設定

今回はSlackからメッセージをAPIに投げるまでの組み込みに必要な最低限の設定を実施します。

基本情報画面の左メニューから OAuth & Permissions リンクをクリック
OAuth & Permissionsの設定画面を下にスクロールし、ScopesのBot Token Scopes設定の【Add an OAuth Scope】ボタンをクリック
OAuth Scopeリストボックスから【channels:history】を選択

Event Subscriptions 設定

基本情報画面の左メニューから Event Subscriptions リンクをクリック
Event Subscriptionsの設定画面の Enable Events スイッチをONに設定
Request URLのテキストにAPI Gatewayの設定で用意したAPI endpointを入力、直後に認証処理が実行されVerifiedと認証OK!の結果が表示される
Event Subscriptionsの設定画面を下へスクロールし、Subscribe to bot eventsの設定を開いて【Add Bot User Event】ボタンをクリックし、表示されたリストボックスへchannelsと入力し、リスト内容から【message.channels】を選択
Event内容が設定されたことを確認し、画面右下にある【Save Changes】ボタンをクリック
こちらで、EventSubscriptionsの設定が完了です