SuperAPI AI 工具集

resend-inbound

办公与效率

查看项目

更新于 10-16 07:58

技能介绍

用途:通过 Resend 接收发往自有域名的邮件。Resend 处理入站邮件后向你的端点发送 Webhook 事件;Webhook 只含元数据,正文与附件需另行调用 API 获取。

主要能力:

  • 域名配置:可直接使用 Resend 托管的 <anything>@<your-id>.resend.app 地址,无需 DNS;自定义域名需添加 MX 记录(类型 MX,优先级填最低值,否则邮件不会路由到 Resend)。若域名已有 MX(如 Google Workspace、Microsoft 365),建议使用子域名,避免破坏现有收信。
  • Webhook:订阅 email.received 事件。本地开发可用 ngrok http 3000 等隧道。事件负载含 email_id、from、to、cc、bcc、subject 及附件元数据(id、filename、content_type),不含正文。
  • 签名校验:必须调用 resend.webhooks.verify() 验证 svix-id、svix-timestamp、svix-signature,防止伪造事件。
  • 获取内容:调用 resend.emails.receiving.get(email_id) 获取 html、text、headers;调用 resend.emails.receiving.attachments.list({ emailId }) 获取附件列表与 download_url。
  • 附件下载:download_url 有效期 1 小时,过期需重新调用 API 获取新链接。
  • 转发:取回正文与附件(附件需 base64 编码)后,用 resend.emails.send() 转发。
  • 按收件人路由:所有入站邮件到同一 Webhook,可根据 to 字段分流。

SDK 版本要求:Node.js resend >= 6.9.2;Python resend >= 2.21.0;Go resend-go/v3 >= 3.1.0;Ruby resend >= 1.0.0;PHP resend/resend-php >= 1.1.0;Rust resend-rs >= 0.20.0;Java resend-java >= 4.11.0;.NET Resend >= 0.2.1。应安装最新版,已安装旧版需升级。

限制与注意事项:Webhook 负载不含正文,勿在负载中读取 body;MX 记录需为最低优先级;根域名加 MX 会中断原有邮箱服务,建议使用子域名;下载链接过期需重新获取;必须校验签名;处理完需返回 200,否则 Resend 会重试。即使未配置 Webhook 或端点不可用,Resend 仍会保存收到的邮件,可在控制台 Emails → Receiving 查看。