Email Message Event (型) | Accountmaker ドキュメント

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 タイムスタンプ
}

プロパティ

Property	Type	Description
`id`	`string`	`eme_` プレフィックス付き KSUID
`account_id`	`string`	Account コンテキスト
`email_message_id`	`string`	このイベントが関連するメッセージ
`event_type`	`string`	イベント種別
`meta`	`object?`	イベント固有メタデータ
`occurred_at`	`string`	発生時刻

イベント種別

イベント種別はプロバイダ依存です。代表的な値は次の通りです。

Type	Description
`queued`	配信キューとして受理
`sent`	受信側 MTA へ引き渡し
`delivered`	受信箱への配信を確認
`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"
}