Cloudflare Email Service

Что такое Cloudflare Email Service?

Cloudflare Email Service — это инфраструктурный слой для создания email-native агентов и приложений. Он позволяет агентам отправлять, получать и обрабатывать email с использованием компонентов платформы разработчиков Cloudflare, чтобы использовать inbox как интерфейс вместо создания отдельных каналов или кастомных интеграций.

Сервис предназначен для работы вместе с Cloudflare Agents SDK и хуками агентов в стиле onEmail. С Email Routing для входящих сообщений и Email Sending для исходящих ответов/уведомлений разработчики могут реализовывать двунаправленные email-воркфлоу в одной среде Cloudflare.

Ключевые возможности

• Email Routing (входящий email в ваше приложение/агент): Получайте email и направляйте его в ваше приложение или агент для обработки, обеспечивая модель взаимодействия на основе inbox.
• Email Sending (исходящий транзакционный email): Отправляйте ответы или уведомления от вашего агента/приложения пользователям, доставляя сообщения, которые могут запускаться в рамках асинхронной работы.
• Workers binding для Email Sending (public beta): Отправляйте email прямо из Workers с помощью нативного binding env.EMAIL.send(...) — без управления API-ключами или секретами.
• REST API + SDK для Email Sending: Отправляйте email с любой платформы или языка через REST API Cloudflare с поддержкой SDK на TypeScript, Python и Go.
• Автоматическая настройка аутентификации домена (SPF/DKIM/DMARC): При добавлении вашего домена в Email Service Cloudflare настраивает SPF, DKIM и DMARC, чтобы сообщения аутентифицировались и доставлялись, без ручной настройки.
• Глобальная доставка по сети Cloudflare: Email Service — глобальный сервис на сети Cloudflare для низкозадержечной доставки по всему миру.
• Полные двунаправленные воркфлоу с Email Routing + Email Sending: Получайте email, обрабатывайте его в Worker и отвечайте, не выходя из Cloudflare.

Как использовать Cloudflare Email Service

1. Начните с Email Routing для входящих сообщений: Настройте агента для получения email через хук onEmail в Agents SDK (первоочередной для входящего email).
2. Используйте Email Sending для асинхронных ответов: Во время public beta добавьте Email Sending, чтобы агент мог отправлять исходящие ответы или уведомления после обработки работы.
3. Отправляйте из Workers с нативным binding: В Worker вызывайте env.EMAIL.send с to, from, subject и содержимым тела email (пример с text).
4. Альтернативно, отправляйте через REST API и SDK: Используйте endpoint отправки Cloudflare Email Service для серверной или кросс-платформенной отправки email с доступными SDK на языках (TypeScript, Python, Go).
5. Добавьте и аутентифицируйте домен отправки: Настройте домен в Email Service, чтобы Cloudflare автоматически установил SPF, DKIM и DMARC.

Сценарии использования

• Воркфлоу inbox для агента поддержки клиентов: Используйте Email Routing для получения сообщений клиентов, сохраняйте данные тикета при обработке email в агенте/Worker и отправляйте асинхронный ответ после завершения фоновых задач.
• Обработка инвойсов и уведомления пользователей: Создайте пайплайн инвойсов, который получает входящий email (например, документы или запросы) и позже отправляет статус или уведомления «готово» пользователям по завершении работы.
• Флоу верификации аккаунтов: Реализуйте взаимодействия верификации, где email — основной канал для пользователей, включая отправку сообщений, связанных с верификацией, из логики агента.
• Мультиагентные воркфлоу с эскалацией и фоллоу-апами: Координируйте работу по системам, планируйте фоллоу-ап email и эскалируйте редкие случаи через исходящий email при обнаружении условий.
• Расширение агента на мультиканалы без новых UI клиентов: Когда пользователи уже проверяют email, предоставляйте доступ к агенту через inbox вместо создания кастомного чат-интерфейса для каждого канала.

Часто задаваемые вопросы

• Email Service предназначен только для агентов?
  Нет. В источнике Email Service описан как часть платформы для разработчиков, которая позволяет приложениям и агентам отправлять email во время public beta.

• Как получать письма от пользователей?
  В источнике указывается на Email Routing для приема email в ваше приложение или агент, что работает с обработкой агентов на Cloudflare.

• Могут ли агенты отправлять email после длительной или асинхронной работы?
  Да. В источнике проводится контраст между синхронными ответами в стиле чат-бота и поведением агентов, которые могут обрабатывать работу со временем и отвечать асинхронно с помощью Email Sending.

• Нужно ли вручную управлять записями SPF, DKIM и DMARC?
  В источнике говорится, что при добавлении вашего домена в Email Service Cloudflare автоматически настраивает SPF, DKIM и DMARC.

• Как отправлять email из Worker?
  Используйте нативное связывание Workers, описанное в источнике: env.EMAIL.send({ to, from, subject, text }).

Альтернативы

• Создать кастомную email-интеграцию с внешним почтовым провайдером: Если вы предпочитаете управлять отправкой самостоятельно, можно использовать сторонние email API и обрабатывать входящие через собственный роутинг, но придется строить больше end-to-end workflow вне слоя роутинга/отправки Cloudflare.
• Использовать специализированный сервис парсинга/роутинга email с отдельным бэкендом агента: Вместо интегрированного Email Routing + Email Sending от Cloudflare можно роутить входящие email через другого провайдера, а бэкенд генерировать исходящие.
• Использовать чат или тикетинг-интерфейсы вместо email-native workflow: Для команд, ориентированных на реальное время, система чата/тикетинга может заменить email как основной интерфейс, но вы потеряете inbox-based опыт, описанный в источнике.
• Реализовать только исходящий транзакционный email (без входящего роутинга): Если нужны только уведомления, можно использовать исходящий email API без построения двунаправленного workflow приема и ответа.