先确认改的是哪封邮件
使用有设置管理权限的账号进入「瓜奇 → 邮件模板」。排查时准备一封修改后新触发的测试邮件,记录业务事件、发生时间、网站语言和收件地址;旧邮件不会随模板修改而更新。
当前页面可编辑「订单 · 数字内容就绪」「询盘 · 新询盘提醒管理员」「询盘 · 处理结果提醒用户」。邮箱验证码和游客订单管理链接属于内置必要邮件,不在本页提供编辑或关闭入口。修改其他模板不会改变这两类邮件。
检查修改是否保存
- 重新打开实际使用的模板,确认主题和正文仍是修改后的内容。
- 检查「启用此模板」是否开启。
- 确认是在「邮件模板」页保存,而不是只保存了瓜奇主设置。
- 如果页面没有保存成功,先处理保存错误,再重新测试。
邮件模板是独立的全站配置,不是每个前端各存一套。不同前端收到的内容不同,应继续检查发送语言和业务传入的数据,不能只反复切换前端保存。
检查本次发送使用的语言
邮件按业务流程传入的语言选择模板,不直接跟随管理员当前的后台界面语言。例如,询盘创建提醒会使用询盘保存的语言。
当前回退顺序分两轮:先按「请求语言 → 简体中文 → 英文」查找已保存的文案;如果都没有,再按同样顺序查找内置默认文案。
因此,只改英文区块,而实际事件使用简体中文时,不会看到英文修改。新增语言时,也要检查是否仍保留了字段初始填入的参考文案。
每个语言区块的主题和正文必须一起填写。只要其中一项非空,系统就会选中整个区块;另一项留空时不会自动从其他语言补齐,可能直接报「邮件模板内容为空」。
检查占位符和链接
- 邮件仍显示双大括号:核对拼写,并确认该标记列在当前模板的占位符说明中。系统只替换当前模板支持的字段。
- 订单号或询盘号总是同一个:检查是否写死了测试编号,改回对应的动态占位符。
- 正文更新了,链接却指向旧网站:检查是否固定写入了网址。业务详情地址应使用当前模板提供的链接占位符。
- 动态链接仍不正确:继续核对发送事件传入的前端和业务地址。模板不会自行识别并修正错误的业务数据。
- 样式或标签消失:正文会经过安全 HTML 过滤,不允许的标签和属性可能被移除。
必填业务数据缺失会阻止渲染。例如,数字内容就绪邮件需要订单号、订单地址和数字交付内容;询盘邮件需要对应询盘信息及详情或处理地址。删除正文中的相关标记,并不能补齐缺失的数据。
区分内容问题和发送问题
| 现象 | 下一步 |
|---|---|
| 没有触发邮件 | 检查对应业务是否完成。数字内容就绪邮件要求数字商品全部履约完成;提交询盘和更新处理结果是不同事件。 |
| 模板被关闭 | 开启实际使用的可编辑模板,再触发一次新的测试事件。 |
| 提示缺少业务字段或内容为空 | 检查必填数据,以及选中语言区块的主题和正文。 |
| 提示发送失败 | 检查 WordPress 邮件发送服务或 SMTP 配置,并查看对应发送记录。 |
| 服务显示已接受,但邮箱未收到 | 核对收件地址、垃圾邮件箱和邮件服务的投递记录。发信接口接受请求不等于已经送达收件箱。 |
修改后重新验证
在目标语言的主题中加入容易辨认的测试文字,保存后触发一次新的业务事件。收到邮件后,核对主题、正文、编号、收件对象和链接,再删除测试文字并保存。
如果仍需反馈问题,提供模板名称、业务事件时间、请求语言、脱敏收件地址及错误提示。不要发送有效的游客订单私密管理链接或邮件服务密钥。