邮件模板
Auth 的 Templates 页(/auth/templates)自定义平台发给终端用户的邮件内容(页面标题 "Email templates" 带 Experimental 徽章)。
前置条件:自定义 SMTP
- 未配置自定义 SMTP 时,页面顶部提示 "Custom SMTP server is required for customizing emails",并给出跳转 SMTP settings 的链接(SMTP 配置在项目 Settings 页)。
- SMTP 未启用时,各模板的 Sender name / Sender email / Reply to 字段禁用,Message 正文只读。
模板类型(共 7 种邮件模板)
| 模板 | 触发场景 | 可用变量 |
|---|---|---|
| Verification | 邮箱密码注册 / 登录的邮箱验证 | {{user}} {{project}} {{redirect}} |
| Magic URL | 魔法链接登录 | {{user}} {{project}} {{redirect}} {{agentClient}} {{agentDevice}} {{agentOs}} |
| OTP session | 一次性验证码(OTP)登录 | {{user}} {{project}} {{otp}} {{agentClient}} {{agentDevice}} {{agentOs}} |
| Reset password | 找回密码 | {{user}} {{project}} {{redirect}} |
| Invite user | 邀请加入项目 / 团队 | {{team}} {{user}} {{project}} {{redirect}} |
| 2FA verification | MFA 挑战验证码 | {{user}} {{project}} {{otp}} {{agentClient}} {{agentDevice}} {{agentOs}} |
| Session alert | 新会话提醒(配合 Security → Session alerts) | {{user}} {{project}} {{device}} {{ipAddress}} {{country}} |
版本事实(如实说明):源码中还存在短信模板组件(邀请 / 验证 / 登录),但本版本模板页面未挂载短信模板,仅提供上述 7 种邮件模板。
编辑与保存
每个模板编辑器包含五个字段:Sender name、Sender email、Reply to、Subject、Message。
- 在页面选择模板类型。
- 选择 Template language(语言下拉,默认
en;模板按语言分别保存)。 - 修改字段与正文,插入所需变量(编辑器内提供变量逐个复制)。
- 保存;Reset changes 可放弃未保存修改。
注意事项
- 模板改动立即作用于后续触发的平台邮件;
{{redirect}}由触发登录 / 验证的客户端传入,请勿删除该变量,否则收件人无法完成跳转。 - 自定义 SMTP 属项目级配置,修改后所有平台邮件换道发送;首次配置建议先用 Verification 模板实测收件。
- 仅云端部署且套餐包含 email branding 时显示 Email signature 卡:开关控制邮件签名中的 Agentbase 品牌展示。