ข้อความ

ข้อความแทนอีเมลแต่ละฉบับที่ส่งหรือรับโดยกล่องจดหมาย ส่งอีเมล HTML ที่หลากหลาย ติดตามสถานะการส่ง และอ่านการตอบกลับขาเข้า

ภาพรวม

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

ข้อความทุกข้อความเป็นของชุดสนทนา — อย่างใดอย่างหนึ่งที่มีอยู่แล้ว (สำหรับการตอบกลับ) หรือชุดสนทนาใหม่ที่สร้างโดยอัตโนมัติเมื่อเริ่มการสนทนาใหม่

การส่งอีเมล

POST /inboxes/{inboxId}/messages

ส่งอีเมลจากกล่องจดหมายโดย post ไปยัง endpoint ข้อความ อาร์เรย์ to และ subject จำเป็น ทุกสิ่งอื่นเป็นตัวเลือก

Request Body

const res = await fetch(
  `https://api.agentsend.io/inboxes/${inboxId}/messages`,
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.AGENTSEND_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      to: ["customer@example.com"],
      subject: "ติดตามคำขอของคุณ",
      bodyText: "สวัสดี เพียงติดตามคำขอของคุณ",
      bodyHtml: "<p>สวัสดี เพียงติดตามคำขอของคุณ</p>",
    }),
  }
);

const message = await res.json();
console.log(message.id);     // msg_abc123
console.log(message.delivery); // "email" หรือ "dry-run"
console.log(message.status); // "queued"

Message Properties

Each message object returned by the API has the following fields.

Message Status

Outbound messages move through a delivery lifecycle. Check delivery first to confirm whether the environment sent real mail or only simulated it, then use status or webhooks to follow the provider-side lifecycle.

Outbound lifecycle

• queued — The message has been accepted and is waiting to be sent.
• sending — The message is actively being delivered to the recipient's mail server.
• sent — The message was accepted by the recipient's mail server.
• delivered — Delivery confirmed (where supported by the receiving server).

Failed states

• failed — A transient or permanent error prevented delivery. Check the webhook payload for the reason.
• bounced — The recipient address does not exist or the server rejected the message permanently.
• complained — The recipient marked the email as spam.

Inbound messages

• received — An email arrived at the inbox from an external sender.

Listing Messages

GET /inboxes/{inboxId}/messages

Retrieve a paginated list of messages for an inbox. Filter by status to find inbound replies, failed sends, or any other subset.

// Fetch the 10 most recent inbound messages
const res = await fetch(
  `https://api.agentsend.io/inboxes/${inboxId}/messages?status=received&limit=10`,
  { headers: { "x-api-key": process.env.AGENTSEND_API_KEY } }
);

const { data, total } = await res.json();

for (const msg of data) {
  console.log(msg.fromAddress, msg.subject, msg.bodyText);
}

HTML vs Plain Text

AgentSend supports plain-text, HTML, and multipart emails. Use bodyText for plain text and bodyHtml for HTML content.

• If you provide only bodyText, the email is sent as text/plain.
• If you provide only bodyHtml, the email is sent as text/html.
• If you provide both, the email is sent as multipart/alternative. Email clients that support HTML will show the HTML version; others fall back to the plain-text version.

Deleting Messages

DELETE /messages/{id}

Delete a message by its ID. This removes the message record from AgentSend. It does not recall an already-delivered email from the recipient's mailbox.

await fetch(`https://api.agentsend.io/messages/${messageId}`, {
  method: "DELETE",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
});