Bắt Đầu

Tạo một hộp thư và gửi email đầu tiên từ một AI agent trong chưa đầy một phút.

Tổng Quan

AgentSend là hạ tầng email được xây dựng cho AI agent. Nó cung cấp cho mỗi agent một hộp thư riêng với địa chỉ email thực, để các agent của bạn có thể gửi, nhận và quản lý các cuộc hội thoại email một cách lập trình.

Sử dụng AgentSend để xây dựng các agent xử lý hỗ trợ khách hàng, tiếp cận bán hàng, lên lịch, nghiên cứu, và bất kỳ quy trình làm việc nào cần email.

Cài Đặt

Cài đặt AgentSend SDK cho ngôn ngữ của bạn, hoặc gọi REST API trực tiếp.

npm install agentsend

Bắt Đầu Nhanh

Ví dụ này tạo một hộp thư, gửi một email, và liệt kê các tin nhắn đã nhận — tất cả chỉ trong vài dòng.

1. Lấy API key của bạn

Đăng ký tại agentsend.io và tạo API key từ bảng điều khiển. Đặt nó làm biến môi trường:

export AGENTSEND_API_KEY="your-api-key"

2. Tạo một hộp thư

Mỗi agent sẽ có hộp thư riêng với một địa chỉ email duy nhất.

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. Gửi một email

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. Nhận email

Khi ai đó trả lời, tin nhắn sẽ đến hộp thư của agent bạn. Hãy polling để kiểm tra tin nhắn mới hoặc thiết lập webhook để nhận theo thời gian thực.

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);
}

Điều Vừa Xảy Ra

1. Hộp thư đã được tạo — AgentSend đã cấp một địa chỉ email duy nhất cho agent của bạn.
2. Email đã gửi — Tin nhắn được xếp hàng, gửi qua hạ tầng của AgentSend, và được giao đến người nhận.
3. Phản hồi đã nhận — Mọi phản hồi đến địa chỉ đó sẽ đến hộp thư, sẵn sàng cho agent của bạn đọc.

Khái Niệm Cốt Lõi

• Hộp Thư — Mỗi agent có một địa chỉ email riêng. Tạo bao nhiêu tùy ý.
• Tin Nhắn — Gửi và nhận email với văn bản thuần, HTML, và tệp đính kèm.
• Chuỗi Hội Thoại — Tin nhắn được tự động nhóm thành các chuỗi hội thoại.
• Webhooks — Nhận thông báo theo thời gian thực khi email đến, bị trả về, hoặc được giao.
• Tên Miền — Sử dụng tên miền của riêng bạn thay vì @agentsend.io.
• Tệp Đính Kèm — Tải lên và đính kèm tệp vào tin nhắn gửi đi.

Bước Tiếp Theo