【業務効率化】GAS×ChatGPTでGmail返信を自動化する方法

// PropertiesServiceからAPIキーを安全に取得
const apiKey = PropertiesService.getScriptProperties().getProperty('OPENAI_API_KEY');

/**
 * ChatGPT APIを呼び出す基本関数
 * @param {string} prompt - ユーザーのプロンプト（質問・指示）
 * @param {string} systemMessage - システムプロンプト（AIの役割設定）
 * @return {string} ChatGPTからの応答テキスト
 */
function callChatGPT(prompt, systemMessage) {
  // PropertiesServiceからAPIキーを安全に取得
  const apiKey = PropertiesService.getScriptProperties().getProperty('OPENAI_API_KEY');
  const apiUrl = 'https://api.openai.com/v1/chat/completions';

  // デフォルトのシステムプロンプト
  if (!systemMessage) {
    systemMessage = 'あなたはプロフェッショナルなメール返信アシスタントです。丁寧で簡潔な日本語の返信を作成してください。';
  }

  // APIリクエストのペイロード（送信データ）
  const payload = {
    model: 'gpt-4o-mini',
    messages: [
      { role: 'system', content: systemMessage },
      { role: 'user', content: prompt }
    ],
    temperature: 0.7,
    max_tokens: 1000
  };

  // HTTPリクエストのオプション設定
  const options = {
    method: 'post',
    contentType: 'application/json',
    headers: {
      'Authorization': 'Bearer ' + apiKey
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };

  // APIを呼び出して結果を取得
  const response = UrlFetchApp.fetch(apiUrl, options);
  const responseCode = response.getResponseCode();
  const json = JSON.parse(response.getContentText());

  // エラーチェック
  if (responseCode !== 200) {
    throw new Error('API Error (' + responseCode + '): ' + (json.error ? json.error.message : 'Unknown error'));
  }

  return json.choices[0].message.content;
}

/**
 * リトライロジック付きAPI呼び出し
 * レート制限（429）やサーバーエラー（5xx）時に自動リトライ
 * @param {string} prompt - ユーザーのプロンプト
 * @param {string} systemMessage - システムプロンプト
 * @param {number} maxRetries - 最大リトライ回数（デフォルト3）
 * @return {string} ChatGPTからの応答テキスト
 */
function callWithRetry(prompt, systemMessage, maxRetries) {
  maxRetries = maxRetries || 3;

  for (var i = 0; i < maxRetries; i++) {
    try {
      var result = callChatGPT(prompt, systemMessage);
      return result;
    } catch (e) {
      // レート制限エラーまたはサーバーエラーの場合はリトライ
      if ((e.message.indexOf('429') !== -1 || e.message.indexOf('500') !== -1)
          && i < maxRetries - 1) {
        // 指数バックオフ：10秒、20秒、30秒と待機時間を増加
        var waitTime = (i + 1) * 10000;
        Logger.log('リトライ ' + (i + 1) + '/' + maxRetries + ' - ' + waitTime / 1000 + '秒待機');
        Utilities.sleep(waitTime);
      } else {
        // リトライ回数を超えた場合はエラーをスロー
        Logger.log('API呼び出し失敗: ' + e.message);
        throw e;
      }
    }
  }
}

// テスト用関数：ChatGPT APIの動作確認
function testChatGPT() {
  var response = callChatGPT('こんにちは。テストメッセージです。短く返信してください。');
  Logger.log('APIレスポンス: ' + response);
}

// ========================================
// パターン1：スター付き＋未読メール（推奨）
// 手動でスターを付けたメールだけをAIに処理させる安全な方式
// ========================================
function getTargetEmails_Pattern1() {
  var threads = GmailApp.search('is:starred is:unread', 0, 10);
  Logger.log('スター付き未読メール: ' + threads.length + '件');
  return threads;
}

// ========================================
// パターン2：特定ラベルのメール
// 「要返信」などのラベルを付けたメールを処理
// ========================================
function getTargetEmails_Pattern2() {
  var label = GmailApp.getUserLabelByName('要返信');
  if (!label) {
    Logger.log('「要返信」ラベルが存在しません。先にGmailでラベルを作成してください。');
    return [];
  }
  var threads = label.getThreads().slice(0, 10);
  Logger.log('「要返信」ラベル付きメール: ' + threads.length + '件');
  return threads;
}

// ========================================
// パターン3：件名パターンでフィルタ
// 「お問い合わせ」などの件名を含むメールを自動処理
// ========================================
function getTargetEmails_Pattern3() {
  var threads = GmailApp.search('subject:お問い合わせ is:unread', 0, 10);
  Logger.log('お問い合わせ関連の未読メール: ' + threads.length + '件');
  return threads;
}

// ========================================
// パターン4：特定の送信者からのメール
// 重要顧客や取引先からのメールだけを優先処理
// ========================================
function getTargetEmails_Pattern4() {
  var threads = GmailApp.search('from:customer@example.com is:unread', 0, 10);
  Logger.log('特定送信者からの未読メール: ' + threads.length + '件');
  return threads;
}

// スレッドからメールデータを抽出するサンプル
function extractEmailData() {
  var threads = GmailApp.search('is:starred is:unread', 0, 5);

  threads.forEach(function(thread) {
    var messages = thread.getMessages();
    var lastMessage = messages[messages.length - 1]; // 最新のメッセージ

    var subject = lastMessage.getSubject();     // 件名
    var body = lastMessage.getPlainBody();       // 本文（プレーンテキスト）
    var from = lastMessage.getFrom();            // 差出人
    var date = lastMessage.getDate();            // 受信日時

    Logger.log('件名: ' + subject);
    Logger.log('差出人: ' + from);
    Logger.log('本文（先頭200文字）: ' + body.substring(0, 200));
    Logger.log('---');
  });
}

/**
 * メイン関数：スター付き未読メールにAI返信の下書きを作成
 * トリガーで5分おきに自動実行する想定
 */
function autoReplyToEmails() {
  var threads = GmailApp.search('is:starred is:unread', 0, 10);

  if (threads.length === 0) {
    Logger.log('処理対象のメールはありません。');
    return;
  }

  Logger.log('処理対象: ' + threads.length + '件のメールスレッド');
  var successCount = 0;
  var errorCount = 0;

  threads.forEach(function(thread) {
    try {
      var messages = thread.getMessages();
      var lastMessage = messages[messages.length - 1];

      var subject = lastMessage.getSubject();
      var body = lastMessage.getPlainBody();
      var from = lastMessage.getFrom();

      // メール本文が長すぎる場合は先頭2000文字に制限（トークン節約）
      if (body.length > 2000) {
        body = body.substring(0, 2000) + '\n...(以下省略)';
      }

      // ChatGPTで返信文を生成（リトライロジック付き）
      var replyText = generateReply(subject, body, from);

      // 下書きとして保存（直接送信はしない）
      lastMessage.createDraftReply(replyText);
      Logger.log('[成功] 下書き作成: ' + subject);

      // スターを外して処理済みにする
      messages.forEach(function(msg) { msg.unstar(); });

      successCount++;

      // APIレート制限対策：メール間に2秒の間隔
      Utilities.sleep(2000);

    } catch (e) {
      Logger.log('[エラー] ' + lastMessage.getSubject() + ': ' + e.message);
      errorCount++;
    }
  });

  Logger.log('処理完了 - 成功: ' + successCount + '件, エラー: ' + errorCount + '件');
}

/**
 * ChatGPT APIを使ってメールの返信文を生成する
 * @param {string} subject - メールの件名
 * @param {string} body - メールの本文
 * @param {string} from - 差出人のメールアドレス
 * @return {string} 生成された返信文
 */
function generateReply(subject, body, from) {
  var systemMessage = 'あなたはプロフェッショナルなビジネスメール返信アシスタントです。\n'
    + '以下のルールに従って返信文を作成してください：\n'
    + '- 丁寧な「です・ます調」の日本語で書く\n'
    + '- 簡潔に、3〜5文程度で回答する\n'
    + '- 相手の質問や依頼に正確に答える\n'
    + '- 曖昧な部分は確認の質問を含める\n'
    + '- 署名は含めない（後で手動追加するため）';

  var prompt = '以下のメールに対して、適切な返信文を作成してください。\n\n'
    + '【件名】' + subject + '\n'
    + '【差出人】' + from + '\n'
    + '【本文】\n' + body + '\n\n'
    + '返信文のみを出力してください。挨拶から始めてください。';

  return callWithRetry(prompt, systemMessage);
}

/**
 * トリガーをコードから設定する関数
 * ※一度だけ手動実行してください
 */
function createTimeTrigger() {
  // 既存のトリガーを削除（重複防止）
  var triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(function(trigger) {
    if (trigger.getHandlerFunction() === 'autoReplyToEmails') {
      ScriptApp.deleteTrigger(trigger);
    }
  });

  // 5分おきのトリガーを新規作成
  ScriptApp.newTrigger('autoReplyToEmails')
    .timeBased()
    .everyMinutes(5)
    .create();

  Logger.log('トリガーを設定しました：autoReplyToEmails を5分おきに実行');
}

// 用途別システムプロンプトの例

// ■ カスタマーサポート向け
var csSystemPrompt = 'あなたは株式会社〇〇のカスタマーサポート担当です。\n'
  + '丁寧で共感的な対応を心がけ、以下のルールに従ってください：\n'
  + '- 問い合わせへのお礼から始める\n'
  + '- 問題の内容を要約して確認する\n'
  + '- 具体的な解決策を提示する\n'
  + '- 解決できない場合は「担当部署からご連絡します」と伝える\n'
  + '- 200文字以内で回答する';

// ■ フリーランス向け
var freelanceSystemPrompt = 'あなたはフリーランスのWebデザイナーのメールアシスタントです。\n'
  + '以下のルールに従って返信を作成してください：\n'
  + '- カジュアルすぎず、堅すぎないビジネス敬語\n'
  + '- 見積もり依頼には概算と詳細ヒアリングの提案を含める\n'
  + '- スケジュール確認が必要な場合は「確認後ご連絡します」と伝える\n'
  + '- 料金や納期は具体的な数字を含めない（後で人間が調整）';

// ■ 社内コミュニケーション向け
var internalSystemPrompt = 'あなたは社内メールの返信アシスタントです。\n'
  + '社内メールなので、過度に丁寧な表現は不要です。\n'
  + '- 簡潔に、要点のみ回答\n'
  + '- 「承知しました」「対応します」など明快な表現を使う\n'
  + '- 質問には直接的に回答する\n'
  + '- 100文字以内で回答する';

/**
 * メールの内容をAIで分類し、カテゴリに応じた処理を行う
 * カテゴリ：問い合わせ / 見積もり依頼 / スケジュール調整 / お礼 / その他
 */
function classifyAndSummarizeEmails() {
  var threads = GmailApp.search('is:unread', 0, 20);

  threads.forEach(function(thread) {
    var messages = thread.getMessages();
    var lastMessage = messages[messages.length - 1];
    var body = lastMessage.getPlainBody();
    var subject = lastMessage.getSubject();

    // Step1: ChatGPTでメールを分類
    var classifyPrompt = '以下のメールを分類してください。\n'
      + 'カテゴリ：問い合わせ / 見積もり依頼 / スケジュール調整 / お礼 / その他\n'
      + '回答はカテゴリ名のみを1行で出力してください。\n\n'
      + '件名: ' + subject + '\n本文:\n' + body.substring(0, 1000);

    var category = callChatGPT(classifyPrompt).trim();
    Logger.log('分類結果: ' + subject + ' → ' + category);

    // Step2: 分類結果に基づいてラベルを付与
    var label = GmailApp.getUserLabelByName(category)
                || GmailApp.createLabel(category);
    thread.addLabel(label);

    // Step3: カテゴリに応じた返信処理（必要に応じて実装）
    if (category === '問い合わせ' || category === '見積もり依頼') {
      // 重要なメールは下書き返信を生成
      var reply = generateReply(subject, body, lastMessage.getFrom());
      lastMessage.createDraftReply(reply);
    }

    Utilities.sleep(2000);
  });
}