1. 内置节点
专属集成平台
  • 快速开始
    • 集成平台概览
  • 身份与用户管理
    • 用户管理
      • 用户与组织架构管理
    • 角色管理
      • 角色管理配置说明
    • 属性管理
      • 属性管理配置说明
      • IDAAS 扩展物理字段使用说明
    • 上游身份数据集成
      • 通讯录身份集成概述
      • 集成连接器配置指南
        • 通讯录集成-泛微
        • 通讯录集成-飞书
        • 通讯录集成-企业微信
        • 通讯录集成-AD
        • 通讯录集成-睿人事
        • 通讯录集成-北森
        • 通讯录集成-SCIM
        • 通讯录集成-用友EHR
        • 通讯录集成-Azure AD
        • 通讯录集成-致远
        • 通讯录集成-LDAP
        • 通讯录集成-数据库
        • 通讯录集成-钉钉
          • 基础说明
          • 钉钉集成连接器如何配置属性映射
      • 通过连接流实现身份集成
        • 在连接流画布中完成身份集成配置
      • 身份集成常见问题
        • 常见问题 & 排错指南
    • 下游身份数据同步
      • 通讯录同步概述
      • 同步连接器配置指南
        • 通讯录同步-企业微信
        • 通讯录同步-AD
        • 通讯录同步-用友U8C
        • 通讯录同步-钉钉
          • 基础说明
          • 如何配置部门职位扩展字段
      • 通过连接流实现身份同步
        • 使用连接流实现身份下游同步
      • 身份同步常见问题
        • 常见问题 & 排错指南
        • 使用代理网关进行身份同步
  • 认证源管理
    • 认证源基础说明
      • 认证源选型说明
      • 认证源管理概述
    • 认证源配置指南
      • 基础协议配置
        • 认证源-CAS协议
        • 认证源-OIDC协议
        • 认证源-OAuth2协议
      • 三方认证源配置手册
        • 认证源-钉钉
        • 认证源-AD
        • 认证源-飞书
        • 认证源-LDAP
        • 认证源-微信
        • 认证源-微信公众号
        • 认证源-Google Workspace
        • 认证源-AD Azure
        • 认证源-美云智数
        • 认证源-企业微信
  • 应用管理
    • 基础说明
      • 应用管理概述
      • 应用创建与配置
    • 应用单点登录
      • 单点登录概述
      • 单点登录配置
      • 单点登出配置
      • 授权范围配置
      • 自定义集成单点登录配置说明
      • 应用密码代填
      • 应用网关
      • 单点登录配置指南
        • 单点登录-OIDC
        • 单点登录-SAML协议
        • 单点登录-OAuth2
        • 单点登录-CAS协议
        • 单点登录-钉钉SSO
        • 单点登录-分贝通
        • 单点登录-用友NCC
        • 单点登录-宜搭
        • 单点登录-泛微OA
        • 单点登录-致远OA
        • 单点登录-金蝶云星空
        • 单点登录-中国电子云邮箱
        • 单点登录-阿里云控制台(RAM)
        • 单点登录-纷享销客应用
        • 单点登录-纷享销客待办
        • 单点登录-Exchange
        • Exchange-双入口配置指南
    • 应用授权管理
      • 应用授权概述
      • 基于组织架构和用户授权
      • 基于角色授权(RBAC)
      • 基于用户属性授权(ABAC)
      • 用户自主申请应用(OA审批授权)权限
    • 应用分发
      • 企业应用分发
      • ABM应用分发
    • 使用应用调用集成平台 OPENAPI
      • M2M接口授权
      • 接口调用权限配置说明
  • 连接中心
    • 产品概述
      • 什么是 AI 连接流
      • AI 连接流的典型使用场景
    • 基础功能
      • 流程运行日志
      • 功能概览
      • 如何创建 AI 工作流
      • 授权凭证管理
      • 错误处理
    • 节点说明
      • 节点基础类型说明
      • 数据处理节点
        • 文本处理节点
        • 数组处理
        • 数据集合节点
      • 文件处理节点
        • 「Base64 转 URL」动作说明
        • 「PPT分页切割」动作说明
      • 应用节点
        • Teambition
        • 金蝶云 K3Cloud
      • 内置节点
        • 子流程调用
        • 缓存处理
        • 分支节点
        • 循环执行
        • MYSQL 触发动作说明
        • 数字签名
        • Webhook触发
        • 缓存列表处理
        • 条件分支
        • FTP
        • 延时节点
        • 模型子节点
        • MCP SERVER 工具
        • 邮件发送
        • 存储子节点
        • 工具子节点
        • HTTP 请求
        • 变量节点
        • 加解密节点
        • 返回变量
      • 运维管理节点
        • 数据校验节点
      • AI节点
        • 构建你的第一个 AI Agent
        • AI 浏览器操作节点
        • AI Agent节点使用指南
        • AI 消息对话节点 & 组件嵌入
  • 审计日志
    • 管理员行为日志
    • 用户变更日志
    • 接口调用日志
    • 用户行为日志
    • 消息发送日志
  • 权限中心
    • 管理员账号管理
    • 管理员角色管理
  • 品牌设置
    • 登录页设置
      • 登录页面配置
      • 登录页CSS自定义页面样式
      • CSS定制页面内容:样式修改指南及故障排除
    • 短信设置
      • 短信模板配置
      • 短信服务使用及签名修改使用指南
      • 短信服务-自定义连接流配置
      • 阿里云短信网关配置指引
    • 邮件设置
      • 邮件模板配置
      • 通过自定义连接流发送邮件
      • SMTP 配置与测试支持文档
    • 企业消息设置
      • 企业消息配置
      • 企业消息(钉钉_飞书)配置
    • 分发页面设置
      • 分发页面设置
  • 平台设置
    • 功能概述
    • 授权管理
    • 代理网关
    • 授权信息
    • 登录策略配置
      • 弱密码检测功能说明
      • 登录流程配置
      • 自动登录功能配置
    • MFA 配置
      • MFA基础配置
      • 使用连接流自定义 MFA 策略
    • 运维日志
      • 运维日志下载
  • 最佳实践
    • AD-LDAP接入指南
    • 第三方平台应用创建指南
      • 钉钉
        • 钉钉全套集成指南
        • 创建钉钉开放平台应用
      • 飞书
        • 飞书全套集成指南
        • 创建飞书开放平台应用
      • 企微
        • 企业微信全套集成指南
        • 创建企业微信开放平台应用
  • 开放接口
    • 鉴权认证
      • 获取access_token(请求体方式)
      • 获取access_token(Basic认证方式)
    • 用户管理
      • 查询用户
      • 创建用户
      • 根据多个条件过滤并查询用户信息
      • 根据用户帐号获取用户信息
      • 修改用户
      • 启用/禁用用户
      • 删除用户
      • 修改用户密码
    • 组织部门
      • 获取组/部门的列表
      • 创建组/部门
      • 根据组/部门ID获取组/部门的信息
      • 修改组/部门
      • 删除组/部门
      • 根据组/部门ID获取下级组/部门信息
      • 过滤部门信息
    • 角色管理
      • 创建角色
      • 获取单个角色详情
      • 修改角色
      • 删除角色
      • 查询角色列表
      • 根据应用ID和用户ID获取角色列表
      • 查看角色所对应的用户列表
      • 给多个用户添加静态角色
      • 删除用户静态角色
      • 获取用户的角色信息
    • 连接中心
      • Webhook启动连接流
    • 事件通知
      • 连接器事件通知
  1. 内置节点

