快速入门

创建收件箱，一分钟内从 AI 智能体发送第一封邮件。

概述

AgentSend 是专为 AI 智能体构建的邮件基础设施。它为每个智能体提供独立的收件箱和真实的邮件地址，使您的智能体能够以程序化方式发送、接收和管理邮件会话。

使用 AgentSend 构建处理客户支持、销售拓展、日程安排、研究以及任何需要邮件的工作流的智能体。

为您的智能体创建专用邮件地址。

发送和接收支持完整 MIME 的邮件。

邮件到达时立即获得通知。

探索每个端点及其示例。

安装

为您的语言安装 AgentSend SDK，或直接调用 REST API。

bash

npm install agentsend

💡

没有 SDK？没问题。AgentSend 支持任何 HTTP 客户端。所有端点接受 JSON 并返回 JSON。

快速开始

此示例创建收件箱、发送邮件并列出已接收的消息 — 只需几行代码。

1. 获取 API 密钥

在 agentsend.io 注册并从控制台创建 API 密钥。将其设置为环境变量：

bash

export AGENTSEND_API_KEY="your-api-key"

2. 创建收件箱

每个智能体都有自己的收件箱和唯一的邮件地址。

javascript

const res = await fetch("https://api.agentsend.io/inboxes", {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    displayName: "My Support Agent",
  }),
});

const inbox = await res.json();
console.log(inbox.address); // e.g. a1b2c3@agentsend.io

3. 发送邮件

javascript

await fetch(`https://api.agentsend.io/inboxes/${inbox.id}/messages`, {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: ["customer@example.com"],
    subject: "Hello from AgentSend",
    bodyText: "This email was sent by an AI agent.",
  }),
});

4. 接收邮件

当有人回复时，消息会进入您智能体的收件箱。可以轮询新消息或设置 webhook 进行实时接收。

javascript

const msgs = await fetch(
  `https://api.agentsend.io/inboxes/${inbox.id}/messages?status=received`,
  { headers: { "x-api-key": process.env.AGENTSEND_API_KEY } }
).then(r => r.json());

for (const msg of msgs.data) {
  console.log(msg.fromAddress, msg.subject);
}

刚才发生了什么

收件箱已创建 — AgentSend 为您的智能体分配了一个唯一的邮件地址。
邮件已发送 — 消息已排队，通过 AgentSend 的基础设施发送，并已送达收件人。
回复已接收 — 对该地址的任何回复都会进入收件箱，等待您的智能体读取。

核心概念

收件箱 — 每个智能体都有专用的邮件地址。可以根据需要创建任意数量。
消息 — 发送和接收纯文本、HTML 和带附件的邮件。
会话 — 消息会自动分组为会话线程。
Webhooks — 当邮件到达、退信或成功投递时获取实时通知。
域名 — 使用您自己的域名而不是 @agentsend.io。
附件 — 上传并将文件附加到发出的消息中。

下一步

与 LangChain、CrewAI、OpenAI Agents 或 Claude MCP 连接。

设置 Webhooks

当邮件到达时获取实时通知。

探索每个端点及其请求/响应示例。

下一篇收件箱 →