Novu 事务性邮件目录:按应用类型规划认证、订单与账单邮件的完整指南 Novu 事务性邮件目录按应用类型规划认证、订单与账单邮件的完整指南【免费下载链接】novuThe open-source communication infrastructure for agents and products项目地址: https://gitcode.com/GitHub_Trending/no/novu本文基于 Novu 仓库中email-best-practices技能包内的 事务性邮件目录 展开系统讲解你的应用需要哪些事务性邮件先给出 8 类应用的必备/可选邮件组合再逐类拆解每封邮件的发送时机、内容要素与最佳实践。结合 Novu 的 工作流触发 API 与官方使用指南读者读完可以独立完成从邮件规划清单到多通道发送落地的完整闭环。目录的定位先规划再发送在 Novu 仓库的 .agents/skills/email-best-practices/SKILL.md 中事务性邮件目录被明确定位为新应用的第一步新应用先从 Catalog 出发规划你的应用需要哪些邮件密码重置、验证等发送第一封邮件之前先配置 DNS 认证Deliverability。目录适用于以下四个场景继承自原文档When to Use This规划你的应用需要哪些事务性邮件根据你的应用类型选择合适的邮件组合理解每类邮件应包含的内容实现事务性邮件功能按应用类型选择邮件组合原文档为 8 种典型应用类型给出了Essential必备/ Optional可选邮件组合。以下完整继承其结论可直接作为新项目的邮件规划清单。1. 认证类应用Authentication-Focused适用对象以用户账户与安全为核心登录系统、身份提供商、账户管理。级别邮件必备邮箱验证、密码重置、OTP/2FA 验证码、安全告警新设备登录、密码修改、账户更新通知可选欢迎邮件不得含推广内容、账户删除确认2. 新闻简报 / 内容平台Newsletter / Content Platform适用对象以内容分发与订阅为核心的应用。级别邮件必备邮箱验证、密码重置、欢迎邮件非推广、订阅确认可选OTP/2FA 验证码、账户更新通知3. 电商 / 市场平台E-commerce / Marketplace适用对象用户购买产品或服务的应用。级别邮件必备邮箱验证、密码重置、欢迎邮件非推广、订单确认、发货通知、发票/收据、支付失败通知可选OTP/2FA 验证码、安全告警、订阅确认针对定期订单4. SaaS / 订阅服务SaaS / Subscription Service适用对象有付费订阅等级和持续计费的应用。级别邮件必备邮箱验证、密码重置、欢迎邮件非推广、OTP/2FA 验证码、安全告警、订阅确认、订阅续费通知、支付失败通知、发票/收据可选账户更新通知、功能变更通知仅针对破坏性变更5. 金融 / Fintech 应用Financial / Fintech适用对象处理资金、支付或敏感金融数据的应用。级别邮件必备邮箱验证、密码重置、OTP/2FA 验证码敏感操作强制要求、全类型安全告警、账户更新通知、交易确认、发票/收据、支付失败通知可选欢迎邮件非推广、合规通知6. 社交 / 社区平台Social / Community适用对象以用户互动和社区功能为核心的应用。级别邮件必备邮箱验证、密码重置、欢迎邮件非推广、安全告警可选OTP/2FA 验证码、账户更新通知、动态通知提及、回复7. 开发者工具 / API 平台Developer Tools / API Platform适用对象面向开发者、提供 API 访问与集成的应用。级别邮件必备邮箱验证、密码重置、OTP/2FA 验证码、安全告警、API Key 通知创建、过期、订阅确认、支付失败通知可选欢迎邮件非推广、用量告警接近限额、功能变更通知8. 医疗 / HIPAA 合规应用Healthcare适用对象处理受保护健康信息PHI的应用。级别邮件必备邮箱验证、密码重置、OTP/2FA 验证码强制要求、全类型详细安全告警、账户更新通知、预约确认可选欢迎邮件非推广、合规通知注意原文档 Note医疗类应用要求严格。邮件应尽量少包含 PHI受保护健康信息敏感信息通过链接引导至安全门户查看。完整邮件目录逐类拆解内容与最佳实践以下逐条完整继承原文档 Full Email Catalog 中每类邮件的When to send / Purpose / Content should include / Best practices。认证与安全Authentication Security邮箱验证 / 账户验证Email Verification发送时机用户注册后或修改邮箱地址后立即发送。目的验证邮箱地址属于该用户。内容应包含清晰的验证链接或验证码过期时间通常 24–48 小时操作说明链接被误点时的安全提示。最佳实践秒级送达包含过期提示提供重发入口问题场景链接到支持渠道。OTP / 2FA 验证码OTP / 2FA Codes发送时机用户请求两步验证时。目的提供时效性认证码。内容应包含醒目展示的 OTP 码过期时间通常 5–10 分钟安全警告非本人请求时的处理说明。最佳实践立即发送验证码字号大、易读过期时间显著标注警告用户不要分享验证码提供I didnt request this并非本人请求链接。密码重置Password Reset发送时机用户请求重置密码时。目的让用户安全地重置遗忘的密码。内容应包含带 token 的重置链接过期时间通常 1 小时安全警告非本人请求时的说明。最佳实践立即发送链接快速过期1 小时如可获取附带 IP 地址与位置信息提供I didnt request this链接不要包含旧密码。安全告警Security Alerts发送时机发生安全相关事件时新设备登录、密码修改等。目的向用户通报账户安全事件。内容应包含发生了什么清晰描述发生时间如可获取的位置/IP如属异常应执行的操作指向安全设置页的链接。最佳实践立即发送表述清晰具体包含可执行步骤提供上报可疑活动的途径。账户管理Account Management欢迎邮件Welcome Email发送时机账户创建并验证成功后立即发送。目的欢迎新用户并引导下一步必须是事务性的不得推广。内容应包含欢迎语核心功能或下一步指引重要资源链接支持联系方式。最佳实践在邮箱验证之后再发聚焦可操作信息不堆砌不过度信息轰炸提前说明未来会收到哪些邮件、设定预期。账户更新通知Account Update Notifications发送时机用户修改账户设置邮箱、密码、资料等时。目的确认账户变更并提供安全提示。内容应包含变更了什么何时变更如属未授权操作应采取的措施指向账户设置的链接。最佳实践变更后立即发送具体说明变更内容包含安全提示必要时提供便捷的撤销方式。电商与交易E-commerce Transactions订单确认Order Confirmations发送时机订单创建后立即发送。目的确认订单详情并提供收据。内容应包含订单号所购商品及数量价格明细收货地址预计送达日期订单跟踪链接如可用。最佳实践下单后数分钟内送达包含完整订单详情便于打印或保存提供客服联系方式。发货通知Shipping Notifications发送时机订单发货时并随跟踪状态更新。目的告知用户订单已发货并提供跟踪信息。内容应包含订单号跟踪号承运商信息预计送达日期跟踪链接收货地址确认。最佳实践发货时发送跟踪号显著展示提供承运商跟踪链接在关键跟踪节点更新。发票与收据Invoices and Receipts发送时机支付处理完成后。目的提供支付确认与收据。内容应包含发票/收据编号支付金额支付方式所购商品/服务支付日期可下载 PDF如适用。最佳实践支付后立即发送包含全部支付细节便于下载保存如适用包含税务信息。订阅与计费Subscriptions Billing订阅确认Subscription Confirmations发送时机用户订阅或变更订阅时。目的确认订阅详情与计费信息。内容应包含订阅套餐详情计费金额与周期下次计费日期支付方式管理订阅的链接。最佳实践订阅后立即发送清晰说明计费条款提供便捷的取消入口包含支持联系方式。订阅续费通知Subscription Renewal Notices发送时机订阅续费前通常提前 3–7 天。目的提醒用户即将续费与扣款。内容应包含续费日期扣款金额当前绑定的支付方式更新支付方式的链接如希望取消的入口。最佳实践预留足够提前量3–7 天金额与日期表述明确便于更新支付方式提供取消选项。支付失败通知Payment Failed Notices发送时机订阅支付失败时。目的通知用户支付失败并提供解决步骤。内容应包含发生了什么失败的金额失败原因如可获取解决步骤更新支付方式的链接不解决的后果。最佳实践失败后立即发送明确说明后果提供低门槛的解决路径包含支持联系方式。通知与更新Notifications Updates功能公告事务性Feature Announcements发送时机用户正在使用的某个功能发生重大变化时。目的通知用户影响其使用的变更。内容应包含变更了什么对用户的影响需要采取的操作如有更多信息链接。最佳实践仅限重大变更聚焦用户影响提供清晰的下一步链接到文档。注意原文档 Note一般性的功能公告属于营销邮件。只有当变更直接影响用户正在使用的活跃功能时才应以事务性邮件形式发送。在 Novu 中落地这份目录从规划清单到工作流规划完邮件清单之后目录中列出的每一类邮件在 Novu 中都对应一条工作流workflow加一次事件触发trigger。仓库内的官方指南给出了完整的实现路径可作为目录与代码之间的衔接创建工作流在 Novu Dashboard 中为每类邮件创建一个 workflow如password-reset用 email 步骤承载正文通过{{payload.xxx}}模板变量注入订单号、重置链接等数据参见 事务性通知指南。触发工作流业务事件发生时从后端调用 trigger API。Node.js 示例继承自官方指南import { Novu } from novu/api; const novu new Novu({ secretKey: process.env.NOVU_SECRET_KEY }); await novu.trigger({ workflowId: order-shipped, to: { subscriberId: user_123 }, payload: { orderId: ORD-456, trackingUrl: https://example.com/track/456, }, });对应的 cURL 形式为POST /v1/events/trigger携带name工作流标识、to订阅者与payload。从源码看该接口由 events 控制器 实现内部通过TriggerEventRequestDto解析请求并经由ParseEventRequest、ProcessBulkTrigger等 usecase 完成事件解析与分发触发时若subscriberId尚不存在Novu 会自动创建或更新订阅者因此目录中的每类邮件都不要求预建订阅者。多通道与降级目录中Payment failed一类高时效性告警官方指南建议采用 Email in-app、并以 SMS 作为降级的通道组合见 事务性通知指南 的通道推荐表密码重置场景还可叠加一个可选的 Throttle 步骤防止滥用并用 in-app 步骤在应用内二次确认见 密码重置指南。该指南还给出了一条重要的安全边界不要在 Novu 中存储重置 token——token 的生成与校验保留在你的认证系统内只把resetUrl和元数据作为 payload 传给 Novu。通道配置邮件步骤可对接 SendGrid、Postmark、Amazon SES 等已有 ESP目录中的立即发送要求依赖你在 集成商店 中配置好发送提供方后由 Novu 工作流调度完成。边界判断为什么目录反复强调必须非推广目录中几乎每处欢迎邮件、功能公告条目都标注了must not be promotional。这条约束的根源在 邮件类型说明事务性邮件是用户发起或预期、用于完成一次交易或法律告知的邮件可以无需显式订阅而发送但不得夹带推广内容混合邮件如新闻简报里塞入订单状态应尽量避免事务与营销邮件建议拆分发送子域如t.yourdomain.com对m.yourdomain.com以隔离送达率与合规风险。这解释了目录为什么把功能公告单列为灰色地带只有影响用户正在使用的功能时才算事务性。发送侧最佳实践目录之外的配套约束目录回答发哪些、发什么同技能包下的 事务性邮件最佳实践 回答怎么发才能被打开并执行两者配套使用主题行具体化Reset your password for [App]优于Action requiredYour order #12345 has shipped优于Update on your order——订单号、账户名、过期时间都应进入主题。预标题Pre-Header90 字符以内用于强化主题如This link expires in 1 hour。移动端优先60% 以上邮件在移动端打开单列布局、按钮最小 44x44px、正文最小 16pxOTP 码用 24–32px 等宽字体居中展示并附过期说明。发件人配置From Name 用应用名且保持一致From Email 用真实子域地址Reply-To 指向有人监控的邮箱避免noreply——用户会回复事务性邮件。错误处理重发需 60 秒冷却并限频如每小时 3 次过期链接要给出明确已过期提示与重发入口密码重置、OTP 与安全告警必须内置I didnt request this入口并记录点击用于监控。小结与相关资源这份目录的价值在于把事务性邮件规划从经验判断变成了可核对的清单先用 8 类应用组合确定必备/可选范围再按每类邮件的When / Purpose / Content / Best practices四要素逐封设计最后通过 Novu 的工作流与 trigger API 落地为多通道发送。相关资源邮件类型事务 vs 营销事务性邮件发送最佳实践合规要求送达率与 DNS 认证Novu 工作流触发API 参考触发事件【免费下载链接】novuThe open-source communication infrastructure for agents and products项目地址: https://gitcode.com/GitHub_Trending/no/novu创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考