GASからSlackに通知する|Incoming WebhookのURLをスクリプトプロパティで安全に使う

GASで毎朝の集計やチェックを自動化したものの、結果はメールで届くだけ。気づいたら受信箱に埋もれていて、結局ちゃんと見ていない……ということ、ありませんか?

チームや自分用のSlackを普段から開いているなら、結果をSlackのチャンネルに流してしまうのがおすすめです。Slack の Incoming Webhook(受信Webhook)を使えば、GAS の UrlFetchApp から数行で投稿できます。メールに埋もれやすい通知は、普段よく見る場所に寄せておくと見落としを減らせます。

💡
この記事で解決すること

Slack アプリで Incoming Webhook のURLを発行し、GAS から「今日の集計」や「エラーが起きました」を投稿する関数を作ります。
URLはスクリプトプロパティに保存して、コードには書きません。失敗したときのステータスとエラー文の見方もあわせて整理します。


この記事の前提

  • GASのスクリプトエディタで関数を実行したことがある
  • 毎日自動で動かすトリガーの付け方は GASを毎日自動で動かす|時間主導型トリガーの設定手順 で解説しています
  • Slack のワークスペースで、アプリを追加できる権限がある(ワークスペースの設定によっては、管理者の承認が必要なことがあります)
  • この記事のGASコードは、GASの機能(UrlFetchApp など)をまねた Node.js 上のテストで、送る内容とエラー時の動きを確認しています。実際のSlackへの投稿画面は載せていません(掲載しているターミナル画像は Node.js のモックです)

用語メモ
用語 ざっくりした意味
Incoming Webhook 「このURLにJSONを送ると、決まったチャンネルに投稿される」というSlackの受け口
Slack アプリ Slackに機能を追加するための入れ物。Incoming Webhook を使うにも、まずアプリを1つ作る
UrlFetchApp GASから外部のURLにアクセスするための機能
スクリプトプロパティ GASのプロジェクトに保存できる「名前つきの値」。APIキーやURLなど、コードに書きたくない値を入れておく
JSON {"text": "こんにちは"} のような、データを送り合うときの書き方

結論:URLはスクリプトプロパティに、送信は関数1つに

やることは3つです。

  1. Slack アプリを作り、Incoming Webhook のURLを発行する
  2. URLをスクリプトプロパティ SLACK_WEBHOOK_URL に保存する
  3. GASから {"text": "メッセージ"} をPOSTする関数を作り、使い回す

GASからSlackのIncoming WebhookへPOSTし、HTTP 200と本文okで成功を判定する流れ

手順1:Slack で Incoming Webhook のURLを発行する

Slack の公式ドキュメント(Sending messages using incoming webhooks)の流れに沿って進めます。画面の表示は、Slack 側の更新で少し変わることがあります。

  1. ブラウザで Slack API のアプリ管理画面 を開き、新しいアプリを作る(すでに作ったアプリがあれば、それを使っても構いません)
  2. アプリ名(例:GAS通知)と、投稿したいワークスペースを選び、「Create」で作成する
  3. アプリの設定画面の左メニューから「Incoming Webhooks」を開き、「Activate Incoming Webhooks」をオンにする
  4. 画面下に出てくる「Add New Webhook to Workspace」を押す
  5. 投稿先のチャンネル(例:#自動化通知)を選び、許可(Authorize)する
  6. 「Webhook URLs for Your Workspace」に表示されたURLをコピーする

ボタン名は、公式ドキュメント Sending messages using incoming webhooks の英語表記に合わせています。

URLは https://hooks.slack.com/services/T…/B…/… のような形です。公式ドキュメントにも「このURLには秘密が含まれている。公開リポジトリなどで共有しないこと。Slack は漏れたものを探して無効にしている」と書かれています。コードやスクリーンショット、AIへの質問には貼らないようにしましょう。

なお、公式ドキュメントによると、Incoming Webhook では投稿先のチャンネル・表示名・アイコンをメッセージごとに変えることはできず、アプリの設定がそのまま使われます。別のチャンネルにも送りたいときは、そのチャンネル用にもう1つWebhookを追加します。


手順2:URLをスクリプトプロパティに保存する

公式ガイド Properties Service の手順です(表記は公式ガイドの英語に合わせています。日本語表示の画面では名前が違うことがあります)。

  1. スプレッドシートの「拡張機能」→「Apps Script」でエディタを開く
  2. 左側の Project Settings(歯車のアイコン)を開く
  3. Script Properties の「Add script property」をクリックする
  4. Property に SLACK_WEBHOOK_URL、Value にコピーしたURLを入れる
  5. 「Save script properties」をクリックする

スクリプトプロパティの考え方は APIキーをコードに直書きしない|.envと環境変数で安全に管理する(Python・GAS) でも詳しく解説しています。


手順3:Slackに投稿する関数を貼る

次のコードを貼り付けて保存します。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
// Slack の Incoming Webhook に通知を送る(URL はスクリプトプロパティ SLACK_WEBHOOK_URL から読む)
function notifySlack_(text) {
  const url = PropertiesService.getScriptProperties().getProperty('SLACK_WEBHOOK_URL');
  if (!url) {
    throw new Error('スクリプトプロパティ SLACK_WEBHOOK_URL が未設定です');
  }
  const res = UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify({ text: text }),
    muteHttpExceptions: true, // 失敗しても例外にせず、下で中身を確認する
  });
  const code = res.getResponseCode();
  const body = res.getContentText();
  if (code !== 200) {
    throw new Error(`Slack通知に失敗しました(HTTP ${code}):${body}`);
  }
}

