GASでSlackAPIが使えるライブラリを使ってみた(SlackApp)

今回は、Google Apps Script (GAS) でSlackのAPIが簡単に取り扱えるライブラリの紹介です。

ここでは、SlackにインストールしたBotからメッセージを通知するものを作ります。

Slackの設定
GASの設定
動作確認

Slackの設定

Appの作成

Slack API のページを開く

Slack API: Applications | Slack

api.slack.com

「①Create New App」→「②From scratch」をクリック

「App Name」にはアプリ名(表示名、後で変更可)
その下はAppを導入するワークスペースを選択

スコープの設定

Basic Infomation (最初の画面) にある「①Add features and functionality」→「②Permissions」をクリック

Scopes の項目で「Add an OAuth Scope」をクリック
ここでは、このApp(Bot)がアクセスできる操作を指定する。
※「Bot Token Scopes」と「User Token Scopes」の２つあるが、今回は前者を使用

「chat:write」と「chat:write.public」をクリック
※「chat:write.public」を有効にすると、Botがチャンネルに参加していなくてもメッセージが送信できる。

Botの設定

Basic Infomation (最初の画面) にある「①Add features and functionality」→「③Bots」をクリック

Your App’s Presence in Slack の項目にある App Display Name の「Edit」をクリック

Display Name：表示されるBot名
Default username：Slackで参照する際に使用される名前

AppをSlackにインストール

Basic Infomation (最初の画面) にある「①Install your app」→「②Install to Workspace」をクリック

アプリがSlackにアクセスする権限をリクエストしてくるので、「許可する」をクリック

「～～にはインストールするボットユーザーがありません」

このような画面が出る場合は、Botの設定で Display Name を設定できていない可能性があります。

Tokenを確認

Basic Infomation (最初の画面) にある「①Add features and functionality」→「②Permissions」
「Bot User OAuth Token」に記載されているものが Token です。後ほどGASで設定するので、コピーしておく。

GASの設定

ライブラリ(SlackApp)の追加

①GASの左側にあるライブラリの”＋” をクリック

②以下のスプリクトIDを入力し、「検索」をクリック

1on93YOYfSmV92R5q59NpKmsyWIQD8qnoLYk-gkQBI92C58SPyA2x1-bq

IDの欄に「SlackApp」が表示されたら「追加」をクリック

Slackに通知するプログラム

「funcion MyFunction()~~」と書かれている部分をすべて消して、以下のプログラムを記述

function sendSlack() {
  const slackApp = SlackApp.create("{xoxb-xxxxxx}"); #SlackAppで取得したToken
  const channelId = "{Cxxxxxxxx}"; #投稿するchannelID
  //or const channelId = "#general";
  const text = "Hello World"; #投稿するメッセージ
  slackApp.postMessage(channelId, text);
}

コードは以下の通り修正する