Editor Sieve grezzo per filtri email avanzati

La maggior parte degli utenti non avrà mai bisogno di questa pagina. Il generatore visuale di TrekMail copre quasi tutte le esigenze ed è più semplice. Ma per sviluppatori, amministratori IT che gestiscono decine di caselle o utenti esperti che hanno raggiunto i suoi limiti, l'editor Sieve grezzo offre il pieno controllo della posta in arrivo.

Per attivare uno script grezzo serve un piano Agency attivo. Con gli altri piani puoi salvare una bozza nell'editor, ma non verrà eseguita.

Che cos'è Sieve?

Sieve è un piccolo linguaggio di scripting per filtrare le email. Le sue istruzioni vengono eseguite all'arrivo di ogni nuovo messaggio. Una regola può controllare mittente, oggetto, dimensione o intestazioni e poi spostare, inoltrare, contrassegnare, rifiutare o inviare una risposta automatica.

Rispetto alle regole lato client di Outlook o Apple Mail, Sieve funziona sul server, 24 ore su 24, anche a computer spento o applicazione chiusa. Tutti i dispositivi collegati vedono lo stesso risultato.

Non devi imparare Sieve per usare TrekMail. Il generatore visuale scrive Sieve dietro le quinte. L'editor grezzo ti permette di farlo direttamente quando ti serve qualcosa che il generatore non può esprimere.

Quando usare Sieve grezzo o i filtri visuali

Usa il generatore visuale quando:

• Ti servono condizioni semplici come "il mittente contiene X" o "l'oggetto contiene Y".
• Vuoi spostare, inoltrare, contrassegnare, rifiutare o eliminare messaggi.
• Non ti senti a tuo agio con il codice.
• Vuoi modifiche rapide senza preoccuparti della sintassi.

Usa l'editor Sieve grezzo quando:

• Ti serve una logica complessa, per esempio "se questo E quello, ma NON l'altro".
• Vuoi usare espressioni regolari per formati specifici, come i numeri d'ordine.
• Devi combinare risposta per le vacanze, filtri e inoltro in un unico script.
• Ti serve una logica non rappresentabile con condizioni e azioni visuali.
• Gestisci modelli da copiare in molte caselle.

Dove trovarlo

1. Apri il pannello TrekMail e vai a Caselle.
2. Scegli Gestisci accanto alla casella.
3. Apri la scheda Sieve.
4. Vedrai un editor di codice. In un account Agency idoneo contiene inizialmente lo script generato dai filtri gestiti esistenti. Modificalo o scrivine uno nuovo.
5. Fai clic su Salva e attiva per caricare e applicare lo script.

L'editor apre lo script corrente o uno spazio vuoto se non ne esiste ancora uno. Scrivi o incolla il codice, quindi fai clic su Salva e attiva.

Estensioni supportate

Sieve è modulare: le estensioni aggiungono funzioni al linguaggio di base.

Dichiara ogni estensione all'inizio con require. Prima dell'attivazione, il server convalida lo script e rifiuta estensioni non supportate o rischiose.

Script di esempio

Ecco quattro script completi e commentati da adattare.

Esempio 1: inoltro condizionale complesso

Inoltra le email di un cliente con "proposal" nell'oggetto e più piccole di 5 MB, poi le archivia nella cartella del progetto e le contrassegna.

require ["fileinto", "copy", "imap4flags", "relational", "comparator-i;ascii-numeric"];

# Forward proposal emails from client, but only if they are under 5MB
if allof (
    address :contains "from" "@bigclient.com",
    header :contains "subject" "proposal",
    size :under 5M
) {
    # Send a copy to the project manager
    redirect :copy "pm@youragency.com";

    # Flag it for follow-up
    addflag "\\Flagged";

    # File it in the client folder
    fileinto "Clients/BigClient/Proposals";

    # Stop processing further rules
    stop;
}

# Everything else from this client goes to their general folder
if address :contains "from" "@bigclient.com" {
    fileinto "Clients/BigClient";
    stop;
}

Funzione: la prima regola trova solo le proposte del cliente sotto 5 MB e le inoltra, contrassegna e archivia. La seconda raccoglie tutto il resto dello stesso cliente nella cartella generale.

Esempio 2: espressioni regolari per numeri d'ordine

Trova email con numeri come ORD-12345 o ORD-98765 e le archivia automaticamente.

require ["fileinto", "regex"];

# Match order confirmation emails with order numbers like ORD-#####
if header :regex "subject" "ORD-[0-9]{4,6}" {
    fileinto "Orders";
    stop;
}

# Match support ticket numbers like TICKET-####
if header :regex "subject" "TICKET-[0-9]{3,}" {
    fileinto "Support Tickets";
    stop;
}

