はじめに

この記事では ToDo 活用の一環として GAS をつかい、Slack 内から削除されたメッセージを Google スプレッドシートにアーカイブする方法をご紹介します。

背景

僕は自分の ToDo を Slack の自分専用ワークスペース、通称「ぼっち Slack」を作り、そこの IM チャンネル (自分宛ての DM) で管理しています。

方法は、こんな感じでシンプルにやってます。
1. IM チャンネルに ToDo タスクを書く
2. 必要に応じて
- メッセージスレッドで付随的な情報を書く
- 緊急のものはピン留め
- 重要度高めはスターをつける等々
3. タスクが完了したらメッセージを削除

この方法のポイントは、タスクが完了したタイミングでメッセージごと削除してしまいます。たとえば Gmail の受信ボックスって、用が済んだらどんどんアーカイブしていって、受信ボックスが空だと超気持ちいいですよね。ToDo 管理もこのノリでやってまして、チャンネルに入っているメッセージの量 = 自分が抱えているタスクの量と見立てていて、空であれば「超気持ちいい！」というマインドで習慣化しています。

しかしはじめはメッセージ削除でいっかーと思っていたんですが、たまにタスクを復元したい、振り返りたいとおもうシーンがでてきました。当然ですが、メッセージを削除しているので終わったタスクはどこにも残ってません。やっぱり Gmail のように終わったタスクはアーカイブして残しておきたい……。

そこでこのスクリプトを作ってみました。

レシピ

GAS ウェブアプリケーション URL の発行

準備として GAS の新しいプロジェクトを作成し、ウェブアプリケーション URL の発行をおこないます。

Google ドライブから Google スプレッドシートを新規作成し、スクリプトエディターを開きます。

後述する Slack API 側の Event Verification 用に以下のコードを記述します。

VerificationForSlack

function doPost(e) {

  var json  = JSON.parse(e.postData.getDataAsString());

  if (json.type === 'url_verification') {
    return ContentService.createTextOutput(json.challenge);
  }

}

[公開] から [ウェブアプリケーションとして導入] をクリックします。
「アプリケーションにアクセスできるユーザー」を [全員 (匿名ユーザーを含む)] に変更し、[導入] をクリックします。
ウェブアプリケーションの URL が発行されるので、どこかにコピーしておきます。

Slack App の作成

Slack Events API をつかって、メッセージ削除イベント発生時に GAS へ JSON データを送る Slack App を作ります。

Slack API | Slack にアクセスしてビルドを開始します。
新しいアプリを作成します。
[Event Subscriptions] から「Enable Events」を有効にし、「Request URL」に "GAS ウェブアプリケーション URL の発行" の "5." でコピーしておいた Verification 用の URL を入力します。

ここでは Slack API が指定 URL に対して HTTP POST でテストリクエストを投げています。送信先 (今回の場合は GAS) は Slack API へリクエストを投げ返すことで、初回の検証作業を完了することができます。上の画像のように「Verified」の表示がでれば成功です。
同ページ内の「Subscribe to Workspace Events」より [message.im] を登録します。

今回は、IM チャンネルに送信されたメッセージイベントが取れればよいので、登録イベントはこの 1 つのみで OK。DM チャンネル以外の削除メッセージを取りたい場合は、それに応じたイベントを登録する必要があります

GAS でウェブアプリケーションを作る

Slack の IM チャンネル内でメッセージ削除が生じたとき、その日付・メッセージ日付・メッセージ内容をスプレッドシートに保存するスクリプトを GAS で書きます。

以下のコードを "GAS ウェブアプリケーション URL の発行" の "1." で開いたスクリプトエディターに追記します。

SlackToDoArchiveApp

function doPost(e) {
  var json            = JSON.parse(e.postData.getDataAsString());
  var event           = json.event;

  if (!event.subtype) return;
  if (event.subtype !== 'message_deleted') return;  // イベントがメッセージ削除以外の場合は何もしない

  var deleteTs             = json.event.ts ;  // 削除実行時のタイムスタンプ
  var deleteTsDate         = new Date(deleteTs * 1000);

  var deletedMessageTs     = json.event.deleted_ts  // 削除したメッセージの元タイムスタンプ
  var deletedMessageTsDate = new Date(deletedMessageTs * 1000);

  var text                 = event.previous_message.text;  // 削除したメッセージ

  var ss      = SpreadsheetApp.openById('hogehoge'); // Google スプレッドシートの ID (URL の末尾部分)
  var sh      = ss.getSheetByName('hogehoge');  // 入力先シートの名前
  var values  = [deleteTsDate, deletedMessageTsDate, text];

  sh.appendRow(values);
}

保存後は、ふたたびスクリプトエディター画面の上部にある [公開] から [ウェブアプリケーションとして導入] を開き、プロジェクトバージョンの更新作業をおこないます。

このウェブアプリケーションの更新作業は、スクリプトエディターの内容変更のたびに必要になります (よく忘れて動かない)

テスト

Slack の IM チャンネルに ToDo メッセージを入力します。
ToDo が完了したタイミングで該当メッセージを削除します。
Google スプレッドシートへ自動的にアーカイブされます。

まとめ

今回はじめて Slack の Events API を利用してみましたが、リファレンスがわかりやすく、簡単に実装できました。他にも Slack 上で取れるイベント情報は様々あるので、夢が広がりまくりです。

あと、Slack での ToDo 管理ですが、Slack を「ハブ」として日常的に利用しているユーザーさんであれば、とても相性がよいのでおすすめしたいと思います。

・ToDo のためにわざわざ別のアプリーションやウェブ画面を立ち上げなくていい
・Slack 上でのやり取りで ToDo イベントが発生することが多いので、登録効率がよい
・思いついたらサッと登録して、終わったらサっとアーカイブできる操作の軽快さ
・スレッド返信機能の活用とアーカイブで見た目的に散らかりにくい

ToDo は開いたときの文字数 (情報量) が多ければ多いほど開けたときに心理的な抵抗が強くなってくるので、タスクの 散らかりにくさ、そして継続して管理・利用し続ける習慣を身につけることがとくに重要かなと思いました。

また今回は IM チャンネルでの例ですが、パブリックチャンネルを 1 個作り、同じようにチームで ToDo 共有・管理をおこなうといった活用もできます。よかったら試してみてください。

追記

2019/06/25 「削除操作」ではなくて「絵文字リアクション」でアーカイブする新しい記事を投稿しました。

参考

[GAS][Slack App]Outgoing Webhook の代わりとして Slack App... - etau the non programmer coder
message_deleted message event | Slack
Google Apps ScriptでのDateオブジェクトの各生成方法、日付と時刻を分ける - いつも隣にITのお仕事

~ ToDo 活用 ~ GAS をつかって Slack から削除されたメッセージを Google スプレッドシートにアーカイブする

はじめに

背景

レシピ

GAS ウェブ アプリケーション URL の発行

Slack App の作成

GAS でウェブ アプリケーションを作る

テスト

まとめ

追記

参考

GAS ウェブアプリケーション URL の発行

GAS でウェブアプリケーションを作る