// まずはこれを手動で実行して、Slack に届くか確認する
function testSlack() {
  notifySlack_('✅ GASからのテスト通知です');
}

// 毎朝トリガーで動かす想定:「作業ログ」シートの件数と作業時間の合計を Slack に送る
function dailySummaryToSlack() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('作業ログ');
  if (!sheet) throw new Error('シート「作業ログ」が見つかりません');
  const lastRow = sheet.getLastRow();
  const values = lastRow >= 2 ? sheet.getRange(2, 1, lastRow - 1, 2).getValues() : [];
  const total = values.reduce((sum, row) => sum + Number(row[1] || 0), 0);
  const tz = Session.getScriptTimeZone();
  const today = Utilities.formatDate(new Date(), tz, 'yyyy/MM/dd');
  notifySlack_(`📊 ${today} の集計:${values.length}件/作業時間 合計${total}分`);
}

まずはエディタ上部で testSlack を選んで「実行」を押します。初回は承認の画面が出るので、内容を確認して許可してください(外部のURLにアクセスする権限が求められます)。Slackのチャンネルに「✅ GASからのテスト通知です」が投稿されれば成功です。

コードのポイントです。

  • contentType: 'application/json' と payload: JSON.stringify(...) の組み合わせで、JSONとして送ります。UrlFetchApp の公式リファレンスにある書き方です
  • muteHttpExceptions: true にすると、失敗しても fetch が例外を投げず、ステータスコードと本文を自分で確認できます
  • Slack は成功すると 200 と本文 ok を返します。それ以外は、エラー文(no_service など)を含めて例外にしています
  • エラー文にURLそのものは入れていません。ログや通知メールにURLが残らないようにするためです

GASの機能をまねたテストで確かめたところ、dailySummaryToSlack は「作業ログ」シートのダミーデータ(3件、45分・30分・空欄)から、次のJSONを組み立てていました。空欄は0分として数えています。

  • 1
{"text":"📊 2026/11/11 の集計:3件/作業時間 合計75分"}

Node.jsモックでpayloadと異常系を確かめたターミナル(実Slackへの投稿結果ではありません)

「作業ログ」シートは、1行目を見出し(A列:作業名、B列:作業時間(分))にして、2行目からデータを入れる想定です。自分のシートに合わせて、シート名や列を変えてください。


手順4:毎朝トリガーで動かす

testSlack で届くことを確認できたら、dailySummaryToSlack を時間主導型のトリガーに設定します。トリガーの作り方は GASを毎日自動で動かす|時間主導型トリガーの設定手順、メールで要約を送る版は GASで毎朝スプレッドシートの要約をGmailに送る|時間主導トリガーの設定手順 で解説しています。メールとSlackのどちらに送るかは、普段よく見る方を選べばOKです。


エラー通知をSlackに送る

GASの自動処理が止まったら気づける|try/catchとエラー通知メールの作り方 で作った notifyError_ の送信部分を、メールからSlackに置き換えることもできます。MailApp.sendEmail を呼んでいた try の中身を、たとえば次のようにします。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  try {
    notifySlack_(`🚨【GASエラー】${jobName}:${message}`);
  } catch (notifyError) {
    // 通知自体の失敗で、元のエラーが隠れないようにする
    console.error(`Slack通知にも失敗しました:${notifyError.message}`);
  }

