Cloudflare Email Service

O que é o Cloudflare Email Service?

O Cloudflare Email Service é uma camada de infraestrutura para criar agentes e aplicativos nativos de e-mail. Ele permite que agentes enviem, recebam e processem e-mails usando componentes da plataforma de desenvolvedores do Cloudflare, para que você possa usar a caixa de entrada como interface em vez de criar canais separados ou integrações personalizadas.

O serviço é projetado para funcionar junto com o Cloudflare Agents SDK e ganchos de agente no estilo onEmail. Com Email Routing para mensagens de entrada e Email Sending para respostas/notificações de saída, os desenvolvedores podem implementar fluxos de e-mail bidirecionais no mesmo ambiente Cloudflare.

Principais Recursos

• Email Routing (e-mail de entrada para seu app/agente): Receba e-mails e os direcione para sua aplicação ou agente para processamento, permitindo um modelo de interação baseado na caixa de entrada.
• Email Sending (e-mail transacional de saída): Envie respostas ou notificações do seu agente/aplicação para usuários, entregando mensagens que podem ser acionadas como parte de trabalho assíncrono.
• Workers binding para Email Sending (beta público): Envie e-mails diretamente de Workers usando um binding nativo env.EMAIL.send(...) — sem gerenciamento de chaves de API ou segredos.
• REST API + SDKs para Email Sending: Envie e-mails de qualquer plataforma ou linguagem via REST API do Cloudflare, com suporte a SDKs em TypeScript, Python e Go.
• Configuração automática de autenticação de domínio (SPF/DKIM/DMARC): Ao adicionar seu domínio ao Email Service, o Cloudflare configura SPF, DKIM e DMARC para que as mensagens sejam autenticadas e entregues, em vez de configuração manual.
• Entrega global na rede Cloudflare: O Email Service é um serviço global construído na rede do Cloudflare para entrega de baixa latência em todo o mundo.
• Fluxos bidirecionais completos com Email Routing + Email Sending: Receba um e-mail, processe-o em um Worker e responda sem sair do Cloudflare.

Como Usar o Cloudflare Email Service

1. Comece com Email Routing para mensagens de entrada: Configure seu agente para receber e-mails via gancho onEmail do Agents SDK (de primeira classe para e-mail de entrada).
2. Use Email Sending para responder de forma assíncrona: Durante o beta público, adicione Email Sending para permitir que seu agente envie respostas ou notificações de e-mail de saída após processar o trabalho.
3. Envie de Workers usando o binding nativo: No seu Worker, chame env.EMAIL.send com to, from, subject e conteúdo do corpo do e-mail (o exemplo usa text).
4. Alternativamente, envie via REST API e SDKs: Use o endpoint de envio do Cloudflare Email Service para envio de e-mail do lado do servidor ou multiplataforma, com SDKs de linguagem disponíveis (TypeScript, Python, Go).
5. Adicione e autentique seu domínio de envio: Configure seu domínio no Email Service para que o Cloudflare configure SPF, DKIM e DMARC automaticamente.

Casos de Uso

• Fluxo de inbox de agente de suporte ao cliente: Use Email Routing para receber mensagens de clientes, persistir dados de ticket enquanto processa o e-mail em um agente/Worker, e envie uma resposta assíncrona após tarefas em segundo plano terminarem.
• Processamento de faturas e notificações de usuário: Crie um pipeline de faturas que recebe e-mail de entrada (ex.: documentos ou solicitações) e depois envia notificações de status ou “concluído” para usuários quando o trabalho termina.
• Fluxos de verificação de conta: Implemente interações de verificação onde o e-mail é o canal principal voltado para o usuário, incluindo envio de mensagens relacionadas à verificação da lógica do agente.
• Fluxos de multiagentes que escalam e fazem follow-up: Coordene trabalho entre sistemas, agende e-mails de follow-up e escale casos extremos via e-mail de saída quando condições forem detectadas.
• Expansão de agente multicanal sem novas UIs de cliente: Quando os usuários já verificam e-mail, exponha o agente pela caixa de entrada em vez de construir uma interface de chat personalizada por canal.

FAQ

• O Email Service é apenas para Agents? Não. A fonte descreve o Email Service como parte de uma camada de plataforma para desenvolvedores que permite que aplicações e agents enviem e-mails durante a beta pública.

• Como recebo e-mails de usuários? A fonte indica o Email Routing para receber e-mail em sua aplicação ou agent, que funciona com processamento de agent no Cloudflare.

• Agents podem enviar e-mails após trabalhos longos ou assíncronos? Sim. A fonte contrasta respostas síncronas estilo chatbot com comportamento de agent que processa trabalho ao longo do tempo e responde de forma assíncrona usando Email Sending.

• Preciso gerenciar registros SPF, DKIM e DMARC manualmente? A fonte diz que, ao adicionar seu domínio ao Email Service, o Cloudflare configura SPF, DKIM e DMARC automaticamente.

• Como envio e-mails de um Worker? Use o binding nativo dos Workers descrito na fonte: env.EMAIL.send({ to, from, subject, text }).

Alternativas

• Construir uma integração de e-mail personalizada com um provedor externo: Se preferir gerenciar o envio sozinho, pode usar APIs de e-mail de terceiros e lidar com o inbound via roteamento próprio, mas precisará construir mais do fluxo end-to-end fora da camada de roteamento/envio do Cloudflare.
• Usar um serviço dedicado de análise/roteamento de e-mail com backend de agent separado: Em vez do Email Routing + Email Sending integrado do Cloudflare, pode rotear e-mail inbound por outro provedor e ter seu backend gerar e-mails outbound.
• Usar interfaces de chat ou tickets em vez de fluxos nativos de e-mail: Para equipes focadas em interação em tempo real, um sistema de chat/tickets pode substituir o e-mail como interface principal, mas você perde a experiência baseada em inbox descrita na fonte.
• Implementar apenas e-mail transacional outbound (sem roteamento inbound): Se precisar apenas de notificações, pode usar uma API de e-mail outbound sem construir o fluxo bidirecional de recebimento e resposta.