Menu

发送新用户欢迎邮件

提示

此功能从 v2.2.0 版本开始提供，可参考更新记录进行升级。 关于 referral 字段的用法，请阅读记录用户来源。

向新用户发送欢迎邮件是产品营销的重要环节，Nexty 提供了完整的新用户欢迎邮件功能和通用邮件模板。

由于 Supabase Auth 没有提供独立的注册流程，也没有对应的注册事件标志，因此 Nexty 通过在登录回调 app/auth/callback/route.ts 方法中检查 referral 字段是否存在来判断用户是否为新用户。

具体机制如下：每位用户首次登录时都会记录其来源信息。当用户通过携带参数的 URL 访问并登录时，referral 字段会记录 URL 中的参数；如果通过不携带参数的 URL 访问并登录，则 referral 字段会记录为 direct。因此，当 referral 字段为空时，即表示用户首次登录。

基于这个机制，我们可以在 app/auth/callback/route.ts 中触发新用户欢迎邮件的发送。

启用步骤

  1. 设计欢迎邮件模板

内置的新用户欢迎邮件模板位于 emails/user-welcome.tsx，所有品牌信息都从 config/site 配置中提取。你只需修改 config/site 配置即可获得基础的欢迎邮件模板，效果如下：

welcome-email-template

建议根据你的业务特点，将欢迎邮件模板设计得更符合营销需求。

注意

由于邮件发送是服务端任务，以下客户端组件用法在此处无法使用：

  • Next.js 的 <Link/> 或 <Image /> 组件
  • TailwindCSS 样式写法
  • Lucide 等图标库
  1. 配置环境变量

将环境变量 NEXT_PUBLIC_USER_WELCOME 设置为 true

  1. 测试功能

由于此流程仅向新用户发送欢迎邮件，测试时需要先删除现有的测试用户，然后重新在页面上登录：

welcome-email-template