Cloudflare Email Service

トランザクションメールを送信し、受信メールを Worker またはメールアドレスへルーティングします

Cloudflare Email Service は、次のメール機能を提供します。

Email Sending ベータ — 送信トランザクションメール向け
Workers Paid プランで利用できます
Email Routing — 受信メールを Worker で処理するか、メールアドレスへルーティングします
Free および Paid プランで利用できます

この 2 つの機能を組み合わせると、アプリケーションからメールの送受信ができます。たとえば Email Service は次の用途に使えます。

トランザクションメール（ウェルカムメッセージ、パスワードリセット、注文確認）
認証フロー（マジックリンク、メール検証、二要素認証）
通知とアラート
カスタムメールアドレス（support@、contact@、orders@）
エージェントの操作手段としてのメール（チケット管理で issue を作成するメールなど）

Email Service には、Cloudflare Workers からバインディングで、任意のプラットフォームから REST API で、または認証済み SMTP でアクセスできます。

src/index.ts で、EMAIL バインディングを使ってメールを送信し、email() ハンドラーで受信メールを処理します。

interface Env {
	EMAIL: SendEmail;
}

export default {
	// Handle HTTP requests (Email Sending)
	async fetch(request, env, ctx): Promise<Response> {
		// Send a welcome email
		await env.EMAIL.send({
			to: "user@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.",
		});

		return new Response("Email sent successfully");
	},

	// Handle incoming emails (Email Routing)
	async email(message, env, ctx): Promise<void> {
		// Forward to support team
		if (message.to.includes("support@yourdomain.com")) {
			await message.forward("team@yourdomain.com");
		}

		// Send auto-reply
		await env.EMAIL.send({
			to: message.from,
			from: "noreply@yourdomain.com",
			subject: "We received your message",
			html: "<h1>Thank you!</h1><p>We'll get back to you soon.</p>",
		});
	},
} satisfies ExportedHandler<Env>;

Wrangler 設定ファイルにバインディングを追加します。

{
	"$schema": "node_modules/wrangler/config-schema.json",
	"name": "<ENTER_WORKER_NAME>",
	"main": "src/index.ts",
	"compatibility_date": "$today",

	// Email sending
	"send_email": [
		{
			"name": "EMAIL"
		}
	],

	// Email routing
	"email": [
		{
			"name": "EMAIL_HANDLER"
		}
	]
}

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": "user@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."
  }'

Cloudflare は REST API 向けの公式 SDK も提供しています。Node、Python、Go です。

cat > mail.txt <<EOF
From: welcome@yourdomain.com
To: user@example.com
Subject: Welcome to our service!

Thanks for signing up.
EOF

curl --ssl-reqd \
  --url "smtps://smtp.mx.cloudflare.net:465" \
  --user "api_token:<API_TOKEN>" \
  --mail-from "welcome@yourdomain.com" \
  --mail-rcpt "user@example.com" \
  --upload-file mail.txt