5分でできる！GoogleForm→Slackへの通知設定 #GoogleAppsScript

どうもこんにちは。

突然ですが皆さんSlackのリリースノートって知ってますか？

先日、社内勉強会での雑談中にリリースノートのことを知り、見てみたら面白かったので共有します。

3.56（2018年11月5日）
アプリの使用中にも通知を受信できるようになりました。これでチャンネルをチェック中に DM が届いた場合でも、見逃すことがありません。でも、チャンネルを見ている間は「スッコココ」はいらない！という方のために、通知設定メニューの「アプリ内通知…」からオフにすることもできますので、ご安心を。いろいろ試して、自分好みの通知設定をみつけてみてくださいね。

22.08.50（2022年8月29日）
修正 : ニックネームで呼び合うと距離が縮まりますが、相手のフルネームをまったく知らないのも困りもの。そこで Slack では、プロフィール写真の上に氏名が必ず表示されるようになりました。これで普段ジャイアンと呼んでいる相手も、改まった場面では剛田武さんと呼べますね。

21.12.10（2021年12月6日）
修正 : メンバーが 2 人しかいないチャンネルからの通知を届ける際、アプリがちょっと気を抜いたのかチャンネル名の表示を飛ばしてしまっていました。これを修正したので、今後は通知されたメッセージが「#あなたと私」や「#ふたりきり」のチャンネルからでもすぐにそうとわかるでしょう。

という感じでユーモアに溢れる文章が並んでいます。
皆さんも気になったらぜひ読んでみてください！
https://slack.com/intl/ja-jp/release-notes/ios
（Slackの通知音は「 スッコココ 」が正解だったんだ・・・）

もうお気づきかと思いますが、導入長すぎ！！
早速ですが、今回はSlackにまつわるTipsを紹介したいと思います！

「 5分でできる！GoogleForm→Slackへの通知設定！！！ 」

では見ていきましょう。

活用場面

効率的に通知ができるため以下のような場面で使われます。

テンプレートを決めて通知したい時

あらかじめメッセージのフォーマットを決めておきたい時に最適です。Googleのフォームに沿って回答すれば、誰でも同じ形式でメッセージを送ることが可能です。
私の会社では勤怠報告などで使っています。

データとして残して通知したい時

GoogleFormでは回答をデータとして残すことができます。結果をスプレッドシートなどに書き出せば、そこからデータの整形をすることも可能です。
ただ通知するだけではなく、その後データとして何かに活用したい場合は適していると言えるでしょう。

Slackの設定

１. 権限設定の確認

設定をするにあたって「ワークスペースの管理者」以上の権限が必要です。
必要な権限が設定されているか確認しましょう。

２. Slack通知用のアプリ（Incoming Webhook）を追加

Slackアプリ > 「その他」 > App を選択

Incoming Webhookを追加 >（遷移後のページで）Slackに追加

通知チャンネルを選択 > 「Incoming WebHooks インテグレーションの追加」をクリック

３. Webhook URLをコピー

後ほどGoogleFormの設定で使用するためWebhook URLをどこかにメモしておきましょう

Googleフォームの設定

１. 権限設定の確認

Slackと同様にGoogleFormでも編集者以上の権限が必要です。
必要な権限が設定されているか確認しましょう。

２. スクリプトエディタにGASを記述

Googleフォーム右上のメニューから「<>スクリプトエディタ」を選択

以下をコピー
先程メモしたWebhook URLを記述するのをお忘れなく！

function onFormSubmit(event) {
　　var message = "<!here>" + " 新しい申請があります" + "\n";

　　//フォームの回答を取得
　　var items = event.response.getItemResponses();

　　//フォームの質問文と回答をmessageに一つずつ格納
　　for (var i = 0; i < items.length; i++) {
　　　　message += items[i].getItem().getTitle() + ": " + items[i].getResponse() + "\n";
　　}
　
　　UrlFetchApp.fetch(
　　　　// Webhook URLを入れる
　　　　"https://hooks.slack.com/services/AAAAAAAA/BBBBBBBBB/CCCCCCCC",
　　　　{
　　　　　　//POSTリクエストでSlackへ送信
　　　　　　"method" : "POST",
　　　　　　"contentType" : "application/json",
　　　　　　"payload" : JSON.stringify({"text": message})
　　　　}
　　);
}

