【Gmail】Google Apps ScriptでGmailの特定ラベルをSlackに通知する方法

2026/07/11

Gmail で特定のラベルが付いたメールだけを Slack に流したい時があります。
たとえば「問い合わせ」「障害連絡」「重要」などのラベルだけを通知すれば、メールをずっと開いていなくても見逃しにくくなります。

今回は、Google Apps Script（GAS）を使って、Gmail の特定ラベルを Slack に通知するシンプルな方法をまとめます。

事前準備

先に Slack 側で Incoming Webhook を作成しておきます。
Webhook URL が発行されたら、そのURLに対して JSON を POST するだけでメッセージを送れます。

GAS 側では、Gmail のラベル名と Webhook URL を用意しておきます。

サンプルコード

function postLabeledGmailToSlack() {
  const labelName = '重要';
  const doneLabelName = 'slack_posted';
  const webhookUrl = 'https://hooks.slack.com/services/XXXXX/XXXXX/XXXXX';

  const label = GmailApp.getUserLabelByName(labelName);
  if (!label) return;

  let doneLabel = GmailApp.getUserLabelByName(doneLabelName);
  if (!doneLabel) {
    doneLabel = GmailApp.createLabel(doneLabelName);
  }

  const threads = label.getThreads(0, 20);

  threads.forEach(thread => {
    const messages = thread.getMessages();
    const lastMessage = messages[messages.length - 1];

    const subject = thread.getFirstMessageSubject();
    const from = lastMessage.getFrom();
    const body = lastMessage.getPlainBody().slice(0, 200);
    const permalink = thread.getPermalink();

    const payload = {
      text:
        'Gmail通知\n' +
        '件名: ' + subject + '\n' +
        '送信者: ' + from + '\n' +
        '本文抜粋: ' + body + '\n' +
        'リンク: ' + permalink
    };

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

    thread.addLabel(doneLabel);
  });
}

コードのポイント

GmailLabel では、ラベルが付いたスレッドを getThreads() または getThreads(start, max) で取得できます。
大量に処理する可能性があるなら、範囲指定できる getThreads(start, max) のほうが扱いやすいです。

また、GmailThread では getMessages() でメッセージ一覧が取れます。
件名は getFirstMessageSubject()、最新時刻は getLastMessageDate()、スレッドのリンクは getPermalink() で取れるので、通知文を組み立てやすいです。