Cloudflare Email Service

Cos'è Cloudflare Email Service?

Cloudflare Email Service è un livello infrastrutturale per creare agenti e applicazioni email-native. Consente agli agenti di inviare, ricevere e processare email utilizzando i componenti della piattaforma developer di Cloudflare, così puoi usare la casella di posta come interfaccia invece di creare canali separati o integrazioni personalizzate.

Il servizio è progettato per funzionare insieme a Cloudflare Agents SDK e agli hook agent di tipo onEmail. Con Email Routing per i messaggi in ingresso e Email Sending per le risposte/notifiche in uscita, gli sviluppatori possono implementare flussi di lavoro email bidirezionali all'interno dello stesso ambiente Cloudflare.

Caratteristiche Principali

• Email Routing (email in ingresso verso la tua app/agente): Ricevi email e inoltrale alla tua applicazione o agente per l'elaborazione, abilitando un modello di interazione basato sulla casella di posta.
• Email Sending (email transazionale in uscita): Invia risposte o notifiche dalla tua app/agente agli utenti consegnando messaggi che possono essere attivati come parte di lavoro asincrono.
• Workers binding per Email Sending (beta pubblica): Invia email direttamente da Workers usando il binding nativo env.EMAIL.send(...)—senza gestione di chiavi API o segreti.
• REST API + SDK per Email Sending: Invia email da qualsiasi piattaforma o linguaggio tramite la REST API di Cloudflare, con supporto SDK per TypeScript, Python e Go.
• Configurazione automatica dell'autenticazione dominio (SPF/DKIM/DMARC): Quando aggiungi il tuo dominio a Email Service, Cloudflare configura SPF, DKIM e DMARC in modo che i messaggi siano autenticati e consegnati, senza setup manuale.
• Consegna globale sulla rete Cloudflare: Email Service è un servizio globale costruito sulla rete Cloudflare per una consegna a bassa latenza in tutto il mondo.
• Flussi di lavoro bidirezionali completi con Email Routing + Email Sending: Ricevi un'email, elaborala in un Worker e rispondi senza uscire da Cloudflare.

Come Usare Cloudflare Email Service

1. Inizia con Email Routing per i messaggi in ingresso: Configura il tuo agente per ricevere email tramite l'hook onEmail dell'Agents SDK (di primo livello per email in ingresso).
2. Usa Email Sending per risposte asincrone: Durante la beta pubblica, aggiungi Email Sending per consentire al tuo agente di inviare risposte o notifiche email in uscita dopo l'elaborazione.
3. Invia da Workers usando il binding nativo: Nel tuo Worker, chiama env.EMAIL.send con to, from, subject e contenuto del corpo email (usando text).
4. In alternativa, invia tramite REST API e SDK: Usa l'endpoint send di Cloudflare Email Service per invii server-side o cross-platform, con SDK per linguaggi disponibili (TypeScript, Python, Go).
5. Aggiungi e autentica il tuo dominio di invio: Configura il tuo dominio in Email Service così Cloudflare può impostare automaticamente SPF, DKIM e DMARC.

Casi d'Uso

• Flusso di lavoro inbox per agente di supporto clienti: Usa Email Routing per ricevere messaggi clienti, persistere i dati del ticket durante l'elaborazione dell'email in un agente/Worker e inviare una risposta asincrona dopo il completamento delle attività in background.
• Elaborazione fatture e notifiche utente: Crea una pipeline per fatture che riceve email in ingresso (es. documenti o richieste) e invia in seguito notifiche di stato o "completato" agli utenti quando il lavoro finisce.
• Flussi di verifica account: Implementa interazioni di verifica dove l'email è il canale principale verso l'utente, inclusa l'invio di messaggi di verifica dalla logica dell'agente.
• Flussi multi-agente con escalation e follow-up: Coordina il lavoro tra sistemi, programma email di follow-up e scala casi limite via email in uscita una volta rilevate le condizioni.
• Espansione multi-canale agente senza nuove UI client: Quando gli utenti controllano già l'email, espandi l'agente tramite la casella di posta invece di creare interfacce chat personalizzate per canale.

FAQ

• Email Service è solo per gli agenti? No. La fonte descrive Email Service come parte di un livello della piattaforma per sviluppatori che consente ad applicazioni e agenti di inviare email durante la beta pubblica.

• Come ricevo email dagli utenti? La fonte indica Email Routing per ricevere email nella tua applicazione o agente, che funziona con l'elaborazione degli agenti su Cloudflare.

• Gli agenti possono inviare email dopo lavori a lungo termine o asincroni? Sì. La fonte contrappone le risposte sincrone di tipo chatbot al comportamento degli agenti che possono processare il lavoro nel tempo e rispondere in modo asincrono usando Email Sending.

• Devo gestire manualmente i record SPF, DKIM e DMARC? La fonte dice che quando aggiungi il tuo dominio a Email Service, Cloudflare configura automaticamente SPF, DKIM e DMARC.

• Come posso inviare email da un Worker? Usa il binding nativo dei Workers descritto nella fonte: env.EMAIL.send({ to, from, subject, text }).

Alternative

• Costruire un'integrazione email personalizzata usando un provider email esterno: Se preferisci gestire l'invio da solo, puoi usare API email di terze parti e gestire l'inbound con il tuo routing, ma dovrai costruire più del workflow end-to-end al di fuori del livello di routing/invio di Cloudflare.
• Usare un servizio dedicato di parsing/routing email con un backend agente separato: Invece dell'integrato Email Routing + Email Sending di Cloudflare, puoi instradare l'email inbound tramite un altro provider e far generare email outbound dal tuo backend.
• Usare interfacce chat o ticketing invece di workflow email-native: Per team focalizzati su interazioni in tempo reale, un sistema chat/ticketing può sostituire l'email come interfaccia primaria, ma perdi l'esperienza inbox-based descritta nella fonte.
• Implementare solo email transazionali outbound (senza routing inbound): Se hai bisogno solo di notifiche, puoi usare un'API email outbound senza costruire il workflow bidirezionale receive-and-reply.