BunshipBunship
集成能力

邮件服务

Bunship 邮件上线指南:当前模板、React Email 预览流程与 Resend 配置。

Bunship 已把邮件能力接入认证流程。你上线前主要做这几件事:

  • 完成 Resend 发件域名认证
  • 配置环境变量
  • 调整现有模板品牌文案
  • 跑通完整收发测试

当前内置模板

模板触发场景文件
身份验证邮件注册验证 / 登录验证packages/emails/src/templates/verify-identity.tsx
OTP 验证码邮件二步验证 OTP 发送packages/emails/src/templates/request-send-otp.tsx
重置密码邮件忘记密码 / 重置密码packages/emails/src/templates/request-reset-password.tsx
提现状态通知邮件联盟提现状态变更通知packages/emails/src/templates/withdrawal-status-changed.tsx
反馈工单状态通知邮件工单状态变化通知(支持回复标题与反馈内容)packages/emails/src/templates/feedback-status-updated.tsx

feedback-status-updated 模板支持直接插入 replyTitlefeedbackContent(可选 replyContent)。

使用 React Email 预览与导出

现在可直接在 packages/emails 运行模板预览与导出。

cd packages/emails
bun run preview

可用脚本:

  • bun run preview:本地预览(端口 3333
  • bun run preview:build:构建预览应用
  • bun run preview:start:启动已构建预览
  • bun run preview:export:导出静态 HTML 到 packages/emails/out

Resend 配置步骤

1. 在 Resend 验证发件域名

在 Resend 控制台添加你的发件域名,并完成 DNS 配置:

  • SPF
  • DKIM
  • (建议)DMARC

2. 配置环境变量

RESEND_API_KEY="re_xxx"
EMAIL_FROM="Bunship <noreply@mail.yourdomain.com>"
NEXT_PUBLIC_SITE_URL="https://yourdomain.com"
BETTER_AUTH_URL="https://api.yourdomain.com"

EMAIL_FROM 必须使用已在 Resend 验证通过的域名。

3. 认证链路实测

  1. 注册并验证邮箱
  2. 触发重置密码
  3. 触发 OTP 邮件(启用时)
  4. 校验中英文邮件内容与链接是否正确

上线前检查清单

  1. Resend 域名验证已完成。
  2. EMAIL_FROM 已切换到生产发件地址。
  3. 邮件回跳链接全部指向生产域名。
  4. 模板文案、品牌信息和支持入口已替换。
  5. 已监控发送失败率和垃圾箱命中率。

当前模板截图

以下截图由 React Email 导出模板生成。

身份验证邮件模板

OTP 验证码邮件模板

重置密码邮件模板

提现状态通知邮件模板

Next Steps