邮件发送

概述#

EmailActionHandler 是AI FLOW中的邮件发送处理器,支持发送文本和HTML格式的邮件,包括附件功能。通过配置SMTP服务器参数,可以实现自动化邮件通知、报表发送、告警提醒等业务场景。

功能特性#

多格式支持:支持文本和HTML格式邮件
附件功能:支持多个文件附件
抄送功能:支持多个抄送收件人
SMTP认证:支持SSL/TLS加密连接
错误处理:详细的邮件发送错误诊断
模板支持:支持动态内容替换

配置参数#

EmailAction#

账号配置#

accountId:邮箱账号ID
account:SMTP服务器配置(包含host、port、username、password等)

邮件内容#

from:发件人邮箱地址
to:收件人邮箱地址(多个用逗号分隔)
cc:抄送人邮箱地址(多个用逗号分隔)
subject:邮件主题
body:邮件正文内容
bodyFormat:正文格式(true为HTML,false为文本)
attachmentUrl:附件URL(多个用逗号分隔)

使用方法#

1. 发送文本邮件#

{
  "accountId": "email_account_001",
  "from": "sender@example.com",
  "to": "recipient@example.com",
  "subject": "系统通知",
  "body": "这是一封测试邮件",
  "bodyFormat": false
}

2. 发送HTML邮件#

{
  "accountId": "email_account_001",
  "from": "sender@example.com",
  "to": "recipient@example.com",
  "subject": "HTML报告",
  "body": "<h1>报告标题</h1><p>报告内容...</p>",
  "bodyFormat": true
}

3. 带抄送的邮件#

{
  "accountId": "email_account_001",
  "from": "sender@example.com",
  "to": "recipient@example.com",
  "cc": "cc1@example.com,cc2@example.com",
  "subject": "重要通知",
  "body": "请注意查看附件",
  "bodyFormat": false
}

4. 带附件的邮件#

{
  "accountId": "email_account_001",
  "from": "sender@example.com",
  "to": "recipient@example.com",
  "subject": "报表文件",
  "body": "请查收附件中的报表文件",
  "bodyFormat": false,
  "attachmentUrl": "https://example.com/report.pdf,https://example.com/chart.png"
}

5. 动态内容邮件#