Funzione: le espressioni regolari confrontano modelli. [0-9]{4,6} significa "da 4 a 6 cifre" e trova ORD-1234, ORD-12345 e ORD-123456 senza elencare ogni numero.

Esempio 3: vacanza, archiviazione e inoltro insieme

Un solo script risponde durante l'assenza, inoltra le urgenze a una collega e archivia il resto per categoria.

require ["fileinto", "vacation", "copy", "imap4flags"];

# Auto-reply to everyone (once per 3 days per sender)
vacation :days 3 :subject "Out of office until April 15"
    "Thanks for your email. I am out of the office until April 15
with limited access to email. For urgent matters, please contact
Sarah at sarah@youragency.com. I will reply when I return.";

# Forward urgent emails to Sarah immediately
if header :contains "subject" "urgent" {
    redirect :copy "sarah@youragency.com";
    addflag "\\Flagged";
}

# File invoices
if header :contains "subject" "invoice" {
    fileinto "Invoices";
    stop;
}

# File newsletters
if address :contains "from" "newsletter" {
    fileinto "Newsletters";
    stop;
}

Funzione: vacation risponde a ogni messaggio, al massimo una volta ogni 3 giorni per mittente. Poi le regole ordinano la posta. Non usando stop, la risposta lascia proseguire lo script e si combina con gli altri filtri.

Esempio 4: contrassegno tramite intestazione personalizzata

Alcuni sistemi aggiungono intestazioni come X-Priority. Questo script le legge e contrassegna i messaggi prioritari.

require ["imap4flags", "fileinto", "relational", "comparator-i;ascii-numeric"];

# X-Priority: 1 = highest, 5 = lowest
# Flag messages marked as high priority by the sending server
if header :value "le" :comparator "i;ascii-numeric"
    "X-Priority" "2" {
    addflag "\\Flagged";
}

# File low-priority messages (4 or 5) into a "Low Priority" folder
if header :value "ge" :comparator "i;ascii-numeric"
    "X-Priority" "4" {
    fileinto "Low Priority";
    stop;
}

Funzione: in X-Priority, 1 è la priorità massima e 5 la minima. :value "le" significa "minore o uguale" e contrassegna priorità 1 e 2. Le priorità 4 e 5 vengono spostate fuori dalla posta in arrivo.

Note importanti

Gli script grezzi sostituiscono i filtri visuali. Salvando uno script Sieve grezzo sostituisci i filtri creati nel generatore per quella casella. Rimangono salvati ma inattivi. Per tornare indietro, fai clic su Ripristina impostazioni predefinite nella scheda Sieve.

Il server convalida prima dell'attivazione. Con Salva e attiva controlla la sintassi. In caso di errore mostra il problema e non attiva lo script. Il precedente script o i filtri visuali restano operativi fino alla correzione.

require è obbligatorio. Ogni estensione usata va elencata in require. Se usi fileinto e vacation senza dichiararle, il server rifiuta lo script. Nel dubbio, includi tutto ciò che può servire.

Lo spam viene filtrato prima dello script. TrekMail controlla lo spam sul server prima di Sieve. Lo script vede solo i messaggi che hanno superato il controllo e non richiede regole antispam.

Tornare ai filtri visuali

Per smettere di usare lo script grezzo:

1. Apri la scheda Sieve della casella.
2. Fai clic su Ripristina impostazioni predefinite in alto a destra.
3. Conferma l'azione.

Il tuo script viene eliminato e quello generato dai filtri visuali viene ripristinato. I filtri visuali restano conservati mentre il grezzo è attivo; il ripristino li riattiva.

Anche salvare una modifica nella scheda Filtri riporta la casella allo script gestito. Risposta automatica non sovrascrive lo script grezzo: torna prima alla modalità gestita e poi impostala.

Errori comuni e soluzioni

require dimenticato. Ogni estensione va dichiarata. Per "unknown command fileinto", aggiungi require ["fileinto"]; all'inizio.

Punto e virgola mancante. Ogni comando Sieve termina con un punto e virgola. In caso di token imprevisti, controlla soprattutto stop, discard e fileinto.

Stringhe senza virgolette. Nomi di cartelle, indirizzi e valori richiedono virgolette doppie. fileinto Newsletters; non funziona; fileinto "Newsletters"; è corretto.

Barra inversa nei contrassegni. I contrassegni IMAP \Flagged e \Seen richiedono due barre in Sieve: "\\Flagged" e "\\Seen". Una sola barra è un carattere di escape e provoca errori.

La cartella non esiste. Creala nel client prima di instradarvi la posta. Uno script grezzo non crea automaticamente una cartella mancante, salvo supporto specifico di script e server.

Script troppo grande. Esiste un limite pratico. Oltre qualche centinaio di righe, valuta se alcune regole possono essere gestite dal generatore visuale. Non tutto deve stare in un solo script.