DocsDigest
一覧へLanguage: EN
OpenAICloudflare Developer Platform2026/07/15 0:00

Email Service, Queues - Subscribe to Email Sending events with Queues

要点だけを先に読めるように短く再構成したセクションです。

元記事
OpenAIClaude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Queues経由で受信するEmail送信イベントの購読

emailqueuesevent-drivendeliverabilitysmtpcloudflare

Key Points

  • Queuesで受信可能
  • 送信ドメイン単位の購読
  • 6種類の送信イベント

Summary

CloudflareのEmail Serviceで、Queuesイベント購読を使って送信トランザクションのライフサイクルイベントを受け取れるようになりました。購読は送信ドメイン単位（ゾーンアペックス例: example.com、または検証済みサブドメイン例: send.example.com）で設定します。公開されるイベントは以下の6種類です：message.delivered、message.deferred、message.bounced、message.failed、message.rejected、message.complained。Email RoutingイベントはQueuesソースでは発行されません。各イベントにはmessageId、recipient、terminal、delivery.status、delivery.smtpStatusCodeなどの詳細が含まれます。

Key Points

  • 購読は1サブスクリプションにつき1送信ドメインをスコープ
  • 受信イベントを使って配信成功／失敗、バウンス、苦情を検知し、抑制リスト更新や再試行ロジックに結び付ける
  • イベントpayloadにはSMTP応答コード(smtpStatusCode)と配信ステータスが含まれるため自動化判定が可能
  • Email RoutingイベントはQueuesでは配信されない点に注意
  • 詳しいペイロード例と全イベント一覧は「Event subscriptions」を参照

Practical actions

  • ドメインごとにQueue購読を作成してイベントをコンシュームする
  • message.bounced / message.complainedで抑制リストを更新する実装を追加
  • message.deferred / message.failedをもとに再試行とバックオフ戦略を実装
  • smtpStatusCodeとdelivery.statusを監視・アラート条件に組み込む

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Email Service、Queues — Queuesを使ってメール送信イベントを購読する

概要

Queues のイベント購読を通じて Email Sending イベントを購読し、送信されるトランザクショナルメールのライフサイクルイベントをキューで受信できます。

スコープ

  • 各サブスクリプションは 1 つの送信ドメインにスコープされます — ゾーンアペックス（例: example.com）または検証済み送信サブドメイン（例: send.example.com）。

公開されるイベントタイプ

  • message.delivered
  • message.deferred
  • message.bounced
  • message.failed
  • message.rejected
  • message.complained

これらを使用して配信率を追跡し、バウンスや苦情に対応し、抑止（suppression）や再試行（retry）ロジックを駆動できます。Email Routing イベントはこのソースでは公開されません。

イベントペイロード

各イベントにはメッセージの詳細、配信ステータス、および SMTP レスポンスが含まれます:

{ " type " : "cf.email.sending.message.delivered" , " source " : { " type " : "email.sending" , " zoneId " : "023e105f4ecef8ad9ca31a8372d0c353" , " domain " : "example.com" }, " payload " : { " messageId " : "0101018f7d0c4d9a-msg-deadbeef" , " recipient " : "user@example.net" , " terminal " : true , " delivery " : { " status " : "delivered" , " smtpStatusCode " : "250" } } }

詳細と他のイベントタイプおよびサンプルペイロードについては Event subscriptions を参照してください。