{
  "accountId": "email_account_001",
  "from": "sender@example.com",
  "to": "${user.email}",
  "subject": "欢迎 ${user.name}",
  "body": "亲爱的${user.name},您的账号已激活",
  "bodyFormat": false
}

SMTP服务器配置#

EmailConfig参数#

smtpHost:SMTP服务器地址(如smtp.gmail.com)
smtpPort:SMTP端口(SSL通常465,TLS通常587)
starttls:是否启用STARTTLS(true为TLS,false为SSL)
username:邮箱账号
password:邮箱密码或授权码

常用配置示例#

Gmail配置#

{
  "smtpHost": "smtp.gmail.com",
  "smtpPort": 587,
  "starttls": true,
  "username": "your-email@gmail.com",
  "password": "your-app-password"
}

Outlook配置#

{
  "smtpHost": "smtp-mail.outlook.com",
  "smtpPort": 587,
  "starttls": true,
  "username": "your-email@outlook.com",
  "password": "your-password"
}

企业邮箱配置#

{
  "smtpHost": "mail.company.com",
  "smtpPort": 465,
  "starttls": false,
  "username": "user@company.com",
  "password": "password"
}

执行逻辑#

参数验证#

1.
验证邮箱格式和必填字段
2.
检查SMTP服务器配置
3.
验证附件URL可访问性

邮件构建#

1.
创建JavaMail会话
2.
设置邮件头信息(发件人、收件人、主题)
3.
处理抄送人列表
4.
设置正文内容和格式
5.
处理附件下载和添加

发送过程#

1.
建立SMTP连接
2.
进行身份认证
3.
发送邮件数据
4.
关闭连接并返回结果

输出结果#

EmailOutput结构#

{
  "result": true,
  "msg": "邮件发送成功"
}

成功响应#

{
  "result": true,
  "msg": "邮件发送成功"
}

失败响应#

{
  "result": false,
  "msg": "身份验证失败,用户名或密码错误"
}

附件处理#

支持格式#

图片文件(jpg、png、gif等)
文档文件(pdf、doc、xls等)
压缩文件(zip、rar等)
其他二进制文件

URL格式#

HTTP/HTTPS URL:https://example.com/file.pdf
多个附件:url1,url2,url3

文件名处理#

自动从URL提取文件名
支持中文文件名
避免文件名冲突

错误处理#

常见错误类型#

1.
认证失败:用户名或密码错误
2.
连接失败:SMTP服务器不可达
3.
邮箱格式错误:发件人或收件人格式不正确
4.
附件下载失败:附件URL不可访问
5.
内容过大:邮件大小超过服务器限制

错误码映射#

535:身份验证失败
553:邮箱格式错误
550:收件人不存在
552:邮箱空间不足
421:服务暂时不可用

高级功能#

模板引擎#

支持使用变量替换创建动态邮件:
{
  "subject": "订单 ${order.id} 确认",
  "body": "尊敬的${customer.name},您的订单${order.id}已确认,总金额${order.amount}元"
}

批量发送#

结合循环节点实现批量邮件发送:
Loop (遍历用户列表)
├── EmailAction (发送个性化邮件)
└── SleepAction (控制发送频率)

发送频率控制#

配置发送间隔避免被识别为垃圾邮件:
{
  "rateLimit": {
    "maxPerMinute": 10,
    "delayMs": 6000
  }
}

最佳实践#

1. 邮件配置#

使用专用邮件账号
配置正确的SMTP参数
启用SSL/TLS加密

2. 内容设计#

简洁明了的主题
合适的正文格式
合理的附件大小

3. 错误处理#

实现重试机制
记录发送失败详情
提供备用通知方式

4. 合规要求#

添加退订链接
遵守反垃圾邮件法
保护用户隐私

调试和监控#

发送日志#

邮件发送详情记录
附件处理过程
SMTP会话信息

成功率监控#

发送成功率统计
平均发送时间
错误类型分布

常见问题#

Q: 如何发送HTML格式邮件?#

A: 设置bodyFormat为true,并使用HTML标签编写body内容。注意确保HTML语法正确。

Q: 支持多少个附件?#

A: 理论上没有限制,但建议不超过5个附件。单个附件最大10MB,总大小不超过25MB。

Q: 如何处理抄送多个收件人?#

A: 在cc字段中使用逗号分隔多个邮箱地址,如"cc1@example.com,cc2@example.com"。

Q: 邮件发送失败怎么排查?#

A: 检查SMTP配置、邮箱密码、收件人地址格式。查看错误日志获取具体失败原因。

Q: 支持定时发送吗?#

A: 节点本身不支持定时,可以结合Cron触发器或Sleep节点实现定时发送功能。

Q: 如何自定义邮件模板?#

A: 可以在流程中预先准备邮件内容模板,然后通过变量替换实现个性化发送。
修改于 2026-05-07 01:44:57
上一页
MCP SERVER 工具
下一页
存储子节点
Built with