INTEGRITY Dokumentace

← Cloudflare Email Service / email-service

Cloudflare Email Service

Odesílejte transakční e-maily a směrujte příchozí e-maily na Workers nebo e-mailové adresy

Cloudflare Email Service nabízí výkonné e-mailové funkce:

Tyto dvě funkce společně umožňují odesílat a přijímat e-maily z vašich aplikací. Službu Email Service můžete použít například pro:

Přistupujte ke službě Email Service přímo z Cloudflare Workers pomocí vazby, z jakékoli platformy pomocí REST API, nebo přes ověřené SMTP:

Odesílejte e-maily pomocí EMAIL binding a zpracovávat příchozí e-maily pomocí email() handler v src/index.ts:

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: "[email protected]",
			from: "[email protected]",
			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("[email protected]")) {
			await message.forward("[email protected]");
		}

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

Přidejte bindingy do konfiguračního souboru 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": "[email protected]",
    "from": "[email protected]",
    "subject": "Welcome to our service!",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "text": "Welcome! Thanks for signing up."
  }'

Cloudflare také poskytuje oficiální SDK pro REST API: Node, Python, a Go.

cat > mail.txt <<EOF
From: [email protected]
To: [email protected]
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 "[email protected]" \
  --mail-rcpt "[email protected]" \
  --upload-file mail.txt

Podívejte se na celý Referenční dokumentace API pro REST API, Workers binding a SMTP.

Začínáme

Funkce

Email Sending

Odesílejte transakční e-maily s vysokou doručitelností a globálním výkonem.

Email Routing

Směrujte příchozí e-maily na vlastní adresy, Workery nebo externí cíle.

Doručitelnost

Automatická správa reputace IP adres a optimalizace doručitelnosti.

Analytika a observabilita

Sledujte výkon e-mailů pomocí komplexních metrik a upozornění.

API

Odesílejte a směrujte e-maily pomocí REST API, Workers vazba, nebo SMTP.

Workers

Vytvářejte serverless aplikace, které dokážou odesílat e-maily přímo z edge sítě.

Queues

Zpracovávejte e-mailové události asynchronně díky integraci s Workers Queues.

Analytics Engine

Ukládejte a analyzujte vlastní metriky e-mailů pomocí Workers Analytics Engine.

Další zdroje

Ceny

Přehled cen a tarifů služby Email Service.

Příklady

Podívejte se na praktické příklady a vzory implementace.

Discord

Pokládejte otázky a diskutujte o Email Service s dalšími vývojáři.

Twitter

Sledujte oznámení o produktech a novinky pro vývojáře.

Obsah

51 stránek zrcadlených z dokumentace Cloudflare pro email-service.

Pages

Referenční dokumentace API

Základní pojmy

Konfigurace

Příklady

Začínáme

Lokální vývoj

Pozorovatelnost a protokoly

Platforma

Referenční informace