시작하기

수신함을 만들고 1분 이내에 AI 에이전트로부터 첫 이메일을 보내세요.

개요

AgentSend는 AI 에이전트를 위해 구축된 이메일 인프라입니다. 각 에이전트에게 실제 이메일 주소를 가진 자체 수신함을 제공하여 에이전트가 프로그래밍 방식으로 이메일 대화를 송수신하고 관리할 수 있게 합니다.

AgentSend를 사용해 고객 지원, 영업 아웃리치, 일정 관리, 리서치 등 이메일이 필요한 모든 워크플로를 처리하는 에이전트를 구축하세요.

설치

사용하는 언어의 AgentSend SDK를 설치하거나 REST API를 직접 호출하세요.

npm install agentsend

빠른 시작

이 예제는 수신함 생성, 이메일 전송, 수신한 메시지 조회까지 모든 작업을 몇 줄의 코드로 수행합니다.

1. API 키 받기

agentsend.io에서 가입하고 대시보드에서 API 키를 생성하세요. 환경 변수로 설정합니다:

export AGENTSEND_API_KEY="your-api-key"

2. 수신함 만들기

각 에이전트는 고유한 이메일 주소가 있는 자체 수신함을 받습니다.

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. 이메일 전송하기

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. 이메일 수신하기

누군가 답장하면 메시지가 에이전트 수신함에 도착합니다. 새 메시지를 폴링하거나 실시간 전송을 위해 웹훅을 설정하세요.

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

방금 무엇이 일어났는가

1. 수신함 생성 — AgentSend가 에이전트를 위해 고유한 이메일 주소를 프로비저닝했습니다.
2. 이메일 전송 — 메시지가 큐에 들어가 AgentSend 인프라를 통해 전송되고 수신자에게 전달되었습니다.
3. 답장 수신 — 해당 주소로 오는 모든 답장은 수신함에 도착해 에이전트가 읽을 준비가 됩니다.

핵심 개념

• 수신함 — 각 에이전트에게 전용 이메일 주소가 할당됩니다. 필요한 만큼 만들 수 있습니다.
• 메시지 — 일반 텍스트, HTML, 첨부파일이 포함된 이메일을 송수신합니다.
• 스레드 — 메시지는 자동으로 대화 스레드로 그룹화됩니다.
• 웹훅 — 이메일이 도착, 반송, 전송될 때 실시간 알림을 받습니다.
• 도메인 — @agentsend.io 대신 자체 도메인을 사용합니다.
• 첨부파일 — 파일을 업로드하여 발신 메시지에 첨부합니다.

다음 단계