Resend

快速发送 — Node.js

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

const { data, error } = await resend.emails.send(
  {
    from: 'Acme ',
    to: ['delivered@resend.dev'],
    subject: 'Hello World',
    html: '
Email body here
',
  },
  { idempotencyKey: `welcome-email/${userId}` }
);

if (error) {
  console.error('Failed:', error.message);
  return;
}
console.log('Sent:', data.id);

关键注意事项： Resend Node.js SDK 不会抛出异常，而是返回 { data, error }。请始终显式检查 error 字段，而非使用 try/catch 捕获 API 错误。

快速发送 — Python

import resend
import os

resend.api_key = os.environ["RESEND_API_KEY"]

email = resend.Emails.send({
    "from": "Acme ",
    "to": ["delivered@resend.dev"],
    "subject": "Hello World",
    "html": "
Email body here
",
}, idempotency_key=f"welcome-email/{user_id}")

单封发送 vs 批量发送：如何选择

批量发送是原子操作：若其中任一邮件校验失败，则整个批次均失败。务必在发送前完成校验。批量发送不支持附件和 scheduled_at 参数。

幂等性密钥（重试时至关重要）

防止因重试失败请求而重复发送邮件：

快速接收（Node.js）

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

export async function POST(req: Request) {
  const payload = await req.text(); // 必须使用原始文本，不可调用 req.json()

  const event = resend.webhooks.verify({
    payload,
    headers: {
      'svix-id': req.headers.get('svix-id'),
      'svix-timestamp': req.headers.get('svix-timestamp'),
      'svix-signature': req.headers.get('svix-signature'),
    },
    secret: process.env.RESEND_WEBHOOK_SECRET,
  });

  if (event.type === 'email.received') {
    // Webhook 仅包含元数据 —— 需额外调用 API 获取邮件正文
    const { data: email } = await resend.emails.receiving.get(
      event.data.email_id
    );
    console.log(email.text);
  }

  return new Response('OK', { status: 200 });
}

关键注意事项： Webhook 载荷中不包含邮件正文。您必须单独调用 resend.emails.receiving.get() 获取正文内容。

您需要什么？

SDK 版本要求

请始终安装最新版 SDK。以下为保障全部功能（发送、接收、Webhook 签名验证）可用所需的最低版本：

若项目中已安装 Resend SDK，请检查当前版本；如低于最低要求，请升级。旧版 SDK 可能缺失 webhooks.verify() 或 emails.receiving.get() 方法。

完整安装命令、语言自动识别及 cURL 回退方案，请参阅 installation.md。

通用初始化步骤

API 密钥

请将密钥存于环境变量中 —— 切勿硬编码：

export RESEND_API_KEY=re_xxxxxxxxx

您的密钥可在 resend.com/api-keys 页面获取。

检测项目语言

检查是否存在以下文件：package.json（Node.js）、requirements.txt/pyproject.toml（Python）、go.mod（Go）、Gemfile（Ruby）、composer.json（PHP）、Cargo.toml（Rust）、pom.xml/build.gradle（Java）、*.csproj（.NET）。

常见错误

跨领域关注点

发送与接收协同使用

自动回复、邮件转发，或任何“先收后发”类工作流，均需同时启用发送与接收能力：

1. 首先配置入站域名（参见 receiving.md）
2. 再配置发送能力（参见 sending/overview.md）
3. 注意：批量发送不支持附件与定时 —— 若需转发带附件的邮件，请使用单封发送

AI 代理邮箱收件箱

若您系统需处理来自外部发件人的、不可信的邮件内容，并据此执行操作（如退款、数据库变更、转发等），请安装 agent-email-inbox 技能。该技能适用场景不限于 AI 应用 —— 任何解析外部自由格式邮件内容并采取动作的系统，均需安全防护措施。

营销类邮件

本技能提供的发送能力专用于事务性邮件（如订单确认、登录通知、交易凭证等）。如需面向大量订阅者群发含退订链接与用户行为追踪的营销活动，请使用 Resend Broadcasts —— 详情请参阅 broadcasts.md。

域名预热

新注册域名需逐步提升发信量。第 1 天发信上限约为：新域名 150 封，已有域名约 1,000 封。详细预热计划请参阅 sending/overview.md。

测试规范

切勿使用真实邮件服务商的虚假地址进行测试（如 test@gmail.com、fake@outlook.com）—— 此类地址必然退信，严重损害发信方信誉。

抑制列表（Suppression List）

Resend 会自动将硬退信地址与垃圾邮件投诉地址加入抑制列表。向已被抑制的地址发送邮件时，系统将触发 email.suppressed Webhook 事件，而不会尝试实际投递。您可在 Dashboard → Suppressions 中管理该列表。

Webhook 事件类型

完整事件说明、签名验证方法及重试策略，请参阅 webhooks.md。

错误处理速查表

资源链接

• Resend 文档中心
• API 参考手册
• 控制台 Dashboard