はじめに

この記事では、ToDo 活用の一環としまして、Slack メッセージに特定の絵文字リアクションをつけたタイミングで、対象メッセージを Google スプレッドシートにアーカイブし、Slack から削除する Google Apps Script (以下 GAS) レシピをご紹介します。

背景

前回の記事 (削除操作でメッセージをアーカイブ) を読んでいただいた上司から、こんな素敵アイデアが。

たしかに「削除」操作ではなく「特定の絵文字リアクション」操作で対象のメッセージをアーカイブできれば

意図して削除したメッセージはアーカイブされない
削除の場合 3 クリックを要するところ、絵文字リアクションならわずか 2 クリックで済む
削除よりも絵文字リアクションのほうがアーカイブ操作感ある (気持ちいい ← 重要

と、どう考えても削除操作よりイケてますので、早速 ~~パクらせてもらお~~ アイデア活用させていただきました。

レシピ

ステップ

前回記事の「GAS ウェブアプリケーション URL の発行」と「Slack App の作成」からの続きとなります。以下のかんたんな 3 ステップで、絵文字リアクションによるアーカイブを実現する、GAS Web アプリケーションを作っていこうと思います。

Slack Events API を使い絵文字リアクションイベントを取得・判定
対象メッセージを Google スプレッドシートにアーカイブする
Slack Web API を使って対象メッセージを削除する

下準備

上述の機能を実装するため前回作成した Slack App「ToDoArchive」に対して、あらためて必要な Event と Scope の設定をおこなっていきます。まずは Your Apps にアクセスして前回作成した Slack App「ToDoArchive」の設定画面にはいります。

Event Subscriptions

公式リファレンス Events API を見ながら、取得したいイベントを設定します。今回は「絵文字リアクションが使用された」というイベントのみが取れればよいので、イベント名「reaction_added」を登録します。これにより、Slack 内で絵文字リアクションイベントが発生するたびに GAS へ POST リクエストが届くようになります。

Scopes

次に GAS から「①絵文字リアクションを取得する」「②IM チャンネル内のメッセージを取得する」「③メッセージを削除する」の 3 つがおこなえるよう、スコープ設定 (権限の範囲設定) をおこないます。それぞれ必要なスコープ名は以下のとおりです。

① Access the workspace’s emoji reaction history (reactions:read)
② Access content in user’s direct messages (im:history)
③ Send messages as user (chat:write:user)

「①絵文字リアクションを取得する」 reactions:read は前項のイベント「reaction_added」登録時点で自動的にスコープ設定をしてくれています。よって、実際に追加設定するのは im:history と chat:write:user の 2 点で OK.

今回は IM チャンネル (自分宛ての DM) のみをターゲットとしているため im:history を設定しています。パブリックチャンネルで実装したい場合は channels:history, プライベートチャンネルの場合は groups:history でいけると思います。

取得しておく情報

最後に「OAuth Access Token」と「Channel ID」を取得しておきます。あとで使うので、どっかにコピーしといてください。

< OAuth Access Token >
同「OAuth & Permissions」ページ内で取得します。

< Channel ID >
Slack を開き、チャンネル名を右クリックして [コピー] します。

そしてどっかに貼り付けて確認できる以下 URL の

https://[ワークスペース名].slack.com/messages/[ここの部分]

が ID に該当します。

以上で準備完了です。
次は GAS で Web アプリケーションを作っていきましょう。

1. 絵文字リアクションの判定

はじめに絵文字リアクションイベントが届いた際、特定の絵文字以外はスルーするコードを書きます。

特定の絵文字を何にするか決めましょう。絵文字名称は Slack 内で確認ができます。
僕は ToDo を 爆発させたい ので、迷わず boom を選択します。

以下のコードで絵文字の種類を判定します。

hasSpecificEmojiReaction

  /* 絵文字リアクション "boom" が押された場合にのみ実行 */
  var json  = JSON.parse(e.postData.getDataAsString());
  var event = json.event;
  if (!event.reaction) return;
  if (event.reaction !== 'boom') return;

2. Google スプレッドシートへアーカイブ

続いて絵文字リアクションが付いたメッセージ (とその日時情報) を、GAS にコンテナバインドされている Google スプレッドシートにアーカイブするコードを書いていきます。

GAS の [プロジェクトのプロパティ] を開きます。
[スクリプトのプロパティ] タブより「SLACK_CHANNEL」と「SLACK_ACCESS_TOKEN」というプロパティを追加し、取得しておく情報でとったそれぞれの値を貼り付けます。

以下のコードを書きます。

archiveMessageToSs

  /* プロパティ ストアよりトークン・チャンネル情報を読み込む */
  var token   = PropertiesService.getScriptProperties().getProperty('SLACK_ACCESS_TOKEN');
  var channel = PropertiesService.getScriptProperties().getProperty('SLACK_CHANNEL');

   /* 絵文字リアクションのついたメッセージをスプレッドシートにアーカイブする */
   var imHistoryUrl   = 'https://slack.com/api/im.history';
   var messageTs      = event.item.ts;  // リアクションが押されたメッセージのタイムスタンプ
   var messageTsDate  = new Date(messageTs * 1000);
   var reactionTs     = event.event_ts;  // リアクション押下時のタイムスタンプ
   var reactionTsDate = new Date(reactionTs * 1000);

   var payload = {
     token    : token,
     channel  : channel, 
     oldest   : messageTs,
     latest   : messageTs,
     inclusive: true,
   };

   var options = {
     method     :'post',
     contentType:'application/x-www-form-urlencoded',
     payload    : payload
   };

   var response    = UrlFetchApp.fetch(imHistoryUrl, options);
   var contentText = JSON.parse(response.getContentText());

   var messageText = contentText.messages[0].text;
   var array       = [reactionTsDate, messageTsDate, messageText];

   var ss          = SpreadsheetApp.openById('hogehoge'); // Google スプレッドシートの ID (URL の末尾部分)
   var sh          = ss.getSheetByName('fugafuga');  // 入力先シートの名前
   sh.appendRow(array);

Slack 上のすべてのメッセージにはユニーク ID としてタイムスタンプが付いています。Events API でポストされた JSON データより、絵文字リアクションがついたメッセージを確認すると対象のタイムスタンプ情報を取得することができます。そこで Web API メソッド im.history を使って絵文字リアクションがついたメッセージのテキストデータをタイムスタンプで検索・取得しています。

変数 imHistoryUrl の URL は IM チャンネル用です。別の種類のチャンネルで実装したい場合は種類に応じて、Scopes と URL 変更が必要です。

パブリックチャンネル: https://slack.com/api/channels.history
プライベートチャンネル: https://slack.com/api/groups.history

3. メッセージを削除

対象メッセージを削除するコードを書いて完成です。こちらも、前回取得したメッセージのタイムスタンプ情報を使い、削除対象となるメッセージを特定しています。

deleteMessage

  /* 対象メッセージを削除する */
  var chatDeleteUrl = 'https://slack.com/api/chat.delete';

  var payload = {
    token  : token,
    channel: channel, 
    ts     : messageTs,
  };

  var options = {
    method     :'post',
    contentType:'application/x-www-form-urlencoded',
    payload    : payload
  };

  UrlFetchApp.fetch(chatDeleteUrl, options);