[2020-05-24-1] の Android 版です。

[2020-07-14-1] に書いたとおり、iPhone から Android に乗り換えました。そうなると、勤怠関係の iOS ショートカットも移植しないといけません(よね?)

Android には同じ機能はなさそうでしたが、ちょっと調べたら HTTP Shortcuts というアプリを見つけました。ほぼ同等の機能で移植できましたので、ご紹介します。

使い方

アプリ内にこのようにショートカットを作りました。各ショートカットはホームに配置することは出来ますが、誤タップを避けるためにこうしました。

ウィジェット

使用感はこんな感じです。誤タップすると面倒なので、すべて確認ダイアログを出しています。

ショートカット構成

動作確認しやすくするために、ショートカットをモジュール化しています。

目次1

目次2

①②③④が直接呼ぶショートカットは以下のとおりです。

① = ⑨ → ⑤
② = ⑥
③ = ⑦ → ⑧ → ⑨
④ = ⑨

① 出勤

長押しして Edit を表示した画面です。

① 出勤

Trigger Shortcurts をクリックすると、前述の通り「⑨ /jobcan_touch」 → 「⑤ slack status 出勤」の順に実行するショートカットだと分かります。

① 出勤 > Trigger Shortcurts

Require confirmation before execution にチェックを入れて、実行前に確認ダイアログを出すようにしています。

Require confirmation before execution

実行された様子。ずっと「仕事開始」も変なので、この Status は 30 分で消えるようにしています(後述)。

打刻&仕事開始

② ランチ

長押しして Edit を表示した画面です。

② ランチ

Trigger Shortcurts をクリックすると、前述の通り「⑥ slack status ランチ」だけを実行するショートカットだと分かります。

② ランチ > Trigger Shortcurts

このショートカットも Require confirmation before execution にチェックを入れています。

「⑥ slack status ランチ」は Slack status に絵文字「昼」を 60 分後に消えるようにセットします(後述)。それとなく伝えるためで、mention などを拒絶しているわけではありません。(^^)

ランチ

iOS ショートカットではタイマーも設定していましたが、HTTP Shortcuts アプリでは設定できないので、必要な時は Google Home を使っています。

Google が最近リリースした Action Blocks アプリ から HTTP Shortcuts アプリを呼べば、出来るのかもしれません。

③ 退勤

長押しして Edit を表示した画面です。

③ 退勤

Trigger Shortcurts をクリックすると、前述の通り「⑦ slack status 退勤」 → 「⑧ slack status DND」 → 「⑨ /jobcan_touch」の順に実行するショートカットだと分かります。

③ 退勤 > Trigger Shortcurts

⑦で Slack status を「退」という絵文字にします。次回の出社まで「退」も変なので、この Status は 3 時間で消えるようにしています(後述)。

退勤

加えて、⑧で DND (Do Not Disturb) に設定しています。

DND

現在はアラートが Slack 通知される業務には就いていないことと、リモートワークでメリハリをつけるために、DND を設定しています。

公式ヘルプ: おやすみモードによる通知の一時停止|Slack

④ 中抜け

通院等で中抜けをすることがあるので、登録しました。「⑨ /jobcan_touch」をラッピングしただけのショートカットですが、アイコンが直感的で気に入っています。

長押しして Edit を表示した画面です。

④ 中抜け

Trigger Shortcurts をクリックすると、前述の通り「⑨ /jobcan_touch」だけを実行するショートカットだと分かります。

④ 中抜け > Trigger Shortcurts

⑤ slack status 出勤

Slack API users.profile.set を呼ぶショートカットです。

⑤ slack status 出勤
※ POST 先サブドメインは会社の Slack workspace 名である feedforce.slack.com にしていますが、slack.com でも良いみたいです。

Request Body / Parameters をクリックした画面です。

⑤ slack status 出勤 > Request Body / Parameters

token は Slack App の OAuth Access Token です。User Token Scopes に users.profile:write を設定すれば OK です。

Slack には GitHub のような personal access token は存在しないため、面倒ですが、専用の Slack App を作って token を発行します。公式ドキュメント は Slack App の作り方が書いてありオーバーなので、Slack API 推奨Tokenについて - Qiita などを参考にすると良いかもしれません。

profile は JSON です。

{
  "status_emoji": ":start_work:",
  "status_text": "出勤しました",
  "status_expiration": {statusExpiration}
}

{statusExpiration} は HTTP Shortcuts アプリで使えるグローバル変数です。トップ右上の {} から設定します。今回はこのように設定しました。

HTTP Shortcuts Variables
{numMinutes} は「⑧ slack status DND」で使用します。

{statusExpiration}Scripting の Run before Execution で代入しています。Slack API を呼ぶ前に実行されます。

