Cloudflare Email Service

¿Qué es Cloudflare Email Service?

Cloudflare Email Service es una capa de infraestructura para crear agentes y aplicaciones nativas de email. Permite a los agentes enviar, recibir y procesar email utilizando componentes de la plataforma de desarrolladores de Cloudflare, para que puedas usar el buzón como interfaz en lugar de crear canales separados o integraciones personalizadas.

El servicio está diseñado para funcionar junto con Cloudflare Agents SDK y ganchos de agente estilo onEmail. Con Email Routing para mensajes entrantes y Email Sending para respuestas/notificaciones salientes, los desarrolladores pueden implementar flujos de email bidireccionales en el mismo entorno de Cloudflare.

Características principales

• Email Routing (email entrante a tu app/agente): Recibe email y envíalo a tu aplicación o agente para procesarlo, habilitando un modelo de interacción basado en el buzón.
• Email Sending (email transaccional saliente): Envía respuestas o notificaciones desde tu agente/aplicación a los usuarios entregando mensajes que se pueden activar como parte de trabajo asíncrono.
• Workers binding para Email Sending (beta pública): Envía emails directamente desde Workers usando un binding nativo env.EMAIL.send(...)—sin gestión de claves API o secretos.
• REST API + SDKs para Email Sending: Envía emails desde cualquier plataforma o lenguaje vía la REST API de Cloudflare, con soporte para SDKs de TypeScript, Python y Go.
• Configuración automática de autenticación de dominio (SPF/DKIM/DMARC): Al agregar tu dominio a Email Service, Cloudflare configura SPF, DKIM y DMARC para que los mensajes se autentiquen y entreguen en lugar de dejarlo en configuración manual.
• Entrega global en la red de Cloudflare: Email Service es un servicio global construido sobre la red de Cloudflare para entrega de baja latencia en todo el mundo.
• Flujos bidireccionales completos con Email Routing + Email Sending: Recibe un email, procésalo en un Worker y responde sin salir de Cloudflare.

Cómo usar Cloudflare Email Service

1. Comienza con Email Routing para mensajes entrantes: Configura tu agente para recibir email vía el hook onEmail del Agents SDK (de primera clase para email entrante).
2. Usa Email Sending para responder de forma asíncrona: Durante la beta pública, agrega Email Sending para que tu agente envíe respuestas o notificaciones salientes después de procesar el trabajo.
3. Envía desde Workers usando el binding nativo: En tu Worker, llama a env.EMAIL.send con to, from, subject y contenido del cuerpo del email (el ejemplo usa text).
4. Alternativamente, envía vía REST API y SDKs: Usa el endpoint send de Cloudflare Email Service para envío de email del lado del servidor o multiplataforma, con SDKs de lenguaje disponibles (TypeScript, Python, Go).
5. Agrega y autentica tu dominio de envío: Configura tu dominio en Email Service para que Cloudflare configure SPF, DKIM y DMARC automáticamente.

Casos de uso

• Flujo de buzón de agente de soporte al cliente: Usa Email Routing para recibir mensajes de clientes, persiste datos de tickets mientras procesas el email en un agente/Worker, y envía una respuesta asíncrona después de que las tareas en segundo plano se completen.
• Procesamiento de facturas y notificaciones a usuarios: Crea un pipeline de facturas que recibe email entrante (p. ej., documentos o solicitudes) y luego envía notificaciones de estado o “hecho” a usuarios cuando el trabajo termine.
• Flujos de verificación de cuentas: Implementa interacciones de verificación donde el email es el canal principal面向 al usuario, incluyendo envío de mensajes relacionados con verificación desde la lógica del agente.
• Flujos multiagente que escalan y hacen seguimiento: Coordina trabajo entre sistemas, programa emails de seguimiento y escala casos límite vía email saliente una vez detectadas las condiciones.
• Expansión multi-canal de agentes sin nuevas UI de cliente: Cuando los usuarios ya revisan email, expón el agente a través del buzón en lugar de construir una interfaz de chat personalizada por canal.

Preguntas frecuentes

• ¿Email Service es solo para Agents? No. La fuente describe Email Service como parte de una capa de plataforma para desarrolladores que permite a las aplicaciones y agentes enviar correos durante la beta pública.

• ¿Cómo recibo correos de los usuarios? La fuente indica Email Routing para recibir correo en tu aplicación o agente, que funciona con el procesamiento de agentes en Cloudflare.

• ¿Pueden los agentes enviar correos después de trabajos prolongados o asíncronos? Sí. La fuente contrasta las respuestas síncronas estilo chatbot con el comportamiento de agentes que procesan trabajo a lo largo del tiempo y responden de forma asíncrona usando Email Sending.

• ¿Necesito gestionar manualmente los registros SPF, DKIM y DMARC? La fuente indica que al agregar tu dominio a Email Service, Cloudflare configura SPF, DKIM y DMARC automáticamente.

• ¿Cómo envío correos desde un Worker? Usa el binding nativo de Workers descrito en la fuente: env.EMAIL.send({ to, from, subject, text }).

Alternativas

• Construir una integración de correo personalizada con un proveedor externo: Si prefieres gestionar el envío tú mismo, puedes usar APIs de correo de terceros y manejar el inbound con tu propio enrutamiento, pero necesitarás construir más del flujo de trabajo de extremo a extremo fuera de la capa de enrutamiento/envío de Cloudflare.
• Usar un servicio dedicado de análisis/enrutamiento de correo con un backend de agente separado: En lugar de Email Routing + Email Sending integrado de Cloudflare, puedes enrutar el correo entrante a través de otro proveedor y que tu backend genere correos salientes.
• Usar interfaces de chat o ticketing en lugar de flujos nativos de correo: Para equipos enfocados en interacción en tiempo real, un sistema de chat/ticketing puede reemplazar el correo como interfaz principal, pero pierdes la experiencia basada en bandeja de entrada descrita en la fuente.
• Implementar solo correo transaccional saliente (sin enrutamiento entrante): Si solo necesitas notificaciones, puedes usar una API de correo saliente sin construir el flujo bidireccional de recepción y respuesta.