Apps ScriptでGoogle Chatに通知する方法｜Gmail・フォーム連携の実装例

重要メールをChatに通知したい。フォーム回答を担当スペースへ流したい。そうした要件は、Apps Scriptでサーバーなしに組めます。この記事では、実装例だけでなく、どの要素がGoogleの評価軸に乗りやすいかまで整理します。

先に判断する

Apps Scriptは万能ではありません。通知だけなら十分ですが、ボタンで承認したい、利用者と対話したい、複数スペースを操作したいなら、最初からChat API側を選ぶほうが筋が通ります。ここを見誤ると、Apps Scriptで無理やり双方向を再現しようとして、かえって複雑になります。

なぜApps Scriptか

Apps ScriptはGoogleのクラウド上で動くスクリプト基盤です。サーバー構築が不要で、Gmail、スプレッドシート、フォーム、カレンダーなどのイベントとつなげます。Google Chat通知の自動化を、最小の準備で始めるには適しています。

基本：Chatに通知する関数

WebhookのURLをスクリプトプロパティに保管し、UrlFetchApp でPOSTします。

function notifyChat(message) {
  const url = PropertiesService.getScriptProperties().getProperty('CHAT_WEBHOOK_URL');
  UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify({ text: message }),
  });
}

図解：実装の流れ

例1：重要メールをChatに通知

時間主導トリガーで定期的にGmailを検索し、条件に合うメールをChatへ通知します。

function notifyImportantMail() {
  const threads = GmailApp.search('is:unread label:重要', 0, 10);
  threads.forEach((thread) => {
    const msg = thread.getMessages()[0];
    notifyChat(`重要メール: ${msg.getSubject()} / 差出人: ${msg.getFrom()}`);
  });
}

例2：フォーム回答をChatに通知

Googleフォームの送信時トリガーで、回答内容をChatへ通知します。問い合わせ対応の起点になります。

function onFormSubmit(e) {
  const answers = e.values.join(' / ');
  notifyChat(`新しいフォーム回答: ${answers}`);
}

トリガーの設定

Webhookと直接APIの使い分け

通知が目的ならWebhookが手軽です。スペース作成やメンバー操作など高度な操作が必要なら、認証付きでChat APIを利用します。詳しくはGoogle Chat Webhookの使い方とGoogle Chat APIの解説を参照してください。メール起点の自動化全般はGmail自動化で扱います。

注意点

Expert Q&A

運用前に確認すること

湯田英也SakuraAI株式会社 代表 / ソフトウェアエンジニア

Q. 本番で最初に壊れやすいのはどこですか？

A. Webhook URLの管理と、通知の再送です。URLはスクリプトプロパティなどに分けて持たせ、処理済みのメールやフォーム回答のIDを記録して、同じ通知が二度飛ばないようにしておく。この2点を押さえれば、初期のトラブルはだいたい防げます。

Q. どこまでApps Scriptでやるべき？

A. GmailやフォームやシートのイベントからChatへ通知するところまでは、Apps Scriptの得意分野です。ボタンでの承認や利用者との対話が要るなら、無理せずChat API側へ。境界を意識して使い分けるのがコツです。

Q. 動かなくなったとき、まず何を見ますか？

A. トリガーの実行ログとクォータです。急に通知が止まったら、たいていトリガーが外れているか、実行回数の上限に当たっているか。実行ログを見れば、どちらかはすぐ分かります。

SakuraAIで支援できること

SakuraAIでは、Apps Scriptを使ったGoogle Chat通知の設計・実装を支援しています。Gmail・フォーム・スプレッドシートを起点にした社内自動化を、サーバーを増やさずに素早く立ち上げ、処理量や要件が育ってきたらBotやChat APIへ段階的に広げます。

Reviewed by

監修者: 湯田英也

SakuraAI株式会社 代表 / ソフトウェアエンジニア

Google Chatの導入・移行、Google Workspace連携、Google Chat API / Webhook / Bot、Gmail・Meet・Drive・Calendarをまたぐ業務自動化領域を監修しています。

Google公式情報、各プロダクトの仕様、実務での運用・開発観点をもとに、企業が導入判断・運用設計・自動化設計を行える内容になるよう確認しています。

GitHubLinkedInX

プロフィール