发送邮件
  sendEmail组件:发送邮件组件。用于发送HTML或纯文本格式的电子邮件,支持多个收件人、抄送、密送,以及TLS加密连接。组件支持使用模板变量动态生成邮件主题和内容。
# 配置
| 字段 | 类型 | 说明 | 默认值 | 
|---|---|---|---|
| smtpHost | string | SMTP服务器地址,如smtp.gmail.com | 无 | 
| smtpPort | int | SMTP服务器端口,如587(TLS)或465(SSL) | 无 | 
| username | string | SMTP认证用户名/邮箱地址 | 无 | 
| password | string | SMTP认证密码或应用专用密码 | 无 | 
| enableTls | bool | 是否启用TLS加密连接 | false | 
| 邮件内容配置,详见下方Email配置表 | 无 | 
# Email配置
| 字段 | 类型 | 说明 | 默认值 | 
|---|---|---|---|
| from | string | 发件人邮箱地址,建议与username保持一致 | 无 | 
| to | string | 收件人邮箱列表,多个地址用英文逗号分隔 | 无 | 
| cc | string | 抄送邮箱列表,多个地址用英文逗号分隔 | 无 | 
| bcc | string | 密送邮箱列表,多个地址用英文逗号分隔 | 无 | 
| subject | string | 邮件主题,支持使用组件配置变量进行变量替换 | 无 | 
| body | string | 邮件正文内容,支持HTML格式,可使用组件配置变量进行变量替换 | 无 | 
配置说明
- 主流邮件服务商都需要使用授权码而非登录密码,请在对应服务商处获取授权码
 - 使用TLS加密时需正确配置smtpPort(一般为587)和enableTls=true
 - subject和body支持使用${metaKeyName}语法引用metadata中的值
 - body支持HTML标签实现富文本格式
 
# Relation Type
Success: 以下情况消息发送到
Success链路:- 邮件成功发送到所有收件人
 - SMTP服务器确认接收邮件
 
Failure: 以下情况消息发送到
Failure链路:- SMTP连接失败
 - 认证失败
 - 发送超时
 - 收件人地址无效
 - 邮件内容格式错误
 
# 执行结果
组件执行时:
- 不会修改原始消息的msg.Data内容
 - 不会修改原始消息的metadata内容
 - 发送失败时会在metadata中添加error字段描述错误信息
 
# 配置示例
  {
    "id": "s1",
    "type": "sendEmail",
    "name": "发送邮件",
    "configuration": {
      "smtpHost": "smtp.163.com",
      "smtpPort": 25,
      "username": "xxx@163.com",
      "password": "authorize code",
      "email": {
        "from": "xxx@163.com",
        "to": "xxx@163.com,aaa@hotmail.com",
        "cc": "bbb@hotmail.com",
        "subject": "测试邮件3",
        "body": "<b>测试内容3</b>"
      }
    }
  }
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 应用示例
无
在 GitHub 上编辑此页  (opens new window)
  上次更新: 2025/09/03, 10:09:04