【Notion API】GASでプロパティの変更を検知してSlackに通知する仕組み
コロナ禍以後のオーリーズの働き方
コロナ禍によって、オーリーズの働き方は一変しました。
例えばオフィス通勤だったのがほぼ完全にリモートワーク可能となり、それに対応して通信費やリモートワーク環境構築費(10万円！)の支給など充実した手当も頂いています。
しかし、働くうえで今までと大きく変わってしまったことがあります。
それは猫社員・まる美の存在です。
以前までオフィスを闊歩して（たいてい副社長・誠愛さんのデスクの近くにいましたが）社員に癒しを与えていたまる美ですが、「猫もコロナにかかる」ということで自宅待機となっています。（それってただの飼い猫では？？？）
実際、入社の際に猫が決め手となった方もいるため、まる美が見られない環境というのは、著しく社員の幸福度が下がっている状態と言っても過言ではないでしょう。
※オフィスで働くまる美、リモートワークをするまる美の様子は上のリンクから
Notionページのプロパティ変化のみをbotでSlackに通知する
ということで、まる美に触れ合うことができないという問題を解決すべく「まる美bot」を作成することにしました。オーリーズの社内通知をSlack上のまる美からさせようという取り組みです。Slackとはいえ、まる美の方からコミュニケーションを取ってくれるなんて社員の幸福度が高まることは確実ですね。
そして、今回まる美botから社内に通知するのは「社内向けのナレッジ共有データベースのページ更新通知」にします。
オーリーズではNotionで社内ポータルを構築しているのですが、Notion⇔Slack間の連携機能を使うとNotionの変更すべてがSlackへと送信されてしまい、通知の量が膨大となってしまっています。
本当は社内ポータルの中の社内向けのナレッジ共有データベース内ページのプロパティ変更のみをピックアップして送りたいのですが、Notionの設定ではそのような設定ができません。そのため簡単なプログラムを書いて、それをまる美botと連携させることで対応することにしました。
実装の流れ
上述した内容を実現するために必要なことは大きく分けると以下です。
- Slack用のまる美botを作成する。
- NotionのAPI実行用のインテグレーションを作成する。
- Notionの記事更新を発見するプログラムを作る。（記事には「執筆中」「完了」のステータスがあるため「完了」になったものを検知する。）
- 上のプログラムを定期的に実行する。もしくは記事が公開されたタイミングでプログラム実行を行う。
- 結果をまる美botから送信する。
1、2のSlackBotを作ることはそう難しくはありません。
3、4については、執筆中→完了というステータス変化をどのように検知するのかという点とどこでプログラムを実行するのかという点が重要になってきます。
GAS(Google Apps Script)の活用
今回は以下の理由からGAS(Google Apps Script)で実行することにします。
- 実行環境を用意することなく1時間おきにスクリプト実行ができる。
- 記事のステータスを管理しておくためにスプレッドシートが利用できる。
- 他のGoogleサービスとの連携が容易である。
記事を完成してすぐに通知を送らずとも、多少のタイムラグがあって通知が来ても問題ないでしょう(1時間おきの巡回で十分)。
また、「執筆中」⇒「完了」のステータス変化を捕捉するために前回の実行結果をスプレッドシートに保存しておけるのは理想的な環境です。Google連携サービスは今後のまる美botの機能追加で利用します。
具体的な実装
では、具体的な実装を見てみましょう。
※今回の記事ではSlackアプリの作成やNotionAPI用のインテグレーションの設定についての説明は行いません。（探せばすぐに出てくると思いますので、認証用のトークンは取得できている前提で話します。）
①のNotionAPIを実行については、NotionのAPIを用いてデータベースで管理されているページ一覧の情報を取得しましょう。
getNotionDataメソッド内のアクセストークンを設定し、データベースidを引数に渡せばデータベースの情報をjson形式で取得することができます。
（トークンはPropertiesService.getScriptProperties().getProperty("hogehoge")などで実装してもらえると理想的だと思います。）
②では①で受信したjsonの情報を整形します。③④で得られる前回実行時のデータ(SpreadSheet)の情報との比較となるので、必要な項目のみを配列形式で保持しましょう。
announceメソッド内に追記します。
③④のspreadsheetの情報の取得については、以下のスクリプトでスプレッドシートの情報を取得することができます。（announceメソッドに追記します。）
⑤でNotionからAPIで得られたデータとSpreadSheetの情報を比較するのですが、一度ステータスが完了になったページについては再公開された際に通知を行う必要はないので、完了になったページが執筆中に戻ったときにはSpreadSheet上のステータスを「執筆中(一度公開済み)」とすることで再通知を防ぐ仕組みを作ります。
データの更新はAPIで取得したデータで基本的に上書きするため、SpreadSheetの情報を全部消したうえでAPIで取得したデータを書き込むことで更新を行います。
ただし、上記のような「執筆中(一度公開済み)」のようなステータスを加えなければならないので、必要に応じてAPIで取得したデータを修正しておきます。
最終的にページを比較する上でのロジックは以下となりました。
- APIで取得したページのステータスが「執筆中」である際に、前回のステータスに「完了」もしくは「公開」の文字列が含まれている際は「執筆中(一度公開済み)」とする。
- APIで取得したページのステータスが「完了」である際に、前回の実行結果が「執筆中」もしくは「ページがない」状態であれば、後の処理で利用する通知用の配列(toAnnounce)に追加する。
（以下をannounceメソッドに追記します。）
⑥⑦シートの更新とslackへの通知を行います。（以下をannounceメソッドに追記します。）
データは全部上書きなので一旦2行目以降をすべてクリアしてから貼り付けを行います。
こちらはannounceメソッド外に加えます。
あとはこのスクリプトをGASのトリガー設定で一時間おきに実行するだけです！
- スクリプト全体
