Cloudflare Email Workers: La Guida Definitiva all'Inoltro Multiplo

Come Superare i Limiti del Routing Base

Se usi Cloudflare, sai che il suo servizio di Email Routing (che instrada le email senza offrirti una vera casella di posta) è un ottimo strumento per gli alias di dominio. Ma cosa succede se devi inoltrare una singola email, ad esempio info@tuodominio.com, a più persone contemporaneamente?

Mentre l'instradamento base di Cloudflare è pensato per destinazioni singole, la risposta è sfruttare la potenza di calcolo serverless: i Cloudflare Email Workers.

Questo articolo ti guiderà passo dopo passo per creare il tuo centralino di smistamento email personalizzato, incluso come superare i due ostacoli più comuni nel debugging.

1. Il Codice: Il Tuo Worker Multi-Forwarder

Un Email Worker è una funzione JavaScript che viene eseguita non appena un'email arriva a un alias configurato. Questo codice legge l'email e decide a chi inoltrarla.

Copia e incolla questo codice nel tuo Worker. È già ottimizzato per gestire più destinazioni e include i log di errore essenziali per il debugging (che ci sono stati molto utili!):


export default {
    async email(message, env, ctx) {
        // *** AGGIORNA QUI I TUOI INDIRIZZI DI DESTINAZIONE ***
        const destinatari = [
            "indirizzo1@esempio.com", // Sostituisci con il primo indirizzo
            "indirizzo2@esempio.com"  // Sostituisci con il secondo indirizzo
        ];

        console.log(`WORKER INIZIATO: Elaborazione email da ${message.from}`);

        for (const destinatario of destinatari) {
            try {
                // Tentativo di inoltrare l'email
                await message.forward(destinatario);
                
                // Log di successo: indica che Cloudflare ha accettato l'inoltro
                console.log(`✅ SUCCESSO: Richiesta di inoltro a ${destinatario} inviata.`);
            } catch (error) {
                // Log di errore: cruciale se l'indirizzo non è verificato!
                console.error(`❌ ERRORE CRITICO INOLTRO a ${destinatario}: ${error.message}`);
            }
        }

        console.log("WORKER TERMINATO: Elaborazione conclusa.");
    },
};

2. Guida Step-by-Step all'Implementazione

Segui questi passaggi per mettere il codice in funzione sul tuo dominio.

A. Creazione e Configurazione del Worker

La creazione del Worker deve iniziare dalla sezione Email Routing e non dalla sezione Workers & Pages standard:

Accedi alla dashboard Cloudflare e seleziona il tuo dominio.
Vai su Email Routing (Instradamento Email).
Cerca la sezione Email Workers (o Worker di posta elettronica) e clicca su "Creare un nuovo Worker".
Assegna un nome al Worker (es. MultiSender).
Una volta nell'editor, cancella il codice esistente e incolla il codice fornito sopra.
Clicca su "Salva e Distribuisci" (o "Save and Deploy").

B. Verifica delle Destinazioni (Passaggio Obbligatorio!)

Questo è il motivo principale dei fallimenti silenziosi. Devi dire a Cloudflare che controlli gli indirizzi a cui stai inoltrando:

Torna alla sezione Email Routing.
Vai su Destinazioni (Verified Destinations).
Aggiungi e verifica ogni singolo indirizzo presente nella lista destinatari del tuo Worker.
Controlla le rispettive caselle di posta e clicca sul link di conferma inviato da Cloudflare. Solo dopo questa azione lo stato risulterà "Verificato" (Validated).

C. Associazione del Worker alla Route

Ora, associa l'alias del tuo dominio al Worker:

Torna alla sezione Email Routing > Regole (Routes).
Clicca su "Crea una Regola".
Se l'indirizzo è: Inserisci l'alias desiderato (es. test@tuodominio.com).
Azione: Seleziona Worker (o Email Worker).
Seleziona il Worker: Scegli il nome del Worker creato (MultiSender).
Salva la regola.

3. La Prova del Nove: Come Debuggare il Tuo Worker

Se hai inviato un'email di prova a test@tuodominio.com e non è arrivata, non arrenderti! La nostra esperienza ci insegna che il problema è quasi sempre in questi due punti:

1. Controllo dei Log Interni del Worker

L'unico modo per sapere cosa ha fatto il codice è vedere i log interni, non il Registro Attività dell'Email Routing:

Vai su Workers & Pages > Seleziona il tuo Worker > Logs (Registro) o Osservabilità.
Invia un'altra email di prova e guarda i messaggi:

Se vedi un log ❌ ERRORE CRITICO: Ritorna al punto 2.B (Verifica delle Destinazioni), l'errore indica quasi sempre che un indirizzo non è stato verificato.
Se vedi un log ✅ SUCCESSO: Il Worker ha finito il suo lavoro. Il problema è la ricezione.

2. I Filtri Anti-Spam di Gmail

Se i log indicano SUCCESSO, ma il destinatario non ha ricevuto l'email (come è successo a noi!):

L'email è stata inoltrata correttamente, ma i filtri di Gmail o Outlook l'hanno considerata potenzialmente sospetta (perché l'indirizzo di origine non corrisponde al server di Cloudflare).
Soluzione: Il destinatario deve cercare nella cartella Spam e spostare l'email in Posta in arrivo, contrassegnandola come "Non Spam". Deve inoltre aggiungere l'indirizzo alias ai suoi contatti.

Con il Worker, non solo risolvi il problema dell'inoltro multiplo, ma aggiungi una piattaforma di automazione incredibilmente flessibile al tuo flusso di posta elettronica!

Disclosure: i collegamenti in questo sito sono "link di affiliazione". Ciò significa che se fai clic sul collegamento e acquisti l'articolo, riceveremo una commissione di affiliazione. Divi è un marchio registrato di Elegant Themes, Inc. Questo sito non fa parte di Elegant Themes inc.