自動投稿でできること

「bot」と聞くと会話する AI を想像しがちだが、実務で最初に作るのはたいてい 一方通行の通知役 だ。筆者が実際に Google Chat へ流しているのは、次のような情報である。

  • 処理の結果:夜間バッチの成功・失敗、デプロイの完了、バックアップの終了
  • 監視のアラーム:CloudWatch アラームの発報と復旧、ディスク使用率の警告
  • 定期レポート:毎朝の前日分 AWS コスト、今日の予定、週次の棚卸し結果
  • リマインド:日報の提出、証明書の期限切れ予告

メールでも届けられる情報だが、Chat に流すと チーム全員が同じ通知を同じ場所で見て、そのままスレッドで「対応します」と返せる。誰かのメールボックスに埋もれない、というのが一番の利点だ。

💡 このシリーズで扱う「bot」

プログラムから Google Chat のスペースにメッセージを 送る 側を扱う。ユーザーのメッセージに返事をする対話型の Chat アプリ(イベントを受け取って応答するもの)は、仕組みが大きく違うため対象外とし、PART 05 で入口だけ紹介する。

投稿の入口は2つ:Webhook と Chat API

Google Chat にプログラムから投稿する方法は、突き詰めると次の2つしかない。「Apps Script で送る」「Lambda で送る」という話も、中身はこのどちらかを呼んでいる。

手元PC・Apps Script・AWS Lambdaの実行場所から、Incoming WebhookまたはChat APIを経由してGoogle Chatのスペースに投稿する構成図

図1: 実行場所(左)と投稿の入口(中央)は別々に選べる

  1. Incoming Webhook:スペースの設定画面で URL を発行し、その URL に JSON を POST する。URL の中に認証情報(key と token)が含まれているので、ライブラリも OAuth もいらない。投稿先は URL を発行したスペースだけ
  2. Chat API(Chat アプリ):Google Cloud のプロジェクトに「Chat アプリ」を作り、サービスアカウントで認証して spaces.messages.create を呼ぶ。準備は多いが、メッセージの更新・削除や、アプリを追加した複数のスペースへの投稿ができる

どちらで送っても、届くメッセージの中身(テキスト・カード・スレッド)はほぼ同じ JSON で書ける。そのため 最初は Webhook で作り、必要になったら Chat API に移す という進め方で手戻りはほとんど出ない。

Webhook と Chat API の比較

Incoming WebhookChat API(アプリ認証)
準備スペースで URL を発行するだけ(数分)Google Cloud プロジェクト・Chat API の構成・サービスアカウント(30分〜)
認証URL に含まれる key / tokenサービスアカウントの鍵 + スコープ chat.bot
投稿先URL を発行した1スペースだけアプリを追加したすべてのスペース
投稿者の表示Webhook に付けた名前とアイコンChat アプリの名前とアイコン(「アプリ」ラベル付き)
テキスト・カード・スレッドできるできる
送ったメッセージの更新・削除できないできる(PART 05)
ボタンを押したら処理を動かすできない(リンクを開くボタンのみ)できる(イベントを受け取る仕組みが別途必要)
ユーザーの発言を受け取るできないできる(対話型アプリとして作る場合)
文字の書式の既定Chat 独自の記法(*太字*)新しく作ったアプリは Markdown(**太字**)

表の最後の行は見落としやすい。同じ JSON を Webhook と Chat API の両方に送ると、太字の書き方が違うせいで表示が崩れることがある。詳しくは PART 02 と PART 05 で扱う。

実行場所の選び方

入口とは別に、「投稿するプログラムをどこで動かすか」を決める必要がある。定期実行が絡むと、ここが一番悩むところだ。

