入口:总览 → 插件应用 →「邮件插件」。由已启动的邮件插件提供,读取需 plugin:read,配置修改需 plugin:write。
功能范围#
本模块管理 SMTP、邮件模板、站点收件人和发送日志。真正发信由业务插件或服务触发,界面没有通用的「发送邮件」按钮。它也没有自动接入客户激活码交付。
配置 SMTP#
- 打开「SMTP 配置」。
- 按邮箱服务商提供的信息填写主机、端口、发件邮箱、发件人名称、认证用户和认证密码或授权码。
- 根据服务要求设置「启用认证」与「启用 STARTTLS」。当前表单默认 587、认证与 STARTTLS 开启;并不保证适配所有服务。
- 点击「测试连接」,查看成功或失败消息。
- 测试通过后点击「保存配置」,确认保存提示。
- 由已获准的业务流程做实际发信测试,核对日志与收件箱。
「测试连接」检查连接能力,不等于邮件已经发送或一定能投递。不要把邮箱登录密码和 SMTP 专用授权码混淆;凭据只在受控配置界面填写。
新建邮件模板#
- 打开「邮件模板」→「新建模板」。
- 填写模板名称、邮件主题和 HTML 正文。
- 动态值使用
${userName}这类变量,界面会列出检测到的变量。 - 点击「保存模板」,记录生成的模板 ID,交给使用该模板的业务维护人员。
- 点击已有模板可编辑;保存后再核对业务生成邮件。
模板变量必须由发信业务提供,仅写入变量名不会自动读取任意后台数据。正文 HTML 在这里作为邮件模板内容保存,不是文档中心文章的 HTML。
配置站点收件人#
- 在「站点收件人」顶部明确选择一个邮件模板,不能保持「全部模板」新增规则。
- 点击「新增收件人规则」,选择目标站点。
- 填写 To、CC、BCC,多个地址用英文逗号分隔。
- 点击「保存规则」,核对列表中的站点与邮箱。
- 同一模板在不同站点可以配置不同收件人;修改前核对顶部模板选择。
To 为主要收件人、CC 为抄送、BCC 为密送。规则是否被业务使用,仍取决于该业务调用模板与站点参数的方式。
查询发送结果#
- 打开「发送日志」。
- 按收件人或成功/失败状态筛选,点击「查询」。
- 核对状态、主题、时间和详情中的错误或消息 ID。
- 当前界面最多请求 200 条;失败时修复 SMTP 或业务参数后,再由业务流程按需重试。
「成功」表示发送流程成功,不保证收件箱未被垃圾邮件规则拦截。当前界面没有失败日志一键重发或删除历史日志按钮。
删除与配置生效#
删除模板或收件规则前,先检查关联业务;确认删除后重新核对。模块保存会持久化插件状态并尝试重载 Publisher,因此需要管理员检查实际发布端是否生效。修改 Designer 页面或配置成功,不代表离线的 Publisher 已收到。
常见问题#
- 没有模块入口:启动邮件插件并刷新总览。
- 连接失败:核对主机、端口、认证及网络,查看日志。
- 有模板却没邮件:确认业务已经触发发信,模板并不定时自动发送。
- 授权客户没收到邮件:当前激活码交付需要管理员手动发送,见 授权手册。