こんにちは。RYOです!!

2022年4月から新卒入社したのですが、あっという間に3ヶ月経ってもう夏になっちゃいましたね。。

最近は暑くて溶けそうです笑笑

以前にインターン時代にもこちらのブログを投稿させていただきましたが、今回のブログは「Googleカレンダーの予定を教えてくれるSlackスラッシュコマンドを作成して見た」です!
社内ではSlackを頻繁に使うので、Slack内で自分の予定が見れたら便利でいいなと思い、今回作ってみることにしました。

 

使用したツール

  • GAS(Google Apps Script)
  • SlackApp
  • Slack

 

学べること

  • SlackApp作成方法&設定方法
  • GASの書き方&デプロイ方法
  • Slackスラッシュコマンド

 

1.SlackApp作成

初めにSlackAppの作成からしていきます。

https://api.slack.com/apps

上記のリンクに遷移します。

 

SlackApp作成画面

 

 

Create New Appをクリックします。

 

SlackのCreate an app画面。アプリの作り方として「From scratch」を選ぶ箇所を赤枠で示している

 

 

From scratchをクリックします。

 

Slackのアプリ作成画面。App Nameに「スクジュールくん」と入力し、開発するワークスペースを選んでCreate Appを押す

 

続いて、AppNameに好きなアプリの名前を入力します。

そしてSlackAppを追加したいワークスペースを追加して、Create Appをクリックです。

 

作成したSlackアプリのBasic Information画面。左に設定メニュー、右にアプリの追加機能やインストールの項目が並ぶ

 

Basic Information画面に遷移してれば、一旦完了です!!

 

2.Google Apps Script 作成

https://script.google.com/home

上記のリンクからGASのホームに遷移します。

Google Apps Scriptのプロジェクト一覧画面。左上の「新しいプロジェクト」ボタンを赤枠で示している

 

 

「新しいプロジェクト」をクリックします。

 

Google Apps Scriptのエディタ。Googleカレンダーから当日の予定を取得してSlackに返すコードを書いた画面

 

 

コード.gsに下記のコードを追記します。

function doPost(e) { //①
    var email = "hogehoge@hugahuga.co.jp";
    var scheduleList = "";
    scheduleList = scheduleListup(email); // GoogleカレンダーID(メールアドレス)
    if (scheduleList != "") {
        var response = {
            text: "お仕事お疲れ様です!!:man-bowing:\n本日のご予定をお知らせします!:chatwork_roger:\n\n▼本日の予定\n\n" + scheduleList
        };
        console.log(response.text)
        return ContentService.createTextOutput(JSON.stringify(response)).setMimeType(ContentService.MimeType.JSON);
    }
}

function scheduleListup(googleId) { //②
    var list = "";
    var calendar = CalendarApp.getCalendarById(googleId);
    var today = new Date();
    today.setDate(today.getDate());
    var events = calendar.getEventsForDay(today);
    var prefix = "・";
    for (var i = 0; i < events.length; i++) {
        var task = "";
        var startTime = formatTime(events[i].getStartTime());
        var endTime = formatTime(events[i].getEndTime());
        task = prefix + events[i].getTitle();
        list += startTime + "~" + endTime + "" + task + "\n";
    }
    return list;
}

function formatTime(date) {
    return Utilities.formatDate(date, 'JST', 'HH:mm');
}

コード①

doPost(e)

スラッシュコマンドを実行した時に呼ばれるメソッドになります。
引数のeの中にはパラメータが入っているので、スラッシュコマンドに引数を設定するなどに使えます。

 

ContentService.createTextOutput

GASが用意してくれているメソッドで、テキストを返してくれます。
今回は、「お仕事お疲れ様です」の部分のテキストになります。

 

コード②

CalendarApp.getCalendarById

GoogleカレンダーのアカウントIDを指定すると、そのアカウントのカレンダー情報を取得することができます。

 

getEventsForDay(date)

特定の日に発生するすべてのイベントを取得します。

 

3.Google App Scriptコードをデプロイ

先ほど書いたコードをデプロイしていきます。

Google Apps Scriptのエディタで、右上の「デプロイ」メニューから「新しいデプロイ」を選ぶ箇所を赤枠で示している

 

右上のデプロイから「新しいデプロイ」を選択します。

Google Apps Scriptの新しいデプロイ画面。種類の選択の歯車アイコンから「ウェブアプリ」を選ぶ手順

 

「新しいデプロイ」画面に遷移したら、種類の選択から「ウェブアプリ」を選択します。

新しい説明文・次のユーザーとして実行・アクセスできるユーザーを順に設定。

⚠️注意 必ず、アクセスできるユーザーを全員にしてください。

全て入力できたら、「デプロイ」をクリックします。

 

新しいデプロイ画面で「アクセスを承認」ボタンを押し、ウェブアプリのデータへのアクセスを許可する手順

 

