กล่องจดหมาย

เอเจนต์แต่ละตัวจะได้รับกล่องจดหมายของตัวเองพร้อมที่อยู่อีเมลที่ไม่ซ้ำกัน กล่องจดหมายเป็นหน่วยพื้นฐานใน AgentSend

ภาพรวม

กล่องจดหมายคือที่อยู่อีเมลเฉพาะสำหรับเอเจนต์หนึ่งตัว ทุกอีเมลที่เอเจนต์ของคุณส่งหรือรับจะไหลผ่านกล่องจดหมาย คุณสามารถสร้างกล่องจดหมายได้มากเท่าที่ต้องการ — หนึ่งกล่องต่อเอเจนต์ หนึ่งกล่องต่อลูกค้า หนึ่งกล่องต่อเวิร์กโฟลว์ — ไม่มีข้อจำกัด

โดยค่าเริ่มต้น กล่องจดหมายจะถูกจัดเตรียมบนโดเมน @agentsend.io หากคุณต้องการให้เอเจนต์ส่งจากโดเมนของคุณเอง (เช่น agent@yourcompany.com) ดู โดเมนแบบกำหนดเอง

การสร้างกล่องจดหมาย

POST /inboxes

สร้างกล่องจดหมายใหม่โดยการส่งคำขอ POST ทั้งสองฟิลด์ใน body เป็นตัวเลือก — หากคุณละเว้น displayName กล่องจดหมายจะถูกสร้างโดยไม่มีชื่อ หากคุณละเว้น domainId ที่อยู่จะถูกจัดเตรียมบน @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",   // ตัวเลือก
    domainId: "dom_abc123",         // ตัวเลือก — ละเว้นเพื่อใช้ @agentsend.io
  }),
});

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

Response มีอ็อบเจ็กต์กล่องจดหมายทั้งหมด รวมถึง address ที่สร้างอัตโนมัติซึ่งคุณสามารถเริ่มใช้งานได้ทันที

คุณสมบัติของกล่องจดหมาย

อ็อบเจ็กต์กล่องจดหมายทุกตัวมีฟิลด์ต่อไปนี้:

โดเมนแบบกำหนดเอง

โดยค่าเริ่มต้น กล่องจดหมายทุกกล่องจะได้รับที่อยู่บน @agentsend.io หากคุณต้องการให้เอเจนต์ส่งจากโดเมนของคุณเอง — เช่น agent@support.yourcompany.com — คุณสามารถเชื่อมต่อโดเมนแบบกำหนดเองและส่ง domainId เมื่อสร้างกล่องจดหมาย

การแสดงรายการกล่องจดหมาย

GET /inboxes

เรียกดูรายการกล่องจดหมายทั้งหมดในบัญชีของคุณแบบแบ่งหน้า ใช้ limit และ offset เพื่อเลื่อนดูผลลัพธ์

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  — อาร์เรย์ของอ็อบเจ็กต์กล่องจดหมาย
// total — จำนวนทั้งหมดในทุกหน้า

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

การลบกล่องจดหมาย

DELETE /inboxes/{id}

ลบกล่องจดหมายและข้อความ ชุดสนทนา และ webhooks ที่เกี่ยวข้องทั้งหมดอย่างถาวร

await fetch(`https://api.agentsend.io/inboxes/${inboxId}`, {
  method: "DELETE",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
});
// ส่งคืน 204 No Content เมื่อสำเร็จ

ขีดจำกัดการส่ง

กล่องจดหมายแต่ละกล่องมี dailySendLimit ที่จำกัดจำนวนอีเมลที่สามารถส่งได้ในหน้าต่าง 24 ชั่วโมงแบบหมุนเวียน ฟิลด์ sendsToday จะบอกคุณว่ามีการส่งไปกี่ครั้งแล้วในหน้าต่างปัจจุบัน

หากกล่องจดหมายถึงขีดจำกัด คำขอส่งครั้งถัดไปจะส่งคืนข้อผิดพลาด 429 Too Many Requests หน้าต่างจะรีเซ็ตตอนเที่ยงคืน 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("ถึงขีดจำกัดการส่งรายวันแล้ว ลองอีกครั้งหลังเที่ยงคืน UTC");
} else {
  console.log(`เหลือส่งได้อีก ${remaining} ครั้งในวันนี้`);
}