SuperAPI AI 工具集

send-email

办公与效率

查看项目

更新于 10-16 07:17

技能介绍

用途:通过 Resend API 发送事务性邮件(欢迎信、订单确认、密码重置、收据)、通知或批量邮件。

主要能力:Resend 提供两个端点——单封 POST /emails(支持附件、定时发送)与批量 POST /emails/batch(一次最多 100 封,不支持附件与定时,任一校验失败整批失败)。支持幂等键、标签、模板、Webhook 事件通知、打开/点击追踪(域名级配置)。

使用方式:先从配置文件识别项目语言,安装 SDK(优先于 cURL),再按决策矩阵选择单封或批量。单封必填 from、to(最多 50)、subject、html 或 text;批量需先校验全部邮件。API 密钥存于 RESEND_API_KEY 环境变量,from 地址须使用已验证域名。

关键实践:重试时始终带幂等键(格式如 welcome-email/user-123,24 小时过期,最长 256 字符);仅对 429 与 500 做指数退避重试(1s、2s、4s…,最多 3-5 次),400/422/401/403 不重试,409 为幂等冲突。送达率方面需配置 SPF、DKIM、DMARC,链接与发信域一致,提供纯文本版本,避免 no-reply 地址,正文控制在 102KB 内;事务性邮件建议关闭追踪。

测试与限制:切勿用 test@gmail.com 等假地址,应使用 delivered@resend.dev、bounced@resend.dev、complained@resend.dev 或自有地址。新域名需逐步预热,监控退信率(<4%)与投诉率(<0.08%)。Resend 自动维护抑制列表。模板变量区分大小写,每模板最多 20 个变量,且不能与 html、text、react 参数同用,模板须先在控制台发布。大规模营销活动应改用 Resend Broadcasts。具体 SDK 安装命令与完整代码示例暂未提供。