技能介绍

要解决的问题

事务邮件（密码重置、验证码、订单通知）是后端服务绕不开的一环，但手写 SendGrid 调用往往很琐碎：模板变量替换、抑制列表过滤、投递状态回查，每件事单独看都不复杂，合在一起却容易写出重复代码和状态不一致的 bug。

核心能力与工作方式

这个技能把 SendGrid v3 Mail Send API 的常用路径封装成一套可直接复用的流程，主要分三层：

模板渲染：用 Handlebars 语法在模板里写占位符，发送时传入数据对象，字段自动替换。变量缺失时的处理逻辑统一在模板层完成，不需要为每种邮件类型写定制代码。
抑制列表管理：发送前可以把硬退信、取消订阅的地址维护进 suppression groups，避免反复向无效地址投递。
投递追踪：通过 Event Webhook 接收 send、delivered、bounce、drop 等事件，解析后就能重建一封邮件从发出到落地的完整生命周期。

发送一封邮件的关键步骤很直接：构造模板数据、组装请求体、调用 Mail Send API、按需消费 Webhook 事件。

适用边界

需要注意几点：该技能底层是 SendGrid 官方 Node.js 库，从 6.x 升级到 7.x 有 breaking change，升级前必须对照官方迁移指南核对 API 行为变化。上游以 monorepo 形式组织，实际使用时按需求安装对应子包即可。它只负责"构建与发送"这一层，邮件内容本身的业务校验（如金额、链接拼接）仍要在调用侧完成。