Cove · 屿里文档中心
下载应用

邮件插件

配置 SMTP、邮件模板、站点收件人并查询发送日志。

本页目录

入口:总览 → 插件应用 →「邮件插件」。由已启动的邮件插件提供,读取需 plugin:read,配置修改需 plugin:write。

功能范围#

本模块管理 SMTP、邮件模板、站点收件人和发送日志。真正发信由业务插件或服务触发,界面没有通用的「发送邮件」按钮。它也没有自动接入客户激活码交付。

配置 SMTP#

  1. 打开「SMTP 配置」。
  2. 按邮箱服务商提供的信息填写主机、端口、发件邮箱、发件人名称、认证用户和认证密码或授权码。
  3. 根据服务要求设置「启用认证」与「启用 STARTTLS」。当前表单默认 587、认证与 STARTTLS 开启;并不保证适配所有服务。
  4. 点击「测试连接」,查看成功或失败消息。
  5. 测试通过后点击「保存配置」,确认保存提示。
  6. 由已获准的业务流程做实际发信测试,核对日志与收件箱。

「测试连接」检查连接能力,不等于邮件已经发送或一定能投递。不要把邮箱登录密码和 SMTP 专用授权码混淆;凭据只在受控配置界面填写。

新建邮件模板#

  1. 打开「邮件模板」→「新建模板」。
  2. 填写模板名称、邮件主题和 HTML 正文。
  3. 动态值使用 ${userName} 这类变量,界面会列出检测到的变量。
  4. 点击「保存模板」,记录生成的模板 ID,交给使用该模板的业务维护人员。
  5. 点击已有模板可编辑;保存后再核对业务生成邮件。

模板变量必须由发信业务提供,仅写入变量名不会自动读取任意后台数据。正文 HTML 在这里作为邮件模板内容保存,不是文档中心文章的 HTML。

配置站点收件人#

  1. 在「站点收件人」顶部明确选择一个邮件模板,不能保持「全部模板」新增规则。
  2. 点击「新增收件人规则」,选择目标站点。
  3. 填写 To、CC、BCC,多个地址用英文逗号分隔。
  4. 点击「保存规则」,核对列表中的站点与邮箱。
  5. 同一模板在不同站点可以配置不同收件人;修改前核对顶部模板选择。

To 为主要收件人、CC 为抄送、BCC 为密送。规则是否被业务使用,仍取决于该业务调用模板与站点参数的方式。

查询发送结果#

  1. 打开「发送日志」。
  2. 按收件人或成功/失败状态筛选,点击「查询」。
  3. 核对状态、主题、时间和详情中的错误或消息 ID。
  4. 当前界面最多请求 200 条;失败时修复 SMTP 或业务参数后,再由业务流程按需重试。

「成功」表示发送流程成功,不保证收件箱未被垃圾邮件规则拦截。当前界面没有失败日志一键重发或删除历史日志按钮。

删除与配置生效#

删除模板或收件规则前,先检查关联业务;确认删除后重新核对。模块保存会持久化插件状态并尝试重载 Publisher,因此需要管理员检查实际发布端是否生效。修改 Designer 页面或配置成功,不代表离线的 Publisher 已收到。

常见问题#

  • 没有模块入口:启动邮件插件并刷新总览。
  • 连接失败:核对主机、端口、认证及网络,查看日志。
  • 有模板却没邮件:确认业务已经触发发信,模板并不定时自动发送。
  • 授权客户没收到邮件:当前激活码交付需要管理员手动发送,见 授权手册。
遇到问题?查看 后台手册目录,或通过 邮件联系 Cove。

搜索文档

输入关键词,搜索当前范围的文档。