Email Message Event

Email Message Event

Email Message Event ใช้ติดตามการเปลี่ยนแปลงสถานะการส่งของข้อความอีเมล เพื่อให้มองเห็นวงจรชีวิตของอีเมลได้ชัดเจน

สคีมา

interface EmailMessageEvent {
  id: string; // "eme_..." - ตัวระบุที่ไม่ซ้ำ
  account_id: string; // บัญชีเจ้าของ
  email_message_id: string; // ข้อความที่เชื่อมโยง
  event_type: string; // ประเภทเหตุการณ์
  meta: Record<string, any> | null; // ข้อมูลเพิ่มเติม
  occurred_at: string; // ISO 8601 timestamp
}

คุณสมบัติ

Property	Type	คำอธิบาย
id	string	KSUID ที่ขึ้นต้นด้วย eme_
account_id	string	บริบทบัญชี
email_message_id	string	ข้อความที่เหตุการณ์นี้เกี่ยวข้อง
event_type	string	ประเภทของเหตุการณ์
meta	object?	metadata เฉพาะของเหตุการณ์
occurred_at	string	เวลาที่เหตุการณ์เกิดขึ้น

ประเภทเหตุการณ์

ประเภทเหตุการณ์ขึ้นกับผู้ให้บริการ ค่าที่พบบ่อยคือ:

Type	คำอธิบาย
queued	ระบบรับข้อความเข้าคิวส่งแล้ว
sent	ส่งต่อไปยัง receiving MTA แล้ว
delivered	ยืนยันการส่งถึง inbox แล้ว
bounced	ส่งไม่สำเร็จแบบถาวร
soft_bounced	ส่งไม่สำเร็จแบบชั่วคราว
complained	ผู้รับรายงานว่าเป็นสแปม
opened	ผู้รับเปิดอีเมล
clicked	ผู้รับคลิกลิงก์

ลำดับเหตุการณ์

ตัวอย่าง

{
  "id": "eme_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "email_message_id": "eml_3lIfQZdO0yX5nF9SuY8wC",
  "event_type": "delivered",
  "meta": {
    "recipient": "user@example.com",
    "smtp_response": "250 OK"
  },
  "occurred_at": "2025-01-15T10:30:45Z"
}

ที่เกี่ยวข้อง

• Email Message - ระเบียนข้อความ
• Email - โครงสร้างพื้นฐานอีเมล