【GAS入門#96】Slackへ自動通知!UrlFetchApp.fetch() (POST) の使い方と請求書発行・異常検知アラートの実装ガイド

「スプレッドシートの集計や請求書の発行が終わったあと、毎回手作業でSlackのチャンネルを開いて『〇〇件の処理が終わりました!』と報告メッセージを打ち込んでいる……」
「深夜や休日に自動バッチ処理を走らせているけれど、もし途中でエラーが起きて止まっていたらどうしようと不安で、休みなのに何度もスマホでシートを確認してしまう……」

日々の業務をGAS(Google Apps Script)で自動化していく中で、このような「最後の報告作業の手間」や「見えないバックグラウンド処理への不安」に悩まされたことはありませんか?

札幌でハイブリッドワークをしていると、猛吹雪の朝にチカホ(札幌駅前通地下歩行空間)を歩きながらスマホを見たり、新千歳空港で東京行きのフライトを待つラウンジで作業したりと、PCを常に開いていられない移動時間がどうしても発生しますよね。そんなとき、スプレッドシートやドキュメントの更新結果、あるいは万が一のエラー発生の通知が、手元のSlackの #sapporo-dashboard チャンネルへリアルタイムに「ピロン♪」と届いたら、どれほど心強いでしょうか!

そこで第96回となる今回は、GASから外部のサーバーへデータを送信する決定版メソッド UrlFetchApp.fetch() の POST通信 を使って、請求書の発行完了通知やシステムの異常検知アラートをSlackへ自動投稿する実践テクニックを徹底解説します!

第93回で学んだ「スクリプトプロパティ(金庫)」、第94回の「UrlFetchApp(外部通信)」、そして第95回の「JSON.stringify()(データ梱包)」という、これまで積み上げてきた強力な武器たちがここで美しく1つに繋がります。初心者の方でも今日からコピペで動かせる実践コードとともに、どこよりも分かりやすく丁寧に紐解いていきますね!

1. そもそも UrlFetchApp.fetch() の「POST通信」とは?GETとの違い

第94回では、外部の気象APIから札幌のリアルタイムな天候データを「取ってくる」ために、UrlFetchApp.fetch() の GETリクエスト を学びました。まずは、今回使う POSTリクエスト と何が違うのかをすっきり整理しておきましょう!

GET通信とPOST通信の決定的な違い

インターネットの通信規格(HTTP)において、GETとPOSTは目的が根本から異なります。

通信メソッド現実世界でのイメージ通信の方向主な目的・役割
GET通信
(第94回)
図書館で本を閲覧する・
メニュー表を見せてもらう
外部 ➔ GAS
(データをもらう)
データの取得・読み取り
(天気情報の取得、検索など)
POST通信
(★今回)
小包を相手の郵便ポストに投函する・
注文用紙を店員に手渡す
GAS ➔ 外部
(データを届ける)
データの送信・新規作成・通知
(Slackへの投稿、フォーム登録など)

GET通信は「URLの場所にあるデータをちょうだい!」とおねだりする通信でした。一方、今回のPOST通信は「GASで作ったメッセージ(小包)を、Slackの指定された部屋へ届けて投稿して!」と、データを相手のサーバーへ押し込む通信です。

Slack Incoming Webhook の仕組み

SlackへGASからメッセージを送る際、最も標準的で安全に使われている仕組みが Incoming Webhook(インカミング・ウェブフック) です。

