Cloudflare Email Sendingがパブリックベータ版になりました

Cloudflareのメール送信機能がパブリックベータ版で利用できるようになりました。

このprivate beta版発表の記事を見て、waitlist登録して待っていたら急に公開されて驚きです。

料金体系

Pricing · Cloudflare Email Service docs

Email Service pricing for outbound sending and inbound routing across Workers Free and Paid plans.

developers.cloudflare.com

/rehype-og-card/8296afa6d6fd4272604efbce5ba273ddbe659264a14439d77e21914a1ff1e54a.png

メール送信機能はWorkers Paidプラン($5/月)で利用でき、月3,000通まではプランに含まれ、以降1,000通ごとに$0.35かかる料金体系となっています。

1ヶ月に無料で送信できる通数はResendと同じですね。

制限

Limits · Cloudflare Email Service docs

Email Service sending quotas, rate limits, message size limits, and compliance requirements.

developers.cloudflare.com

1日の送信制限

Cloudflareアカウント状況の評価によって設定されていることがあるらしく、自分のアカウントでは200通/日でした。

メールのコンテンツ制限

宛先はCC、BCC合算で50/通
件名は998文字制限(RFC 5322準拠)
添付ファイル込みでメッセージサイズは25MiBまで
ヘッダーサイズは16KBまで

Workersの制限

Workersバインディングを介したメール送信が制限の適用対象

CPU時間は、50ms/リクエスト
サブリクエストは、メール送信操作込みで50
メモリは、128MB

メール到達率

ハードバウンス

送信先のメールアドレスやドメインが存在しないなど永続的な失敗の場合は再試行されず、サプレッションリストに自動的にアドレスが追加されます。

ソフトバウンス

一方受信者のメールボックスがいっぱいだったり、メールサーバーがダウンしていたり、一時的な失敗は指数バックオフ方式で自動的に再試行されます。

Email Sending管理画面

設定したドメインの一覧が確認できます。

ドメイン設定

ドメインをオンボードボタンから行えます。

ゾーン選択でメール送信に使用するドメインを選択し、必要に応じてサブドメインを入力します。

追加されるDNSレコードを確認し、問題なければ完了ボタンでメール送信に使用できるようになります。

サプレッションリスト

抑制ボタンから確認できます(あふれる直訳感)。

ハードバウンス、ソフトバウンス、スパム報告に基づいて自動的に登録されたメールアドレスのほか、手動で登録(有効期限設定あり)することもできます。

リストから削除することも可能(スパム報告によって追加されたメールアドレスは削除不可)。

実装

REST API か Workersバインディングのどちらかを使用してメール送信を行うことができます。

REST API

REST API · Cloudflare Email Service docs

Send emails from any application using the Email Service REST API with standard HTTP requests.

developers.cloudflare.com

エンドポイントに使用するaccount_idとAPIトークンが必要です。

APIトークンはAuthorizationヘッダーに含めます。

# request
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send" \
  --header "Authorization: Bearer <API_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "to": "recipient@example.com",
    "from": "welcome@yourdomain.com",
    "subject": "Welcome to our service!",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "text": "Welcome! Thanks for signing up."
  }'

# response
{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "delivered": ["recipient@example.com"], # 即座に配信されたメールアドレス
    "permanent_bounces": [], # 永久に配信不能となったメールアドレス
    "queued": [] # キューイングされたメールアドレス
  }
}

REST APIは数値エラーコードを返しますが、Workersバインディング使用の場合はエラーコードが文字列でスローされるみたいです。

Workersバインディング

Workers API · Cloudflare Email Service docs

Send emails directly from Cloudflare Workers using the Email Service binding and send() method.

developers.cloudflare.com

バインディング設定

// wrangler.jsonc
{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "send_email": [
    {
      "name": "EMAIL"
    }
  ]
}

送信方法

const response = await env.EMAIL.send({
  to: ["user1@example.com", "user2@example.com", "user3@example.com"], // 複数の宛先を指定
  from: { email: "newsletter@yourdomain.com", name: "Newsletter Team" },
  subject: "Monthly Newsletter",
  html: "<h1>This month's updates</h1>",
  text: "This month's updates",
});