そう! HTTP Shortcuts アプリは JavaScript が使えるのです。iOS ショートカットでは使えないため、かなりの工夫が必要でしたので、これはうれしいです。さすが Android!?

{statusExpiration} に 30 分後の Unix 時間を代入しています。

⑤ slack status 出勤 > Scripting

const date = new Date;
date.setMinutes(date.getMinutes() + 30);
setVariable("statusExpiration", parseInt(date.getTime() / 1000));

⑥ slack status ランチ

「⑤ slack status 出勤」とだいたい同じなので、画像とコードだけ貼っておきます。

⑥ slack status ランチ

⑥ slack status ランチ > Request Body / Parameters

{
  "status_emoji": ":lunch:",
  "status_text": "",
  "status_expiration": {statusExpiration}
}

{statusExpiration} に 1 時間後の Unix 時間を代入しています。

⑥ slack status ランチ > Scripting

const date = new Date;
date.setHours(date.getHours() + 1);
setVariable("statusExpiration", parseInt(date.getTime() / 1000));

⑦ slack status 退勤

これもだいたい同じなので、画像とコードを貼っておきます。

⑦ slack status 退勤

⑦ slack status 退勤 > Request Body / Parameters

{
  "status_emoji": ":taisya:",
  "status_text": "private time",
  "status_expiration": {statusExpiration}
}

{statusExpiration} に 3 時間後の Unix 時間を代入しています。

⑦ slack status 退勤 > Scripting

const date = new Date;
date.setHours(date.getHours() + 3);
setVariable("statusExpiration", parseInt(date.getTime() / 1000));

⑧ slack status DND

Slack API dnd.setSnooze を呼ぶショートカットです。

⑧ slack status DND

Request Body / Parameters をクリックした画面です。

⑧ slack status DND > Request Body / Parameters

{numMinutes} には DND を続ける時間を分で設定します。

「翌営業日」の AM9:00 まで DND にしているので、金曜日の時だけ挙動を変えています。

⑧ slack status DND > Scripting

const now = new Date;
const dateOffset = (now.getDay() == 5) ? 3 : 1;
const date = new Date;
date.setDate(date.getDate() + dateOffset);
date.setHours(9);
date.setMinutes(0);
date.setSeconds(0);
date.setMilliseconds(0);
setVariable("numMinutes", parseInt((date - now) / 60 / 1000) + 1);

⑨ /jobcan_touch

Slack API chat.command を呼ぶショートカットです。

⑨ /jobcan_touch

とは言ったものの、chat.command のドキュメントはありません。Slack API Reference のリポジトリに定義がある ので、それを参考にしました。

おまけに chat.command に相当する Scope はないため、Slack App の OAuth Access Token は使えず、Legacy Token を使うしかありません。この Token は全ての Scope を持つため、取り扱いには十分な注意が必要です。
https://api.slack.com/legacy/custom-integrations/legacy-tokens#legacy-info

さらには、最近は新規作成はできず、作り直ししかできないので、過去に発行したことがある workspace にしか Legacy Token は存在しないことになります。闇。

https://github.com/ErikKalkoken/slackApiDoc/issues/22 でもそんな話がありましたが、その後進展はないようです。

Request Body / Parameters をクリックした画面です。

⑨ /jobcan_touch > Request Body / Parameters

token は前述のとおり、Slack の Legacy Token です。

channel は /jobcan_touch したい channel の ID です。その channel で任意のメッセージ link をコピーすると、channel ID が含まれているので、それを使います。

例えば https://example.slack.com/archives/C01AY7YDW/p1234567890000000 だったら、channel ID は C01AY7YDW です。

command はそのまんまです。

「/jobcan_touch おはようございます。」にしたい場合は、新規パラメータ text を追加し、値に「おはようございます。」と書きます。

まとめ

Android の HTTP Shortcuts アプリを使って、Slack status 変更と勤怠打刻をいい感じにするための、さらなる惜しまぬ努力についてまとめました。参考になれば幸いです。

おまけ: /jobcan_touch での mention がウザい件

2 回 mention が来るのはウザいと思ってました。

打刻時の mention がウザい

最近の私はチーム開発をしていないため、#dev-null という、私含めて誰も Join していない channel を作って、そこに向かって /jobcan_touch しています。少しディストピア感があります。

おまけ: その他の Slack status 変更方法

最近は Google Calendar App で会議中の時は In a meeting という Slack status に変えてます。
https://slack.com/app-pages/google-calendar

この App は Slack status が空の時だけセットします。iOS ショートカットで Slack status に expire を指定しているのは、この理由もあります。

以前はこの Google Apps Script を使っていましたが、毎分セットされる関係で、今回の iOS ショートカットと相性が悪いので使わなくなりました。コードを変更すればかなり柔軟性はあるので、合う人は合うと思います。
https://github.com/masutaka/imananishiton