这是一份面向初学者的Email Trigger (IMAP)节点实战教程,重点介绍如何在n8n中快速配置IMAP邮件触发器,实现自动化邮件接收和处理。

Email Trigger (IMAP)节点是n8n中用于接收和监听邮件的触发器节点,它通过IMAP(Internet Message Access Protocol,互联网消息访问协议)协议连接到邮件服务器,实时监控你的邮箱收件箱,当有新邮件到达时,自动启动整个工作流。
与传统的手动邮件处理不同,这个节点让你能够:
这意味着你可以用"零代码"的方式构建强大的邮件自动化系统。

在配置之前,了解IMAP的几个关键要素很重要。IMAP是一种邮件协议,它让邮件客户端能够与远程邮件服务器通信。与POP3不同的是,IMAP支持在服务器上保留邮件副本,这样你可以在多个设备上同步你的邮箱。
| 邮件服务 | IMAP服务器 | 端口 | 安全类型 |
|---|---|---|---|
| Gmail | imap.gmail.com | 993 | SSL/TLS |
| Outlook | outlook.office365.com | 993 | SSL/TLS |
| QQ邮箱 | imap.qq.com | 993 | SSL/TLS |
| 企业邮箱 | imap.exmail.qq.com | 993 | SSL/TLS |
关键点:所有服务基本都使用端口993(SSL加密),这确保了邮件传输的安全性。
打开n8n并点击创建新工作流。由于Email Trigger是触发器节点,它必须是工作流的第一个节点。
在节点搜索框中输入"Email Trigger",选择**Email Trigger (IMAP)**节点。这个节点会自动成为工作流的起始点。
这是最关键的一步。点击节点的Credential to connect with参数,选择新增IMAP凭证:
Gmail配置示例:
Outlook配置示例:
QQ邮箱/企业邮箱配置示例:
配置完凭证后,设置以下关键参数:
邮箱名称(Mailbox Name): 通常填写INBOX(收件箱),特殊需求可设置其他文件夹
操作(Action):
下载附件(Download Attachments):
格式(Format): 这个参数决定了邮件返回的格式
在Force Reconnect Every Minutes中设置检查新邮件的频率。比如设置为1,则每分钟检查一次新邮件。
点击节点下方的Test step按钮,n8n会尝试连接到你的邮箱。如果配置正确,你会看到最近的邮件信息出现在预览窗口。
当Email Trigger节点成功接收到邮件时,邮件数据会按照以下结构输出,供后续节点使用:
{
"From": "发件人邮箱地址",
"To": "收件人邮箱地址",
"Subject": "邮件主题",
"text": "纯文本正文",
"html": "HTML格式正文",
"Date": "2025-01-15T10:30:00Z",
"MessageId": "邮件ID",
"attachments": "附件数组(如果启用下载)"
}这些数据可以通过表达式语法{{$json.字段名}}在后续节点中引用。
如果你只想接收特定条件的邮件,可以在Custom Email Rules参数中输入IMAP搜索条件。例如:
SUBJECT "订单" - 只接收主题包含"订单"的邮件FROM "boss@company.com" - 只接收来自特定邮箱的邮件UNSEEN - 只接收未读邮件SINCE 2025-01-01 - 只接收指定日期之后的邮件原因: 用户名或密码错误
解决方案:
原因: 邮箱中没有新邮件,或邮件已被标记为已读
解决方案:
原因: 未启用"Download Attachments"选项,或格式设置不对
解决方案:
通过学习Email Trigger (IMAP)节点,你已掌握了n8n邮件自动化的基础。这个节点的核心就是连接、监听、提取、传递 - 连接到IMAP服务器,监听新邮件,提取邮件数据,传递给后续节点处理。
记住这几个关键点:选择正确的IMAP服务器和端口(通常是993端口SSL)、获取正确的认证信息(特别是Gmail的应用专用密码)、设置合理的轮询间隔和邮件规则,你就能构建高效的邮件自动化系统。
[1] 官方文档: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.emailimap/
[2] n8n系列教程: https://www.undsky.com/blog/?category=n8n%E6%95%99%E7%A8%8B#