Kotak Masuk

Setiap agen memiliki kotak masuknya sendiri dengan alamat email unik. Kotak masuk adalah unit fundamental di AgentSend.

Ikhtisar

Kotak masuk adalah alamat email khusus untuk satu agen. Setiap email yang dikirim atau diterima agen Anda mengalir melalui kotak masuk. Anda dapat membuat sebanyak mungkin kotak masuk yang Anda butuhkan — satu per agen, satu per pelanggan, satu per alur kerja — tanpa batas.

Secara default, kotak masuk disediakan di domain @agentsend.io. Jika Anda ingin agen Anda mengirim dari domain Anda sendiri (misalnya agent@perusahaananda.com), lihat Domain Kustom.

Membuat Kotak Masuk

POST /inboxes

Buat kotak masuk baru dengan mengirim request POST. Kedua field body bersifat opsional — jika Anda menghilangkan displayName, kotak masuk dibuat tanpa nama tampilan. Jika Anda menghilangkan domainId, alamat disediakan di @agentsend.io.

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: "Support Agent",   // optional
    domainId: "dom_abc123",         // optional — omit for @agentsend.io
  }),
});

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

Respons mencakup objek kotak masuk lengkap, termasuk address yang dihasilkan otomatis yang dapat langsung Anda gunakan.

Properti Kotak Masuk

Setiap objek kotak masuk memiliki field berikut:

Domain Kustom

Secara default, setiap kotak masuk mendapat alamat di @agentsend.io. Jika Anda ingin agen Anda mengirim dari domain Anda sendiri — misalnya agent@support.perusahaananda.com — Anda dapat menghubungkan domain kustom dan meneruskan domainId saat membuat kotak masuk.

Daftar Kotak Masuk

GET /inboxes

Ambil daftar terpaginasi dari semua kotak masuk di akun Anda. Gunakan limit dan offset untuk menavigasi halaman hasil.

const res = await fetch(
  "https://api.agentsend.io/inboxes?limit=20&offset=0",
  {
    headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
  }
);

const { data, total } = await res.json();
// data  — array of inbox objects
// total — total count across all pages

for (const inbox of data) {
  console.log(inbox.address, inbox.status, inbox.sendsToday);
}

Menghapus Kotak Masuk

DELETE /inboxes/{id}

Menghapus kotak masuk dan semua pesan, utas, dan webhook terkait secara permanen.

await fetch(`https://api.agentsend.io/inboxes/${inboxId}`, {
  method: "DELETE",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
});
// Returns 204 No Content on success

Batas Kirim

Setiap kotak masuk memiliki dailySendLimit yang membatasi berapa banyak email yang dapat dikirim dalam jendela 24 jam bergulir. Field sendsToday memberi tahu Anda berapa banyak pengiriman yang telah digunakan di jendela saat ini.

Jika kotak masuk mencapai batasnya, request kirim berikutnya mengembalikan error 429 Too Many Requests. Jendela direset pada tengah malam UTC.

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

const remaining = inbox.dailySendLimit - inbox.sendsToday;
if (remaining <= 0) {
  console.log("Daily send limit reached. Try again after midnight UTC.");
} else {
  console.log(`${remaining} sends remaining today`);
}