実行場所向いている用途注意点
手元 PC・社内サーバー
(タスクスケジューラ / cron)
既存のバッチの最後に「完了通知」を足す。社内システムの情報を流すPC が止まっていると送られない。URL を各マシンに置くことになる
Google Apps Script
(時間主導型トリガー)
Google カレンダー・スプレッドシート・Gmail の情報を流す。サーバーを持たずに毎朝投稿する実行時刻は「9時台」のような1時間の幅で指定する。外部システムへの接続は苦手
AWS Lambda
(EventBridge Scheduler / SNS)
AWS のコスト・アラーム・リソース情報を流す。イベントが起きた瞬間に通知するAWS 側の権限と秘密情報の管理が必要

迷ったら、「通知したい情報が置いてある場所の近くで動かす」 のが正解になりやすい。カレンダーの予定なら Apps Script、AWS のコストなら Lambda、オンプレのバッチならそのサーバーで、という具合だ。3つの書き方は PART 04 でまとめて紹介する。

前提条件:Google Workspace が必要

最初に確認しておきたいのが、Webhook も Chat API も、Google Workspace(Business / Enterprise など)のアカウントが前提 だという点だ。個人の Gmail アカウント(@gmail.com)の Google Chat では、スペースに Webhook を追加するメニューが使えない。

Workspace のアカウントでも、組織の管理者が Webhook や Chat アプリを禁止していることがある。次の症状が出たら、自分の設定ではなく組織のポリシーを疑う。

  • スペースの「アプリとインテグレーション」に「Webhook を追加」が出ない、または押せない
  • Chat アプリを検索しても見つからない、追加できない

その場合は、管理者に「Google Chat で受信 Webhook(または Chat アプリ)を使いたい」と相談する必要がある。管理コンソール側の設定箇所は PART 06 にまとめた。

知っておきたい制限

通知用途で効いてくる制限は、実質的に次の2つだ。

制限内容影響する場面
書き込みの回数メッセージの作成・更新・削除は 1スペースあたり1秒に1回。同じスペースのすべての Webhook・アプリで共有するアラームが一度に大量に鳴ったとき、ループで連続投稿したとき
メッセージの大きさテキストとカードを合わせて 32,000 バイトまでログやリソース一覧をそのまま貼ったとき

上限を超えると HTTP 429 Too Many Requests が返る。1分あたりの割り当ての範囲内であれば、1日に送れる件数に上限はない。どちらの制限も、運用を始めてから「たまに通知が届かない」という形で表面化するので、PART 06 でリトライと分割の書き方を用意する。

⚠️ 「1秒1回」は1つのスペース全体での上限

Webhook を3つ作っても、同じスペースなら上限は合計で1秒1回のままだ。通知の種類ごとに Webhook を分けるのはわかりやすくてよいが、回数の上限を逃れる手段にはならない。

このシリーズの前提環境と構成

  • Google Workspace のアカウント(Webhook と Chat アプリの利用が許可されていること)
  • ローカル PC:Windows 11(PowerShell)。curl の例は Linux / macOS / WSL でも同じ
  • Python 3.12 以上(requests を使う。Lambda では標準ライブラリだけで書く)
  • PART 04 の AWS 編は、AWS CLI とプロファイル dev(東京リージョン)が準備済みであること。準備は ポートフォワード PART 02、コストの取得は boto3 PART 05 を参照
回内容こんなときに読む
PART 01全体像と選び方(この記事)どの方法で作るか決めたい
PART 02Incoming Webhook で最短投稿とにかく1通送りたい・日本語が文字化けする
PART 03カードメッセージ見出しやボタンのある通知にしたい
PART 04定期投稿と自動化毎朝決まった時刻に送りたい・アラームを流したい
PART 05Chat API で投稿・更新・削除送ったメッセージを書き換えたい・複数スペースに送りたい
PART 06運用とトラブルシューティングエラーが出た・通知が届かない・URL を守りたい

✅ 次の記事では…

PART 02 では、スペースに Incoming Webhook を作り、curl・PowerShell・Python から最初の1通を送る。Windows PowerShell で日本語が文字化けする原因もここで片付ける。

→ PART 02 — Incoming Webhookで最短投稿へ