加载中…

发件邮箱

发件邮箱用来接入你自己的 SMTP 邮箱。工作流邮件节点发出的邮件,发件人是发件箱的「显示名」加账号地址,邮件从你自己的邮箱服务器发出,用量和额度也由你自己的邮箱与本页的日额度共同控制。

入口、权限与套餐

  • 入口:系统管理 → 系统设置 → 发件邮箱分区。
  • 所需权限:「发件邮箱 · 管理」(权限键 mail-sender),依赖「系统设置」权限。该权限涉及邮箱账号密码、并以企业邮箱名义发信,不包含在「全部标准功能」里,需在 系统管理 → 用户管理 → 权限角色 中单独勾选。只有「系统设置」权限而没有此权限的账号,看不到「发件邮箱」分区。
  • 套餐:Pro 及以上。每个租户的发件箱数量上限为 Pro 3 个、Ultra 10 个(含已停用的),Lite 不支持。
  • 在工作流画布里只想选择发件箱的同事,具备「工作流 · 编辑」即可看到发件箱的名称与发件地址,看不到主机、端口、密码,也不能增删改发件箱。

添加发件箱

  1. 在「发件邮箱」分区点「添加发件邮箱」,打开右侧抽屉。
  2. 填写基本信息:名称(备注名,最多 30 字,同一租户内不重复)、显示名(收件人看到的发件人名称,最多 50 字,不含换行与尖括号)。
  3. 填写 SMTP 服务器:主机、端口、加密方式。
  4. 填写登录凭据:账号(必须是邮箱地址,发件地址固定为这个账号)、密码或授权码。
  5. 填写每日额度(1~100000 的整数),点「保存」。

主流邮箱需要用授权码,而不是登录密码。 企业邮箱、QQ 邮箱、163 邮箱等通常要先在邮箱后台开启 SMTP 服务并生成「授权码」,再把授权码填到「密码或授权码」里。填登录密码通常会提示认证失败。

端口与加密方式

加密方式 常用端口 说明
SSL 直连 465 连接一开始就加密
STARTTLS 587 先明文握手再升级为加密
  • 端口只允许 25、465、587、2525,填其他端口会保存失败。
  • 不提供「不加密」选项。
  • 连接时一律校验服务器证书(证书不受信任、已过期或主机名不符都会拒绝连接),不支持自签证书的邮箱服务,也没有「忽略证书错误」选项。
  • 主机必须能解析到公网地址;填写内网、本机地址,或解析结果里含内网地址的域名,会被拒绝。

编辑与密码

  • 编辑时密码框显示「已设置,留空表示不修改」。只改名称、显示名、加密方式或额度时可留空。
  • 修改主机、端口或账号任一项时,必须同时重新填写密码,否则保存失败。
  • 密码加密保存,列表与详情都不会返回密码,只显示「是否已设置」。
  • 编辑时只有主机发生变化才会重新解析校验主机;测试邮件与每次实际发送前,都会再校验一次主机。

测试邮件

在发件箱行内点测试图标(鼠标悬停显示「测试」),填一个收件地址发送。成功显示「已发送」,失败显示失败类别。编辑同样是图标,悬停显示「编辑」。

  • 每个发件箱每小时最多测试 5 次(按滚动 1 小时计算,失败的测试也计数),超过后请稍后再试。
  • 测试邮件标题与正文为固定文案,不能自定义,不占用日额度。
  • 停用的发件箱不能测试,请先启用。

默认发件箱

  • 每个租户至多一个默认发件箱。邮件节点选「默认发件箱」时,使用它发送。
  • 租户当前没有默认、又新增了一个发件箱时,新增的这个自动成为默认。「启用」不会触发自动设默认。
  • 只有已启用的发件箱可以设为默认;设新默认时,原默认同时取消。
  • 默认发件箱被停用或删除后,租户没有默认,系统不会自动指定别的,列表上方会提示「当前没有默认发件箱」,需要手动选一个设为默认。停用后重新启用的发件箱也不会自动恢复为默认。
  • 上线前请先配置默认发件箱。 已有的、没有选发件箱的邮件节点,按「默认发件箱」解析;租户没有默认发件箱时,这些节点发送会失败,不会自动创建发件箱,也不会回退到别的发件方式。

