Initial commit: IMAP to LINE notification workflow

imap2line/IMAP_to_LINE_Notification_Setup_Guide.md

@@ -0,0 +1,106 @@
+# IMAPからLINEへの通知ワークフロー構築手順書
+
+このドキュメントでは、n8nを使用して「メール（IMAP）を受信し、LINE Messaging APIで通知する」ワークフローを構築する手順を説明します。
+この手順は、Docker環境で動作するn8nを前提としています。
+
+## 1. 前提条件
+
+*   **n8n環境**: n8n v1.0以上が動作していること。
+*   **メールサーバー情報**: IMAP接続が可能なメールサービスのホスト名、ポート、ユーザー名、パスワード（Googleの場合はアプリパスワード）。
+*   **LINE Messaging API**: LINE Developersコンソールでチャネルが作成され、アクセストークン（ロングターム推奨）とユーザーIDが取得済みであること。
+
+## 2. 準備: コミュニティノードのインストール
+
+標準のIMAPノードでは大量のメールを処理しきれない場合があるため、拡張機能であるコミュニティノードを使用します。
+
+1.  n8nの画面左下、または設定メニューから **[Settings]** > **[Community nodes]** を開きます。
+2.  **[Install a community node]** をクリックします。
+3.  以下のパッケージ名を入力し、インストールします。
+    *   Package Name: `n8n-nodes-imap-enhanced`
+    *   (承認が必要な場合はチェックを入れて進めてください)
+
+## 3. ワークフローのインポート
+
+添付のJSONファイル `n8n_imap_to_line_workflow.json` を使用すると、設定済みのワークフローを一括で読み込めます。
+
+1.  n8nのワークフロー一覧画面（Workflows）を開きます。
+2.  右上のメニューから **[Import from File]** を選択し、JSONファイルをアップロードします。
+3.  または、新規ワークフローを作成し、画面右上のメニューから **[Import from File]** を選択します。
+4.  インポート後、画面を一度リロード（F5）することを推奨します（コミュニティノードの表示を反映させるため）。
+
+## 4. ノードの設定詳細
+
+インポートされたワークフローには、主に3つのノードが含まれています。それぞれの設定を確認・修正してください。
+
+### A. Schedule Trigger
+定期的にメールチェックを行うトリガーです。
+*   **Interval**: デフォルトは3分間隔になっています。必要に応じて変更してください。
+
+### B. IMAP Enhanced (Community Node)
+メールを受信するノードです。
+
+*   **Credential**: [Create New] からメールサーバー情報を入力して保存してください。
+    *   Googleの場合: Userはメールアドレス、Passwordはアプリパスワードです。
+*   **Resource**: `Message` を選択。
+    *   ※もし空欄になっている場合は、一度別の項目を選んでから `Message` を選び直してください。
+*   **Operation**: `Get Many` を選択。
+*   **Mailbox**: `INBOX`
+*   **Format**: `Resolved`
+*   **Options（重要）**:
+    *   **Limit**: `10` 程度推奨（1回に処理する件数）。
+    *   **Search**: `UNSEEN SINCE 10-Feb-2026` のように設定します。
+        *   `UNSEEN`: 未読メールのみを対象。
+        *   `SINCE dd-Mon-yyyy`: 指定日以降のメールのみ対象（大量の過去メール読み込みを防ぐため必須）。
+    *   **Download Attachments**: `false`（動作を軽くするためOFF推奨）。
+
+### C. LINE Messaging API (HTTP Request)
+LINEに通知を送るノードです。
+
+*   **Method**: `POST`
+*   **URL**: `https://api.line.me/v2/bot/message/push`
+*   **Authentication**: `Header Auth` を選択。
+*   **Credential**: [Create New] から以下を設定します。
+    *   **Name**: `Authorization` (※スペルミス注意。スペース等は入れないこと)
+    *   **Value**: `Bearer {YOUR_ACCESS_TOKEN}` (先頭に `Bearer ` と半角スペースを入れる)
+*   **Body**: JSON形式で送信内容を定義しています。
+    *   `to`: あなたのLINEユーザーID (`U`から始まる文字列) に書き換えてください。
+
+## 5. 動作確認
+
+1.  画面下部の **[Execute Workflow]** をクリックします。
+2.  自分宛てにテストメールを送るなどして、未読メールがある状態で通知が届くか確認してください。
+3.  問題なければ、画面右上の **[Active]** スイッチをONにして保存してください。
+
+以上
+
+
+
+
+
+## 参考: CLI（コマンドライン）でのインポート方法
+
+今回の作業では、ブラウザを使わずにサーバー内部のコマンドだけでインポートを行いました。
+大量のワークフローを管理する場合や、自動化する場合に便利な方法です。
+
+### 1. サーバーへのファイル転送
+作成したJSONファイルを、サーバー上の任意の場所（例: `/home/akira/workflow.json`）に配置します。
+（ローカルPCから送る場合は `scp` コマンドなどを使用）
+
+### 2. Dockerコンテナへのコピー
+n8nが動作しているDockerコンテナの中に、そのファイルをコピーします。
+```bash
+docker cp /home/akira/workflow.json n8n-n8n-1:/home/node/workflow.json
+```
+*   `n8n-n8n-1`: n8nのコンテナ名（環境によって異なります）
+
+### 3. インポートコマンドの実行
+コンテナ内部の `n8n` コマンドを呼び出してインポートします。
+```bash
+docker exec -u node -i n8n-n8n-1 n8n import:workflow --input=/home/node/workflow.json
+```
+*   `import:workflow`: ワークフローをインポートするコマンド
+*   `--input`: 読み込むファイルのパス
+
+これで、IDが一致するワークフローがあれば上書きされ、なければ新規作成されます。
+
+以上