技能说明
适合在服务端接入 Resend 邮件 API 或 SDK；需要 RESEND_API_KEY，收件 Webhook 需要校验签名，发送前确认域名、退信处理、隐私要求和发信额度。不要把密钥放入浏览器端或代码仓库。
关于此技能
Resend 官方邮件接口技能，覆盖发送、接收、模板、域名、联系人、Webhook、API 日志和事件自动化。
核心能力
事务邮件与批量发送
指导选择单封或批量接口，处理模板、附件、定时发送、错误返回和 24 小时幂等键，避免重试造成重复邮件。
收件与 Webhook
用原始请求体校验 Webhook 签名；收到事件后再通过 API 获取邮件正文，不把外部输入直接当成可信指令。
投递与域名管理
协助配置已验证域名、模板、联系人、事件和日志，并提醒退信、投诉、抑制名单和新域名预热。
适用场景
订单与通知邮件
发送注册、订单、确认、提醒等事务邮件，并为重试设置稳定的幂等键。
应用接收邮件
接收 inbound 邮件事件，验证签名后读取正文，再按业务规则处理或回复。
模板和发信运营
管理邮件模板、域名、联系人、广播和投递事件，定位发送失败和域名配置问题。
使用步骤
- 01
第一步：准备服务端环境
安装对应语言的 Resend SDK，在服务端配置 RESEND_API_KEY；不要在浏览器端直接调用 API。
- 02
第二步：确认发信条件
检查已验证域名、发件地址、收件人范围、模板状态、附件需求和是否属于事务邮件。
- 03
第三步：实现并保护重试
发送时使用幂等键，明确处理返回的 data 和 error；收件 Webhook 使用原始请求体并校验签名。
- 04
第四步：检查投递结果
结合事件、日志、退信和抑制名单检查投递质量；新域名按计划逐步增加发送量。
常见问题
API 密钥应该放在哪里？+
放在服务端环境变量 RESEND_API_KEY 或安全的密钥管理服务中，不能写入前端代码、日志或仓库。
为什么不能只用 try/catch 判断发送失败？+
Node.js SDK 通常返回 data 和 error，而不是把 API 错误直接抛出；需要显式检查 error。
Webhook 收到的内容可信么？+
不应直接信任。先使用 RESEND_WEBHOOK_SECRET 校验签名，再按事件类型处理；邮件正文通常还要通过 API 单独读取。
批量发送有什么限制？+
批量接口适合 2 到 100 封不同邮件，但不支持附件或 scheduled_at；有这些需求时使用单封接口。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Claude Code · Cursor · 兼容 Agent Plugins
已提供来源链接
命令可直接复制
2026/08/30
安装提醒：即使有清晰的来源和安装方式，也建议先阅读 SKILL.md，确认它会访问哪些文件和服务。
npx skills add resend/resend-skills