日额度

  • 每个发件箱各设日额度,互不影响;单个发件箱单日上限 100000,不能超过。
  • 一封邮件无论多少收件人,占 1 个单位。
  • 按北京时间自然日计数,次日 0 点重新计数。
  • 发送前先占用额度,用完后邮件节点失败,原因为「发件箱当日额度已用完」,没有邮件发出。
  • 明确没有发出去的失败(见下文「常见错误」)会回补额度;已发送与「结果不确定」的不回补。
  • 调高额度即时生效;调低到低于今日已发数时允许保存,今日已发数不变,当日后续发送被拒。
  • 列表的「日额度 / 今日已发」显示当日计数。

停用、启用与删除

  • 停用:该发件箱不能再被邮件节点用来发送,配置保留;可随时重新启用。
  • 删除:删除前会二次确认,引用它的已发布工作流邮件节点将无法发送(原因为「发件箱不存在」);删除后密码一并清除,不可恢复。历史执行记录里保留发件箱名称,不会因删除而丢失。发件箱编号不复用,删除后再建同名发件箱,不会被旧节点误用。

套餐降级后的行为

  • Pro 与 Ultra 之间降级、超出数量上限时:已有发件箱保留且可用,不能再新增,删除到上限内后可新增。
  • 降级到 Lite 后:已有发件箱保留,「发件邮箱」分区仍可查看,可编辑、停用、启用、删除;不能新增、设默认、发测试邮件,邮件节点不能发送,失败原因为「套餐不支持发件邮箱」。
  • 升级回 Pro 及以上后,保留的发件箱恢复可用。

邮件节点怎么选发件箱

在工作流画布的「发消息 → 邮件」节点里,有「发件箱」下拉:

  • 第一项「默认发件箱」,默认选中,显示当前默认是哪一个。
  • 其后是本租户已启用的发件箱(名称与发件地址);已停用的灰显不可选。
  • 发件箱引用只能是发件箱编号或留空(留空即默认发件箱),不支持引用上游步骤的值,否则发布会被阻断并提示改选。
  • 节点选了具体发件箱,而它已停用或已删除:保存草稿允许,发布被阻断,请改选。
  • 节点选「默认发件箱」而租户当前没有默认:发布不阻断,只提示「当前没有默认发件箱,发送将失败」。
  • 试运行只模拟,不发真实邮件、不占额度,结果里显示将使用的发件箱名称与发件地址。
  • 工作流被克隆或经智能广场被他人克隆时,邮件节点的发件箱引用会清空,改为「默认发件箱」。

常见错误

提示 含义与处理
认证失败,请检查账号和授权码 账号或授权码不对;多数邮箱要用授权码而不是登录密码,并需先在邮箱后台开启 SMTP
证书或加密方式错误 加密方式与端口不匹配(例如 465 选了 STARTTLS),或服务器证书不受信任、已过期、主机名不符;自签证书不支持。主机名不符时,测试结果会列出证书上的名称,请改成这些名称所覆盖的主机
无法连接邮件服务器 主机无法解析、主机或端口填错,或服务器拒绝连接
发件箱配置无法使用 主机格式不合法或解析到了不允许的地址、端口不受支持,或保存的密码无法解密;请检查配置,必要时重新填写密码
连接超时 连接或握手阶段超时,邮件未发出,可重试
收件人被服务器拒绝 所有收件人都被服务器拒绝,邮件未发出;部分收件人被拒、部分被接受,按「已发送」处理,执行记录会标注部分收件人被拒
结果不确定,系统不会自动重发,请到收件箱核实 传输阶段超时或无法识别的错误,邮件可能已发出,不回补额度、不自动重发,请到收件箱或发件箱的已发送里核实后再决定

发送连接的超时固定为:连接 10 秒、问候 10 秒、读写 20 秒,不可调整。

审计与限制

  • 添加、编辑、停用、启用、设默认、删除、发测试邮件都会写入操作日志,含操作人、发件箱名称与发件地址,不含密码,测试收件地址脱敏。
  • 发件箱管理仅在控制台提供,不通过开放 API 或 MCP 对外开放(持有邮箱凭据,较敏感)。
  • 邮件为纯文本,不支持附件;收件人必填,to 与 cc 合计去重后最多 10 个。

相关阅读