Googleカレンダーのアクセスを許可する必要があるので、「アクセスを承認」をクリックしてアクセスを許可してください。

 

デプロイの完了画面。デプロイIDとウェブアプリのURLが発行され、コピーできる(IDとURLは塗りつぶし済み)

 

アクセス承認後は、デプロイが完了するのでウェブアプリのURLをコピーしておきましょう!

これでデプロイは無事に完了しました!

 

4.SlackAppスラッシュコマンド設定

1.SlackApp作成のBasic Information画面に戻ります。

Slack APIの設定画面。左メニューのSlash Commandsを開き「Create New Command」ボタンを押す箇所を示している

 

Slash Commandsメニューを選択し、Create New Commandをクリックします。

SlackのCreate New Command画面。コマンド/scheduleKun、Request URLにGASのURL、短い説明を入力した設定例

Command 実際にSlackでコマンド入力するときの設定を入力
Google Apps Scriptでデプロイした際のウェブアプリURLを入力
Short Description 説明を入力

 

入力できたら、Saveをクリックして完了です!

 

5.Botの設定

Botの設定をしておかないと、ワークスペースと紐付けできないので必須の作業になります。

SlackアプリのManage Distribution画面。機能の一覧の中のBotsを赤枠で示している

 

App Manifestメニューから「Bot」を選択します。

SlackアプリのApp Home画面。アプリの表示名を編集するEditボタンや、ボットを常にオンライン表示する設定が並ぶ

 

アプリ名を実際につけていきます。

Edit App Display Name画面。ボットの表示名とデフォルトのユーザー名に「Schedulekun」を入力する

 

アプリ名をつけたら、Saveを押しましょう!

App Home画面で「Always Show My Bot as Online」のスイッチをオンにする箇所を矢印で示している

こちらのチェックも忘れずに!

 

以上でBotの設定が終わりました。

最後にワークスペースにSlackAppをインストールする作業です!

 

Botの設定は終わりましたが、一応確認事項で、

App Manifest メニューから下記のコードになっているか確認お願いします!!

 

display_information:
  name: スケジュールくん
features:
  bot_user:
    display_name: Schedulekun
    always_online: true
  slash_commands:
    - command: /schedulekun
      url: https://script.google.com/macros/s/hogehoge // デプロイのURL
      description: Googleカレンダーの予定を教えてくれます。
      should_escape: false
oauth_config:
  scopes:
    bot:
      - commands
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

 

6.SlackAppをワークスペースにインストール

いよいよスラッシュコマンドが使える時が来ましたね!!

Slack APIのInstall App画面。「Install to Workspace」ボタンを赤枠で示している

Install Appメニューから Install to Workspaceをクリックします。

スクジュールくんがbravesoftのSlackワークスペースへのアクセス権限をリクエストする画面。「許可する」ボタンを赤枠で示している

アクセス権限を許可します。

これでワークスペースにインストール完了しました!!

実際にスラッシュコマンドをワークスペースで入力できるようになったので

お好きなチャンネルに「スケジュールくん」Appを追加していきます。

 

7.SlackAppをチャンネルに追加

Slackの画面になります。

Slackのサイドバーで「その他」メニューを開き「App」を選ぶ画面

 

Slack画面の左上の「その他」からAppを選択します!

 

 

SlackのApp画面で「スケジュールくん」を検索し、作成したアプリを赤枠で示している

 

検索バーで「スケジュールくん」を検索して、先ほどインストールしたSlackAppを選択しましょう!

 

 

SlackでSchedulekunとのダイレクトメッセージを開き、画面左上のアプリ名を矢印で示している

 

 

左上の「Schedulekun」を選択します!

 

Schedulekunのアプリ詳細。「チャンネルにこのアプリを追加する」と「設定」のメニューが表示されている

 

 

「チャンネルにこのアプリを追加する」をクリックします。

 

チャンネルにSchedulekunを追加するダイアログ。テスト用チャンネルを選び「追加」ボタンを押す

 

お好きなチャンネルを選択して、追加をクリックします。

今回は、スケジュールくんテストチャンネルを作成したのでこちらを選択していきます。

 

8.スラッシュコマンド実行

では実際に実行してみましょう!!

Slackのメッセージ入力欄に「/」を入力し、候補に表示された/schedulekunコマンドを選ぶ画面

Slackのメッセージ入力欄に、「/」スラッシュを入力するとコマンド一覧が出てきます。

 

スケジュールくんを選択します。そして送信ボタンを押してみましょう!!

 

スラッシュコマンドの実行結果。スケジュールくんが本日の予定を時刻と予定名の一覧で知らせている

 

無事にスラッシュコマンドが実行されました!

 

終わりに

どうでしょうか?スケジュールくんが実行されたかと思います!!

こんな感じで、GAS✖︎SlackAppを使用してSlackスラッシュコマンドを作成してみました。

とても便利なツールなので使いこなしていきましょう!