快速入門

建立收件匣，在一分鐘內從 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 的基礎設施發送，並投遞給收件人。
回覆已收到 — 對該地址的任何回覆都會送到收件匣，供您的代理讀取。

核心概念

Inboxes — 每個代理都有專屬的電子郵件地址。依需求建立任意數量。
Messages — 發送和接收純文字、HTML 和附件的電子郵件。
Threads — 訊息會自動分組為對話串。
Webhooks — 當電子郵件到達、退回或投遞時獲得即時通知。
Domains — 使用您自己的網域替代 @agentsend.io。
Attachments — 上傳檔案並附加到外送訊息。

下一步

與 LangChain、CrewAI、OpenAI Agents 或 Claude MCP 整合。

設定 Webhooks

當電子郵件到達時獲得即時通知。

透過請求/回應範例探索每個端點。

下一篇收件匣 →