これだけ見ると何がなんだかわからない方もいるかもしれません。

何をしているのか

POSTリクエストを用いて、payloadパラメーターとしてmessageに格納したフォーム情報を、JSON形式で送信しています。

なのでスクリプトエディタを使わなくても、ターミナルから通知を送ることもできます。
たとえば以下のようにターミナル上でcurlを使って送信できちゃう。

$ curl -X POST --data-urlencode "payload={\"text\": \"TEST\" }" https://hooks.slack.com/services/TAAAAAAAA/BBBBBBBBBB/ZZZZZZZZZZZZZZZZZZZZZ

ただ、フォームの情報をPOSTリクエストで送っているだけなんだなぁということがわかりました！

少し脱線しましたが、設定を進めていきます。

コードを書いたら保存ボタンをクリック！

３. トリガーを設定する

編集メニュー > トリガー > トリガーを追加

先程のコードが実行されるための「 トリガー 」を設定します。

フォーム送信時にコードが実行されるよう、以下のように設定して保存。

自身のGoogleアカウントで認証

アカウントを選択すると警告表示が出てきますが、問題ないので構わず

詳細 > 無題のプロジェクトに移動 > 許可

というように進めてください。

無事トリガーが登録されていたら成功です！

動作確認

実際にフォーム項目を設定して送信してみましょう。
今回はこんな感じで設定してみました。

すると・・・

「 スココココココココココ！！ 」

しっかり通知が届きました！
どうも、ジロリアン太郎と申します🍜

余談ですが、
アイコンとアカウント名は
Incoming Webhookのページから変更することができます。
お試しあれ！

（応用編）通知内容のカスタマイズ

ここからは応用編になります。
通知内容をカスタマイズする方法をみていきましょう。

①メッセージを装飾する

"payload" : JSON.stringify({
　　"attachments": [
　　　{
　　　　"fallback":"fallback Test",
　　　　"pretext":"<!here>" + " 新しい申請があります",
　　　　"color":"#D00000",
　　　　"text": message,
　　　}
　　]
}),

attachmentsを使うことで、上記のような装飾したメッセージ群を送ることができます。
<!here>" + " 新しい申請があります" をpretext に代入することで装飾の外に出すことが可能です。

②文字列にリンクをつける

{
    "text": "<https://〇〇/|This is my favorite JIRO Ramen>"
}

<URL|特定の文字列> と書くと、文字列にリンクをつけることができます。

③Slackの書式設定を使う

{
　"text": "いろんな書式設定 *太文字* _斜体_ ~取り消し線~ `赤文字`"
}

Slackにはたくさんの書式設定があり、設定方法には

入力欄のツールバーから適用する方法
マークダウンと似た（マークアップ）書式で設定する方法

の2つがあります。
通知内で使用する場合はマークアップ書式で記載してあげます。

④attachmentsの中でSlackの書式設定を使う

"attachments": [
　{
　　"text": "いろんな書式設定 *太文字* _斜体_ ~取り消し線~ `赤文字`".
　　"mrkdwn_in": [ "text" ]
　} 
]

attachmentsの中でSlackの書式設定を使う場合はmrkdwn_inで適用したい要素を指定する必要があります。

最後に

今回はGoogleForm→Slackへの通知設定を紹介しました。
テンプレートを決めてメッセージを送りたい時や、データとして残したい時などに最適です。ぜひ使ってみてください。

また途中で出てきたSlack用アプリIncoming Webhookを使えば、アプリ上からでも通知が可能です。エラーの通知やビルドの成否通知などで活用場面はさまざま。

機会があったらアプリ上からの通知方法もまとめてみたいですね。

最後まで読んでくださり、ありがとうございました！