Incoming Webhook とは、一言で言えば「特定のSlackチャンネル(今回は #sapporo-dashboard)に直結している、専用の郵便ポスト」のようなものです。
Slackの設定画面で専用の「Webhook URL」を発行し、そのURLに向かってGASからメッセージ入りの荷物をPOST送信すると、Slack側が「あ、札幌オフィスのダッシュボード宛ての荷物だな!」と判断して、指定チャンネルへ自動投稿してくれる仕組みになっています。

2. POSTリクエストを組み立てる「3大必須パラメータ」

第94回のGET通信では UrlFetchApp.fetch(url) とURLを渡すだけで通信できましたが、POST通信では「どんな方法で、どんな形式の荷物を送るのか」を指示するために、第2引数に オプション(options)オブジェクト を渡す必要があります。

// POST通信の基本構造
var options = {
"method": "post",
"contentType": "application/json",
"payload": JSON.stringify(payloadData),
"muteHttpExceptions": true
};

var response = UrlFetchApp.fetch(webhookUrl, options);

このオプションの中で絶対に外せない4つの設定項目を確認しておきましょう!

  1. method: “post”
    「今から送る通信はPOSTリクエスト(荷物の投函)ですよ!」と宣言します。小文字でも大文字(”POST”)でも動作します。
  2. contentType: “application/json”
    「今から送る荷物は、世界共通のJSON形式のテキストデータですよ」とSlackのサーバーへ伝えます。
  3. payload: JSON.stringify(…)
    ここが最も重要な荷物本体です!第95回で学んだ通り、JavaScriptのオブジェクトはそのまま電波に乗せることができないため、必ず JSON.stringify() で1本の文字列に梱包(冷凍パック)して渡します。
  4. muteHttpExceptions: true
    第94回でも登場したプロの安全装置です!万が一Slack側の通信エラー(400番台や500番台)が起きても、GASプログラムがその場で真っ赤なエラーを出して強制クラッシュするのを防ぎます。

3. STEP1:準備!SlackでWebhook URLを発行して金庫に保管しよう

それでは、実際にGASからSlackへ通知を飛ばすための準備をしていきましょう!
Slackのアカウントをお持ちでない場合は、テスト用の無料ワークスペースを1つ作成しておくと安全に実験できますよ。

手順1:Slackに #sapporo-dashboard チャンネルを作成する

  1. ご自身のSlackワークスペースを開きます。
  2. 左側のチャンネル一覧の「+」ボタンを押し、「新しいチャンネルを作成」をクリックします。
  3. 名前を sapporo-dashboard に設定して作成します(パブリック・プライベートどちらでもOKです)。

手順2:Incoming Webhook URL を発行する

  1. ブラウザで「Slack API: Applications」の管理画面を開きます。
  2. 右上の緑色のボタン「Create New App」をクリックし、「From scratch」を選択します。
  3. App Name に「札幌オフィス通知Bot」、Workspace にご自身のワークスペースを選択して「Create App」を押します。
  4. 左メニューの「Incoming Webhooks」をクリックし、右上のトグルスイッチを「On」に切り替えます。
  5. ページ下部にある「Add New Webhook to Workspace」というボタンをクリックします。
  6. 投稿先のチャンネル選択画面が出るので、先ほど作った「#sapporo-dashboard」を選択して「許可する」を押します。
  7. 画面下に生成された Webhook URL(https://hooks.slack.com/services/T00.../B00.../XXXXXX)の横にある「Copy」ボタンを押してコピーします。

手順3:第93回の知識!Webhook URLをスクリプトプロパティ(金庫)へ登録する

ここで、前回・前々回の教訓を思い出してください!
コピーしたWebhook URLを、コードの中に直接ベタ書きしてはいけませんでしたよね。誰かに見られたり誤って共有しても安全なように、Googleのクラウド金庫へ保管します。

  1. Googleスプレッドシートを開き、「拡張機能」>「Apps Script」でエディタを開きます。
  2. エディタ左メニューの「歯車マーク(プロジェクトの設定)」をクリックします。
  3. ページ一番下までスクロールし、「スクリプト プロパティを追加」をクリックします。
  4. 以下の通りに入力して保存します。
    • プロパティ(キー名):SLACK_WEBHOOK_URL
    • 値:先ほどコピーしたSlackの Webhook URL 全体(https://hooks.slack.com/...)
  5. 「スクリプト プロパティを保存」を押します。

これで、GASから安全にSlackへ通信するための下準備が完全に整いました!

4. STEP2:【実践1】最小限のコードでSlackにメッセージを送信してみよう!

準備ができたところで、まずは一番シンプルなテキストメッセージをSlackの #sapporo-dashboard チャンネルへ飛ばす基本コードを書いてみましょう!

1. コードを入力する

エディタ画面の「コード.gs」を開き、以下のスクリプトを貼り付けます。

/**
* 第96回 STEP2:Slackへの最もシンプルなテキスト送信
*/
function testSendSlackMessage() {
// ① 第93回の復習:金庫から安全にWebhook URLを取り出す!
var scriptProperties = PropertiesService.getScriptProperties();
var webhookUrl = scriptProperties.getProperty("SLACK_WEBHOOK_URL");

if (!webhookUrl) {
Logger.log("⚠️ エラー:スクリプトプロパティに SLACK_WEBHOOK_URL が設定されていません。");
return;
}

// ② 送信したいメッセージのオブジェクトを準備
var payloadObject = {
"text": "❄️ 札幌オフィス統合ダッシュボードからのテスト通信です。正常に接続されました!"
};

// ③ POST通信のオプションを組み立てる(第95回 JSON.stringify の復習!)
var options = {
"method": "post",
"contentType": "application/json",
"payload": JSON.stringify(payloadObject),
"muteHttpExceptions": true
};

Logger.log("=== SlackへPOSTリクエストを送信します ===");

// ④ 【本日の主役!】UrlFetchApp.fetch() で送信実行!
var response = UrlFetchApp.fetch(webhookUrl, options);

// ⑤ 相手の反応(レスポンス)を確認する
var responseCode = response.getResponseCode();
var responseBody = response.getContentText();

Logger.log("■ HTTPステータスコード : " + responseCode);
Logger.log("■ Slackからの返答 : " + responseBody);

if (responseCode === 200 && responseBody === "ok") {
Logger.log("🎉 Slackへのメッセージ投稿に大成功しました!");
} else {
Logger.log("⚠️ 送信に失敗した可能性があります。ステータスコードを確認してください。");
}
}

2. 保存して実行・Slack画面を確認しよう!

  1. エディタ上部の「保存(フロッピーアイコン)」を押し、「実行」ボタンをクリックします。
  2. 初回実行時は「外部サービスへの接続権限」の認証ポップアップが表示されますので、第2回で学んだ手順でアクセスを許可してください。
  3. 実行後、ご自身のSlackの #sapporo-dashboard チャンネルを開いてみましょう!

Slackの画面に、Botから「❄️ 札幌オフィス統合ダッシュボードからのテスト通信です。正常に接続されました!」とメッセージが届いていれば大成功です!
エディタのログにも HTTPステータスコード : 200 と Slackからの返答 : ok が綺麗に出力されているはずですよ。

5. STEP3:【実践2】請求書発行完了をリッチなカード(Block Kit)で通知しよう!

一行の文字を送るだけでも便利ですが、実務の現場では「もっと見やすく、情報のまとまったプロ仕様の通知」が求められますよね。
Slackには、文字を太字にしたり、枠線や仕切り線をつけたり、URLボタンを配置したりできる Block Kit(ブロックキット) という強力なリッチデザイン機能が用意されています。

ここでは、第87回〜第88回で作成した「請求書一括自動発行」の処理が終わった直後に、発行件数・合計金額・発行担当者、そしてGoogleドライブの保管先URLボタンを添えた美しいカード通知を自動投稿するコードを書いてみましょう!

Block Kit を活用した請求書発行完了通知コード

/**
* 請求書発行完了時に呼び出される、リッチなSlackカード通知関数
* @param {number} invoiceCount - 発行した請求書の通数
* @param {number} totalAmount - 請求合計金額(円)
* @param {string} issuerName - 発行担当者名
* @param {string} driveFolderUrl - 請求書PDFが保管されたDriveフォルダのURL
*/
function sendInvoiceCompleteNotification(invoiceCount, totalAmount, issuerName, driveFolderUrl) {
var webhookUrl = PropertiesService.getScriptProperties().getProperty("SLACK_WEBHOOK_URL");
if (!webhookUrl) return;

var timestamp = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
var formattedAmount = Number(totalAmount).toLocaleString() + " 円";

// Slack Block Kit のリッチなUIブロックを組み立てる(オブジェクト構造)
var blocks = [
{
"type": "header",
"text": {
"type": "plain_text",
"text": "📑 【札幌オフィス】請求書の一括発行が完了しました",
"emoji": true
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "スプレッドシートの未発行データから、Googleドキュメントの請求書が正常に自動生成されました。"
}
},
{
"type": "divider" // スタイリッシュな区切り線
},
{
"type": "section",
"fields": [
{
"type": "mrkdwn",
"text": "*発行件数:*\n" + invoiceCount + " 件"
},
{
"type": "mrkdwn",
"text": "*請求総額 (税込):*\n`" + formattedAmount + "`"
},
{
"type": "mrkdwn",
"text": "*発行担当者:*\n" + issuerName
},
{
"type": "mrkdwn",
"text": "*処理完了日時:*\n" + timestamp
}
]
},
{
"type": "actions",
"elements": [
{
"type": "button",
"text": {
"type": "plain_text",
"text": "📂 保管先ドライブを開く",
"emoji": true
},
"url": driveFolderUrl,
"style": "primary" // 鮮やかな緑色の目立つボタン
}
]
},
{
"type": "context",
"elements": [
{
"type": "mrkdwn",
"text": "📍 送信元: 札幌オフィス統合ダッシュボード自動化システム (GAS)"
}
]
}
];

// 全体をまとめたペイロード
var payload = {
// 万が一Block Kitに対応していないスマートウォッチ等のための予備テキスト
"text": "【完了通知】" + invoiceCount + "件の請求書発行が完了しました(合計: " + formattedAmount + ")",
"blocks": blocks
};

var options = {
"method": "post",
"contentType": "application/json",
"payload": JSON.stringify(payload),
"muteHttpExceptions": true
};

var res = UrlFetchApp.fetch(webhookUrl, options);
Logger.log("請求書発行完了のSlack通知を送信しました。ステータス: " + res.getResponseCode());
}

/**
* 動作テスト用のダミー実行関数
*/
function testInvoiceSlackNotification() {
// 第60回で作成したPDF保管庫フォルダのURLを想定
var dummyFolderUrl = "https://drive.google.com/drive/folders/dummy-folder-id";
sendInvoiceCompleteNotification(3, 715000, "道産子 太郎", dummyFolderUrl);
}

testInvoiceSlackNotification を実行してSlackを確認してみてください!
大きな太字の見出し、綺麗に2列に整列した「発行件数・請求総額・担当者・日時」、そしてクリックするとGoogleドライブへ飛べる「緑色のアクションボタン」がついた、まるでプロのSaaSツールのような美しい通知カードが投稿されたはずです!

6. STEP4:【実践3】現場が一番助かる!「システム異常検知・金額不整合アラート」を自動通知

業務自動化において、成功通知よりもはるかに価値があるのが「異常が起きた瞬間に即座に知らせてくれるアラート通知」です。
手作業でスプレッドシートを運用していると、「入力金額がマイナスになっている」「請求先会社名が空欄のままになっている」「GASの内部処理で例外エラーが発生して処理が中断した」といったトラブルが必ず起こります。

ここでは、データの整合性をチェックし、異常を検知した瞬間に <!channel>(全体メンション)を付けて目立つ赤色のアラートカードを即座にSlackへ飛ばす実践ロジックを作成します!

異常検知アラート通知コード

/**
* システム異常やデータ不正を検知した際にSlackへ緊急警報を飛ばす関数
* @param {string} alertTitle - エラーの見出し
* @param {string} detailMessage - 詳細なエラー理由や該当データ
*/
function sendErrorAlertToSlack(alertTitle, detailMessage) {
var webhookUrl = PropertiesService.getScriptProperties().getProperty("SLACK_WEBHOOK_URL");
if (!webhookUrl) return;

var timestamp = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");

// Slackの「attachments」機能を使って、左側に赤い警告バーを表示する
var payload = {
"text": " 🚨 【異常検知】札幌オフィスシステムでエラーが発生しました",
"attachments": [
{
"color": "#D32F2F", // 警告の深紅カラー
"blocks": [
{
"type": "header",
"text": {
"type": "plain_text",
"text": "🚨 システム異常検知アラート",
"emoji": true
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*検知内容:*\n" + alertTitle + "\n\n*エラー詳細:*\n```" + detailMessage + "```"
}
},
{
"type": "context",
"elements": [
{
"type": "mrkdwn",
"text": "⏰ 発生時刻: " + timestamp + " | 札幌オフィス監視Bot"
}
]
}
]
}
]
};

var options = {
"method": "post",
"contentType": "application/json",
"payload": JSON.stringify(payload),
"muteHttpExceptions": true
};

UrlFetchApp.fetch(webhookUrl, options);
Logger.log("Slackへの緊急警告アラート送信を完了しました。");
}

/**
* 実務シミュレーション:データチェックと try...catch による自動異常検知
*/
function runBillingDataAuditWithAlert() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("請求業績DB"); // 第90回のシート

try {
if (!sheet) {
throw new Error("データベース用シート「請求業績DB」が存在しません。");
}

var lastRow = sheet.getLastRow();
if (lastRow < 2) return;

var values = sheet.getRange(2, 1, lastRow - 1, 6).getValues();

// データの整合性チェック(金額が0円以下、または会社名が空欄のものを探す)
for (var i = 0; i < values.length; i++) {
var rowNum = i + 2;
var company = values[i][1];
var amount = values[i][3];

if (!company || company.toString().trim() === "") {
sendErrorAlertToSlack(
"取引先会社名の未入力エラー",
rowNum + "行目の「取引先会社名」が空欄のままになっています。スプレッドシートを確認してください。"
);
return;
}

if (isNaN(amount) || Number(amount) <= 0) {
sendErrorAlertToSlack(
"請求金額の不正(0円または不正な数値)",
rowNum + "行目(会社名: " + company + ")の金額が「" + amount + "」となっています。正しい数値を入力してください。"
);
return;
}
}

Logger.log("全件データの監査が正常に完了しました。異常なし!");

} catch (error) {
// 第30回で学んだ try...catch:予期せぬスクリプトエラーもSlackへ自動報告!
Logger.log("重大な例外エラーをキャッチ: " + error.message);
sendErrorAlertToSlack("GAS実行時例外エラー発生", error.stack || error.message);
}
}

あえて金額セルに「-500」や文字を入れて runBillingDataAuditWithAlert を動かしてみてください。
瞬時にSlackのチャンネルへ、左側に赤い帯が入った目立つアラートが <!channel> メンション付きで飛んできます!
これがあれば、あなたがオフィスにいなくても、深夜や外出中でも、トラブルが発生した瞬間にチーム全員で即座に検知して対応できるようになりますね。

7. 実務で差がつく!Slack通知のプロ技3選

通知の基本がマスターできたら、現場のリードエンジニアが実務で必ず取り入れている3つの洗練されたプロ技を押さえておきましょう!

プロ技①:Slack公式の「Block Kit Builder」でノーコードデザインする

「あんなに複雑なJSONブロックを、ゼロから手書きで書くのは大変そう……」と思いましたよね。
実はSlack公式から「Block Kit Builder」という無料のデザインツールが提供されています!

画面上でボタンや画像、テキストをマウス操作でドラッグ&ドロップして並べるだけで、右側に自動で完璧なJSONオブジェクトが生成されます。そのJSONの blocks の中身をコピーしてGASの var blocks = [...] に貼り付け、文字部分を変数(+ amount + など)に置き換えるだけで、誰でも10秒でおしゃれなカードデザインが作れますよ!

プロ技②:通知の重要度(Level)でカラーと絵文字を出し分ける汎用通知関数

通知ごとに別々の関数を作るのではなく、重要度("INFO", "SUCCESS", "WARN", "DANGER")を引数で渡すだけで、枠線の色や絵文字を自動で切り替える共通通知関数を用意しておくと、システム全体が驚くほどスッキリします。

/**
* どんなスクリプトからでも使い回せる万能Slack通知共通関数
*/
function postSlackNotify(title, message, level) {
var webhookUrl = PropertiesService.getScriptProperties().getProperty("SLACK_WEBHOOK_URL");
if (!webhookUrl) return;

var colorMap = {
"INFO": { color: "#2B6CB0", emoji: "ℹ️" },
"SUCCESS": { color: "#38A169", emoji: "✅" },
"WARN": { color: "#DD6B20", emoji: "⚠️" },
"DANGER": { color: "#E53E3E", emoji: "🚨" }
};

var conf = colorMap[level] || colorMap["INFO"];

var payload = {
"attachments": [{
"color": conf.color,
"blocks": [
{
"type": "section",
"text": { "type": "mrkdwn", "text": conf.emoji + " *" + title + "*\n" + message }
}
]
}]
};

UrlFetchApp.fetch(webhookUrl, {
"method": "post",
"contentType": "application/json",
"payload": JSON.stringify(payload),
"muteHttpExceptions": true
});
}

// 呼び出し例:たった1行で好きなレベルの通知が飛ばせる!
// postSlackNotify("売上目標達成!", "札幌オフィスの今月売上が120%を突破しました!", "SUCCESS");

プロ技③:夜間・休日の不要なメンション爆撃を防ぐ「おやすみ制御」

自動通知が便利だからといって、深夜2時や日曜日の朝に <!channel> で通知が鳴り響いたら、チームメンバーの休息を妨げてしまいますよね。
現在時刻をチェックし、営業時間外(例えば19時〜翌朝9時や土日)は全体メンションを外して静かに投稿する配慮を入れるのが、愛される社内ツールの秘訣です。

var now = new Date();
var hour = now.getHours();
var day = now.getDay(); // 0は日曜、6は土曜

// 平日の9時〜18時だけメンションをつける
var isBusinessHour = (day >= 1 && day <= 5) && (hour >= 9 && hour < 18);
var mention = isBusinessHour ? "<!channel> " : "";

8. 初心者が100%つまずく!Slack POST通信の5大トラップと完全対処法

Slack連携を実装する際、エンジニアが必ず一度は頭を抱える「典型的な5大トラップ」をまとめました。エラーが出たときはまずここを確認してください!

トラップ1:payload にオブジェクトをそのまま渡して「payload must be a string」エラー

// ✕ 超危険!絶対に動かないNGコード
var payload = { "text": "こんにちは" };
UrlFetchApp.fetch(url, {
"method": "post",
"payload": payload // オブジェクトのまま渡している!
});
// ➔ エラー: The parameters don't match the method signature for UrlFetchApp.fetch

【原因と解決策】
第95回で学んだ通り、UrlFetchApp.fetch の payload にJSONデータを渡すときは、必ず JSON.stringify(payload) を通して文字列化しなければなりません!「Slackへ送るときは必ず stringify で冷凍パックする!」と指差し確認しましょう。

トラップ2:contentType を書き忘れて「no_text」や「invalid_payload」と怒られる

"contentType": "application/json" を指定し忘れると、Slackは送られてきたデータが何なのか理解できず、ステータス400で missing_text_or_fallback_or_attachments などのエラーを返してきます。オプションの2行目には必ず contentType を書きましょう。

トラップ3:コードの中に Webhook URL を直書きしてセキュリティ事故

急いでいるからとコード内に var url = "https://hooks.slack.com/services/..." と直接書いてしまうと、コードをGitHubにプッシュした瞬間にSlackのセキュリティボットが検知し、安全のためにそのWebhook URLを自動で即座に無効化(破棄)してしまいます!
必ず本記事のSTEP1のように、PropertiesService(スクリプトプロパティ)を使って管理してください。

トラップ4:チャンネル名をコード側で上書きしようとして無視される

昔の古い解説記事を見ると、payloadの中に "channel": "#general" のように書いて投稿先を変更するコードが紹介されていることがあります。
しかし現在のSlackの新しい Incoming Webhook では、Webhook URLを発行したときに選んだチャンネル(今回は #sapporo-dashboard)へ固定で届く仕様 になっています。コード側でチャンネル名を指定しても無視されますので、別のチャンネルへ送りたい場合はチャンネルごとに新しい Webhook URL を発行しましょう。

トラップ5:大量のループの中で fetch を連打して相手からアクセス拒否(429 Too Many Requests)される

スプレッドシートの100行のデータをチェックし、エラーが見つかるたびに for ループの中で UrlFetchApp.fetch() を毎秒何十回も連続実行すると、Slackのサーバーから「通信が多すぎます!少し待ってください(429 Rate Limited)」と怒られて通信が遮断されてしまいます。
連続で通信を行う場合は、次回(第97回)で学ぶ「ウェイト制御(時間調整)」を入れるか、メッセージを1つにまとめてから1回だけ送信するように設計しましょう!

9. 今回のまとめ&次回予告

今回は、GASから外部のサーバーへデータを送信する UrlFetchApp.fetch() の POST通信 と、Slackの #sapporo-dashboard チャンネルへの自動通知・異常検知アラートの実装手法を徹底解説しました!

本日の重要ポイントおさらい

  1. UrlFetchApp.fetch(url, options) の POST通信 で、外部サーバーへデータをプッシュ送信できる!
  2. POSTオプションには method: "post"、contentType: "application/json"、payload: JSON.stringify(...) の3点セットが必須!
  3. Webhook URLはコードに直接書かず、第93回のスクリプトプロパティ(金庫) で厳重に守るのがプロの鉄則!
  4. Slackの Block Kit や attachments を活用すれば、見出し・枠線・ボタンのついたリッチなカード通知が自由自在に作れる!
  5. データの未入力や異常値、GASの例外エラー(try...catch)と連携させることで、トラブルを即座に感知するセーフティネット が完成する!

手作業でスプレッドシートを確認してチャットに報告していた日々から一歩進み、システムが勝手に働いて、結果や異常をSlackへスマートに報告してくれる――。まさに「全自動のお手伝いロボット」が札幌オフィスの頼もしい仲間になった瞬間ですね!

さて、外部APIへの送信ができるようになったところで、最後に残された「自動化の大敵」があります。
それが、トラップ5でも触れた「APIの連続呼び出しエラー(短時間での通信集中による制限)」です!

大量の取引先へ一括でSlack通知を送ったり、複数の外部APIを順番に呼び出したりするとき、プログラムがあまりにも速く走りすぎると、相手のサーバーから「アクセスが急激すぎます!」と拒絶されて処理が止まってしまうことがあります。

そこで次回(第97回)のテーマは、
「Utilities.sleep() × API連続呼び出し時のエラーを防ぐウェイト制御」 です!

プログラムに「意図的な休憩時間(ウェイト)」をスマートに挟み込むことで、サーバーの負荷を抑え、何百件ものAPI通信でも絶対に途中で落ちない頑丈なシステムへと最適化するテクニックを学びます。
残りわずかとなった連載ロードマップ、次回もぜひ楽しみに待っていてくださいね!