メール返信の半自動化
— Slackで承認して、Gmailに下書きを作る

1実現したいこと（ゴール）

要望を分解すると、こういう体験を作りたい。

• 運用時に触るのはSlackだけ（メールは開かなくていい）。最終確認はGmailの下書きで。
• AIが勝手に送信はしない。あくまで「下書きまで」＝安全側の設計。
• Slackで「修正して」と言えば作り直してくれる対話ループが欲しい。

2最初の結論：ChatGPTサブスクの壁

理由は3つ。いずれもサブスクのGUI機能の設計上の限界。

• イベントで起動できない — ChatGPTの自動実行「Scheduled Tasks」は時刻ベースの定期実行のみ。「メールが来た瞬間」で発火できず、最短1時間間隔・通知止まり。Custom GPTのActionsも「会話の中でユーザーが頼んだ時」に動くもので、外部イベントで起動する入口を持たない。
• GUIを外部から叩けない — Zapier等の「ChatGPT連携」は、すべて裏で別課金のOpenAI APIを呼んでいる。サブスクのChatGPT画面をプログラムから操作する公式APIは存在しない。
• 非公式ブラウザ操作はNG — ChatGPT画面を自動操作するのはOpenAI利用規約違反（アカウント停止リスク）＋UI変更で壊れやすく、業務基盤にならない。

出典: OpenAI Help (Billing settings in ChatGPT vs Platform / Tasks in ChatGPT / ChatGPT agent) ・ Zapier Help (ChatGPT on Zapier) ・ OpenAI Terms of Use ・ OpenAI API Pricing。一部は二次情報で相互裏付け（公式原文はアクセス制限で一部未確認）。

3全体アーキテクチャ

どの手段でも、登場人物は同じ。違うのは「何が全体をつなぐか（オーケストレータ）」だけ。

┌────────────┐   新着検知    ┌──────────────────┐   本文を渡す   ┌──────────────┐
│   Gmail    │ ───────────▶ │  オーケストレータ  │ ───────────▶ │   AI (LLM)   │
│ (受信箱)   │  push/polling │ Zapier/Make/n8n/  │              │ OpenAI API 等 │
└────────────┘               │ AppsScript/自前   │ ◀─────────── │  返信案を返す │
      ▲                      └────────┬─────────┘   下書き文     └──────────────┘
      │ drafts.create                 │
      │ (下書き保存)                    │ Block Kit（OK / 修正 ボタン・スレッド返信）
      │                               ▼
┌─────┴──────┐   承認/修正指示  ┌──────────────┐
│   Gmail    │ ◀────────────  │    Slack     │  ← 運用者が触るのはここだけ
│  下書き    │                └──────────────┘
└────────────┘

• Gmail新着検知：ポーリング（定期チェック、遅延1分〜）か、push（watch+Pub/Sub、遅延数秒）。
• AI：OpenAI API（gpt-4o-mini等）またはClaude。ここがサブスクではなくAPI。
• Slack承認：Block Kitのボタン/スレッド返信。押下・返信を受けるにはSlackからのHTTPを受ける口が要る（SaaSは肩代わりしてくれる）。
• Gmail下書き：users.drafts.create（最小スコープ gmail.compose）。送信はしない。

4実装手段の比較（5パターン）

共通事項：AI生成ステップは全手段で別途必要（LLM課金は上の月額とは別）。「送信せず下書き保存」は全手段で可能。Slackのボタン待ちには必ずSlackからのHTTPを受けるエンドポイントが要る（Zapierは内部で肩代わり）。出典: Zapier / Make / n8n / Google Workspace / Slack 各公式ドキュメント。

5技術ポイント3点

6推奨構成

7コスト早見

8セキュリティ・権限の注意

• AIには「下書きまで」しか許可しない。送信スコープ（gmail.send）は付けない。gmail.composeのみなら万一暴走しても勝手に送信されない。
• メール本文を外部AIに渡す点に留意。機微情報を含むメールは対象から外す（送信元/ラベルでフィルタ）設計を推奨。
• Slack Interactivityは署名検証必須（X-Slack-Signature）。自前実装時は必ず検証する。
• OAuthのリフレッシュトークン・APIキーは秘密情報として安全に保管（Workers Secrets / Script Properties 等）。

9今すぐ試せる版（このデモ）

デモ構成（Claude Code常駐型）：

• 運用者が触るのはSlackだけという要望をそのまま満たす。
• 本番用にAIを「ChatGPT/OpenAI API」に差し替え、常駐を「Zapier/Workers」に置き換えれば、上の推奨構成になる。仕組みは全く同じ。
• このリポジトリでは、実際に受信メールを1件読み、返信下書きを生成して gmail.drafts.create でGmailに保存するところまでを実演する。