INTEGRITY Документация

← Cloudflare Email Service / email-service

Cloudflare Email Service

Отправка транзакционных писем и маршрутизация входящих писем в Workers или на email-адреса

Cloudflare Email Service предоставляет мощные возможности для работы с почтой:

Вместе эти две функции позволяют отправлять и получать электронную почту из ваших приложений. Например, Email Service можно использовать для:

Обращайтесь к Email Service напрямую из Cloudflare Workers с помощью привязки, с любой платформы с помощью REST API, или более аутентифицированный SMTP:

Отправляйте письма с помощью EMAIL привязку и обрабатывать входящие письма с помощью email() обработчик в 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>;

Добавьте привязки в файл конфигурации 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 также предоставляет официальные SDK для REST API: Node, Python, а также 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

Ознакомьтесь с полным Справочник по API для REST API, привязки Workers и SMTP.

Начало работы

Возможности

Email Sending

Отправляйте транзакционные письма с высокой доставляемостью и глобальной производительностью.

Email Routing

Маршрутизируйте входящие письма на произвольные адреса, в Workers или на внешние адреса назначения.

Доставляемость

Автоматическое управление репутацией IP-адресов и оптимизация доставляемости.

Аналитика и наблюдаемость

Отслеживайте эффективность отправки писем с помощью комплексных метрик и оповещений.

API

Отправляйте и маршрутизируйте письма с помощью REST API, Workers привязка, или SMTP.

Workers

Создавайте serverless-приложения, которые отправляют письма прямо из edge-сети.

Queues

Обрабатывайте события писем асинхронно с помощью интеграции с Workers Queues.

Analytics Engine

Сохраняйте и анализируйте собственные метрики электронной почты с помощью Workers Analytics Engine.

Дополнительные ресурсы

Цены

Узнайте о тарификации и планах Email Service.

Примеры

Изучите практические примеры и шаблоны реализации.

Discord

Задавайте вопросы и обсуждайте Email Service с другими разработчиками.

Twitter

Следите за анонсами продуктов и обновлениями для разработчиков.

Содержание

51 страница, воспроизведённая из документации Cloudflare по email-service.

Pages

Справочник по API

Основные понятия

Конфигурация

Примеры

Начало работы

Локальная разработка

Наблюдаемость и журналы

Платформа

Справочник