Cloudflare Email Service

Cloudflare Email Service란?

Cloudflare Email Service는 이메일 네이티브 에이전트와 애플리케이션을 구축하기 위한 인프라 레이어입니다. 에이전트가 Cloudflare 개발자 플랫폼 구성 요소를 사용해 이메일을 보내고, 받고, 처리할 수 있게 하여 별도의 채널이나 커스텀 통합을 만들지 않고 인박스를 인터페이스로 사용할 수 있습니다.

이 서비스는 Cloudflare Agents SDK와 onEmail 스타일 에이전트 훅과 함께 작동하도록 설계되었습니다. 인바운드 메시지에 대한 Email Routing과 아웃바운드 답장/알림에 대한 Email Sending을 통해 개발자는 동일한 Cloudflare 환경 내에서 양방향 이메일 워크플로를 구현할 수 있습니다.

주요 기능

Email Routing (인바운드 이메일 → 앱/에이전트): 이메일을 받아 애플리케이션이나 에이전트로 라우팅하여 처리하고, 인박스 기반 상호작용 모델을 가능하게 합니다.
Email Sending (아웃바운드 트랜잭션 이메일): 비동기 작업의 일부로 트리거되는 메시지를 전달하여 에이전트/애플리케이션에서 사용자에게 답장이나 알림을 보냅니다.
Workers 바인딩으로 Email Sending (공개 베타): 네이티브 env.EMAIL.send(...) 바인딩을 사용해 Workers에서 직접 이메일을 보냅니다—API 키나 시크릿 관리가 필요 없습니다.
Email Sending을 위한 REST API + SDK: Cloudflare REST API를 통해 모든 플랫폼이나 언어에서 이메일을 보내고, TypeScript, Python, Go SDK를 지원합니다.
자동 도메인 인증 설정 (SPF/DKIM/DMARC): 도메인을 Email Service에 추가하면 Cloudflare가 SPF, DKIM, DMARC를 자동 설정하여 메시지가 인증되고 전달되도록 합니다.
Cloudflare 네트워크上的 글로벌 배송: Cloudflare 네트워크에 구축된 글로벌 서비스로 전 세계 저지연 배송을 제공합니다.
Email Routing + Email Sending으로 완전한 양방향 워크플로: 이메일을 받고 Worker에서 처리한 후 Cloudflare를 벗어나지 않고 답장합니다.

Cloudflare Email Service 사용 방법

인바운드 메시지를 위한 Email Routing 시작: Agents SDK의 onEmail 훅을 통해 에이전트가 이메일을 받도록 설정합니다 (인바운드 이메일에 최적화).
비동기 답장을 위한 Email Sending 사용: 공개 베타 기간 동안 Email Sending을 추가하여 에이전트가 작업 처리 후 아웃바운드 이메일 답장이나 알림을 보낼 수 있게 합니다.
네이티브 바인딩으로 Workers에서 보내기: Worker에서 env.EMAIL.send를 호출하여 to, from, subject, 이메일 본문 내용을 지정합니다 (text 사용 예시).
대안으로 REST API와 SDK를 통해 보내기: 서버 측이나 크로스플랫폼 이메일 전송을 위해 Cloudflare Email Service 전송 엔드포인트를 사용하며, TypeScript, Python, Go 언어 SDK를 제공합니다.
전송 도메인 추가 및 인증: Email Service에서 도메인을 구성하여 Cloudflare가 SPF, DKIM, DMARC를 자동 설정합니다.

사용 사례

고객 지원 에이전트 인박스 워크플로: Email Routing으로 고객 메시지를 받고, 에이전트/Worker에서 이메일 처리 중 티켓 데이터를 유지한 후 백그라운드 작업 완료 시 비동기 답장을 보냅니다.
인보이스 처리 및 사용자 알림: 인바운드 이메일(예: 문서나 요청)을 받아 처리한 후 작업 완료 시 사용자에게 상태나 완료 알림을 보냅니다.
계정 인증 플로: 이메일을 주요 사용자 채널로 하는 인증 상호작용을 구현하며, 에이전트 로직에서 인증 관련 메시지를 보냅니다.
에스컬레이션 및 후속을 위한 멀티 에이전트 워크플로: 시스템 간 작업을 조정하고, 조건 감지 시 아웃바운드 이메일로 후속 이메일을 예약하거나 에지 케이스를 에스컬레이션합니다.
새 클라이언트 UI 없이 멀티채널 에이전트 확장: 사용자가 이미 이메일을 확인한다면 커스텀 채팅 인터페이스를 만들지 않고 인박스를 통해 에이전트를 노출합니다.

자주 묻는 질문

Email Service는 에이전트 전용인가요? 아니요. 출처는 Email Service를 공개 베타 기간 동안 애플리케이션과 에이전트가 이메일을 보낼 수 있게 하는 개발자 플랫폼 계층의 일부로 설명합니다.
사용자로부터 이메일을 받으려면 어떻게 하나요? 출처는 애플리케이션이나 에이전트로 이메일을 받기 위해 Email Routing을 가리키며, 이는 Cloudflare에서 에이전트 처리와 함께 작동합니다.
에이전트가 장기 실행 또는 비동기 작업 후에 이메일을 보낼 수 있나요? 네. 출처는 챗봇 스타일의 동기 응답과 달리, 에이전트가 시간을 두고 작업을 처리한 후 Email Sending을 사용해 비동기적으로 응답할 수 있는 동작을 대비합니다.
SPF, DKIM, DMARC 레코드를 수동으로 관리해야 하나요? 출처에 따르면 도메인을 Email Service에 추가하면 Cloudflare가 SPF, DKIM, DMARC를 자동으로 구성합니다.
Worker에서 이메일을 어떻게 보내나요? 출처에 설명된 네이티브 Workers 바인딩을 사용하세요: env.EMAIL.send({ to, from, subject, text }).

대안

외부 메일 제공자를 사용한 맞춤 이메일 통합 구축: 직접 보내기를 관리하고 싶다면 타사 이메일 API를 사용하고 인바운드를 자체 라우팅으로 처리할 수 있지만, Cloudflare의 라우팅/전송 계층 외부에서 엔드투엔드 워크플로우를 더 많이 구축해야 합니다.
별도의 에이전트 백엔드를 가진 전용 이메일 파싱/라우팅 서비스 사용: Cloudflare의 통합 Email Routing + Email Sending 대신 다른 제공자를 통해 인바운드 이메일을 라우팅하고 백엔드에서 아웃바운드 이메일을 생성할 수 있습니다.
이메일 네이티브 워크플로우 대신 채팅 또는 티케팅 인터페이스 사용: 실시간 상호작용에 중점을 둔 팀의 경우 채팅/티케팅 시스템이 이메일을 주요 인터페이스로 대체할 수 있지만, 출처에 설명된 인박스 기반 경험을 잃게 됩니다.
인바운드 라우팅 없이 아웃바운드 트랜잭션 이메일만 구현: 알림만 필요하다면 양방향 수신-응답 워크플로우를 구축하지 않고 아웃바운드 이메일 API를 사용할 수 있습니다.