n8nのIMAP Emailノードのパラメータ設定方法について詳しく解説！
n8nのIMAP Email（EmailReadImap）ノードの解説をしたいと思います。
このノードはメール受信で使われるノードなのでよく使う機会がありますがまだ公式の説明があまり整っていません。
パラメータの設定で分かりにくい項目を説明したいと思います。
Mailbox Name
「Mailbox Name」パラメータは、受け取りたいメールボックス名を指定します。
初期値・・・INBOX
ここで指定する"メールボックス名"とは、実際にメールが保存されている場所を示す名前です。
「受信箱」や「送信済み」などメール操作画面に表示されている名前と必ずしも一致するとは限りません。
メールサーバーによって名前が異なるのでご自身の環境で調べて頂ければと思いますが、
参考によく使われている名前とその場合の書き方が下記になります。
| メールボックス名 | 示す場所 | 書き方例 |
|---|---|---|
| INBOX | 新規受信用のメールボックス | INBOX |
| Sent、Sent Mail | 送信済のメールボックス | INBOX.Sent INBOX/Sent |
| Drafts | 下書きのメールボックス | INBOX.Drafts INBOX/Drafts |
| Trash | 削除済のメールボックス | INBOX.Trash INBOX/Trash |
| Junk、Spam | 迷惑メールのメールボックス | INBOX.Spam INBOX/Spam |
接続する記号がサーバーによって異なる
INBOX以外を指定する場合に（INBOX.Sent）と「.」で繋いだり、（INBOX/Sent）と「/」で繋いだり、サーバーによって異なります。
大文字小文字に注意
INBOX以外は大文字小文字を間違うと取得出来ません。
メールサーバーの設定が「Sent」の場合「SENT」、「sent」どちらも取得出来ないので注意が必要です。
※Gmailは少し特殊なので下記を参考にしてください。
| メールボックス名 | 示す場所 | 書き方例 |
|---|---|---|
| INBOX | 受信トレイ | INBOX |
| すべてのメール | すべてのメール | [Gmail]/すべてのメール |
| 送信済みメール | 送信済み | [Gmail]/送信済みメール |
| 下書き | 下書き | [Gmail]/下書き |
| ゴミ箱 | ゴミ箱 | [Gmail]/ゴミ箱 |
| 重要 | 重要 | [Gmail]/重要 |
| 迷惑メール | 迷惑メール | [Gmail]/迷惑メール |
| スター付き | スター付き | [Gmail]/スター付き |
Custom email rules
「Custom email rules」パラメータは、取得する条件を指定します。
※「Add Option」で追加出来る設定です。
初期値・・・["UNSEEN"]
よく使う設定値です。
| 条件名 | 意味 | 書き方例 |
|---|---|---|
| ALL | すべてのメール | ["ALL"] |
| SEEN | 既読メール | [“SEEN”] |
| UNSEEN | 未読メール | ["UNSEEN"] |
| FROM | 差出人に含まれる文字から | [["FROM", "検索文字"]] |
| SUBJECT | 件名に含まれる文字から | [["SUBJECT", "検索文字"]] |
| TO | 宛先に含まれる文字から | [["TO", "検索文字"]] |
| CC | CCに含まれる文字から | [["CC", "検索文字"]] |
| BCC | BCCに含まれる文字から | [["BCC", "検索文字"]] |
| BODY | 本文に含まれる文字から | [[ "BODY", "検索文字"]] |
検索文字
検索文字に書いた文字が含まれていた場合、対象になります。
「abc@example.co.jp」が検索対象のメールの場合、
「example」、「abc@example.co.jp」どちらも条件に合うメールと取得されます
。
Custom email rulesの書き方例
1つの条件の場合
- 条件名だけ書く条件
条件. 既読済メール
["SEEN"]
- 条件名と検索文字を書く条件
条件. FROMがヤフーからのメール
[[“FROM”, “@yahoo.co.jp”]]
条件だけの場合と、指定した文字で検索する場合で書き方が異なります。 「[]」の数や「,」の位置に注意してください。
条件だけの場合
["条件名"]
条件と検索したい文字を入れる場合
[["条件名", "検索文字"]]
2つの条件の場合
- 両方の条件に一致
条件1. 既読済
条件2. yahooメールからのメール
["SEEN", ["FROM", "@yahoo.co.jp"]]
条件1. Gmail宛てのメール
条件2. 本文に「問合せ」が含まれている
[["TO", "@gmail"], ["BODY", "問合せ"]]
- どちらか一方の条件に一致
条件1. 未読
条件2. CCで「ichikawa@example.co.jp」にも送信
[['OR',"UNSEEN", ["CC", "ichikawa"]]]
どちらか一方でも条件に合えば取得したい場合は一番初めに「"OR"」を書いて、条件全体をもう一つ「[]」で囲まないといけません。
[["OR", ["一つ目の条件"], ["二つ目の条件"]]]
最後に
少し難しい設定ではありますが、自分に合った条件で設定出来るのでローコードのいい部分でもあると思います。
このn8nのIMAP Email（EmailReadImap）ノードでは裏側ではnode-imapという、node.js用のIMAPクライアントモジュールが使われています。
プログラミング経験がある方はオープンソースなのでnode-imapのREADMEを見てみてください。
