Slack Botの土台をGASで構築

業務効率を上げたり, 時には癒しをくれたり, 調べてみると様々なBotの活用事例があるようです. この記事ではSlackBotの土台となるものをGASで構築していきます.

ゴール

この記事を読んだらなにができるようになるかを述べておきましょう. 本記事におけるBotの土台とは,

Slackで特定のワードを発言すると, Botが反応して一定の返事をくれる

というものです. これだけっちゃこれだけですが, GASを利用しているので, 以下のようなBotに発展させることもできるでしょう.

Googleカレンダーのイベントを教えてくれる
Google翻訳を利用して, 日本語を英訳してくれる.

手順

以下のような手順で進めていきます.

Webhook URLを取得
SlackからPOSTリクエストを受け取り, POSTリクエストを返す機構をGASで構築
SlackからPOSTリクエストを発行するためのトリガーを設定

Webhook URLを取得

Webhook URLというのは, メールアドレスのようなものですね. このURLに対しPOSTリクエストを投げることで, Slackにメッセージを投稿することができます. ではやっていきましょーう.

まずはSlack APIにアクセスしましょう. 右上のCreate New Appをクリックします. そうなんです実は, これからBotをSlackアプリとして作ろうとしているんですね. さてCreate New Appをクリックすると次のようなダイアログが出現します.

f:id:riemann1618:20180928204913p:plain:w500

上の欄には好きなアプリ名を, 下の欄では実験用のWorkspaceを選択しましょう. 注意書きにあるように, アプリ名は後から変えられるので心配いりません.

入力を終えたらCreate Appをクリックします.

すると以下のようなページに飛びます.

f:id:riemann1618:20180928205106p:plain:w500

まずはBotsをクリックし, このアプリがBotとして動作するよう設定します. といっても2つの入力欄を埋め, Always Show My Bot as Onlineをオンにするだけです.

f:id:riemann1618:20180928205817p:plain:w500

この設定を保存したら, 次に左のメニューのIncoming Webhooksをクリックし, トグルをONにします.

f:id:riemann1618:20180928210003p:plain:w500

下の方にいってAdd New Webhook to Workspaceをクリック.

f:id:riemann1618:20180928210058p:plain:w500

Botからの返信を待ち受けるチャンネルをここで選択します. 選択できたらAuthorizeをクリック.

f:id:riemann1618:20180928210439p:plain:w500

するとSuccess!というFlashメッセージとともに, 先のページにリダイレクトされます. 下のほうをみると, Webhookが追加されているのがわかりますね. Webhook URLもちゃんと書いてあります. これで第一段階は終了です.

f:id:riemann1618:20180928210758p:plain:w500

Slackから`POST`リクエストを受け取り, `POST`リクエストを返す機構をGASで構築

さて次はGASです. Google ドライブにアクセスし, GASプロジェクトを新規作成します. プロジェクト名はお好きに決めてください.

f:id:riemann1618:20180928211112p:plain:w500

ここからはコーディングです. GASのベースはJavaScriptですから, メソッド名の最後に()をつけたり, 式をセミコロンで締めくくったり, 気をつけなければならないことがたくさんありますね...

// POSTリクエストを受け取る関数
function doPost(e) {
  
  // Webhook URLを変数に格納
  var url = 'https://hooks.slack.com/services/ほにゃらら';
  
  // メッセージ本文
  var payload = {
    'text': 'ここが本文'
  };

  // HTTPリクエストの設定
  var options = {
    'method': 'post',
    'contentType': 'application/json',
    'payload': JSON.stringify(payload)
  }
  
  // SlackへのPOSTリクエストを発行
  UrlFetchApp.fetch(url,options);
}