Slack が止まっているときに備えて、メール通知も残しておく「二段構え」にしておくとさらに安心です。

自分のスクリプトに組み込むときは、AIにこう頼むとスムーズです。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
次のGoogle Apps Scriptに、Slackへの通知を組み込みたいです。

【条件】
- 送信は notifySlack_(text) という関数を使う(中身は下に貼ります)
- Webhook URL はスクリプトプロパティ SLACK_WEBHOOK_URL から読む。コードには書かない
- 処理が成功したら件数を、失敗したらジョブ名とエラーの要点を Slack に送る(URL・合言葉・個人情報は入れない)
- 失敗時は通知したあと throw でエラーを投げ直す
- 通知の送信に失敗しても、元のエラーが隠れないようにする

【notifySlack_ の中身】
(ここに貼る。Webhook URL の実物は貼らない)

【組み込みたい処理】
(ここに貼る。URLやメールアドレスなど個人の情報は伏せる)

セキュリティの注意

  • Slack の Webhook URL は、URL全体が秘密の情報です。コードには書かず、スクリプトプロパティに保存しましょう
  • スクリプトプロパティは、プロジェクトの編集者からは見えます。スプレッドシートやスクリプトを共有する相手は必要な人だけに絞ってください
  • URLや個人の情報を実行ログに残さないようにし、漏れたかもしれないURLは無効にして作り直します
  • 通知のエラーを何度も送り直し続けないようにしましょう。設定や送る内容の誤りは、直してから実行し直します

参考:Sending messages using incoming webhooks(Slack 公式)、Properties Service(Google 公式)


つまずきやすい点

Slack の公式ドキュメントでは、Incoming Webhook は失敗したときに、400・403・404 などのステータスと、短いエラー文を返すと説明されています。よく見るものをまとめました。

症状(エラー文) 原因 対処
SLACK_WEBHOOK_URL が未設定です スクリプトプロパティの名前の打ち間違い、保存し忘れ Project Settings で名前と値を確認する
invalid_payload JSONの形がおかしい JSON.stringify で送っているか、contentType を指定しているかを見る
no_text text が入っていない 送るオブジェクトに text があるか確認する
no_service Webhook が無効・削除された アプリの設定画面でWebhookを追加し直し、URLを差し替える
channel_is_archived 投稿先のチャンネルがアーカイブされた 別のチャンネル用にWebhookを追加し直す
action_prohibited 管理者が投稿方法を制限している ワークスペースの管理者に確認する
承認画面で止まる 外部URLへのアクセスの許可がまだ 手動実行で一度承認する

よくあるのは、スクリプトプロパティの名前を SLACK_WEBHOOK のように短くしてしまい、コード側と合わずに「未設定」と言われるパターンです。名前は1文字でも違うと読めないので、コピーして貼るのがおすすめです。

エラー文の意味がわからないときは、こう聞いてみてください。

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
Google Apps ScriptのUrlFetchAppで、SlackのIncoming Webhookに投稿しようとしています。
次のエラーになりました。原因の候補と確認する順番を教えてください。

【エラー】
Slack通知に失敗しました(HTTP 〇〇〇):(エラー文)

【送っている内容】
method: post, contentType: application/json, payload: JSON.stringify({ text: '...' })
※ Webhook URL は伏せています

まとめ

  • Slack アプリを作り、「Incoming Webhooks」をオンにしてURLを発行する
  • URLは秘密なので、スクリプトプロパティ SLACK_WEBHOOK_URL に保存する
  • UrlFetchApp.fetch でJSONをPOSTし、200 と ok なら成功
  • muteHttpExceptions: true でステータスとエラー文を自分で確認する
  • エラー通知もSlackに流せる。メールとの二段構えにするとさらに安心

次の一歩は、testSlack で1通届くのを確認してから、いつもの自動処理の最後に notifySlack_ を1行足してみることです。逆に「外からGASにデータを送り込みたい」場合は、次の PythonからGASのWebアプリにデータを送ってスプレッドシートに追記する|doPostの作り方 へ進んでみてください。


関連する本・記事

GASの自動化を、生成AIに手伝ってもらいながらどんどん増やしていきたい方は、『Google Apps Script × 生成AI 全自動仕事術』も参考になります。

より詳しく知りたいときは、公式ドキュメントの Sending messages using incoming webhooks(Slack) と Class UrlFetchApp(Apps Script) も参考になります。