Sieve-Roheditor für erweiterte E-Mail-Filter

Die meisten Nutzer brauchen diese Seite nie. Der visuelle Filtereditor von TrekMail deckt fast alle Anforderungen einfacher ab. Entwicklern, IT-Administratoren vieler Postfächer und erfahrenen Nutzern, denen der visuelle Editor nicht genügt, bietet der Sieve-Roheditor jedoch vollständige Kontrolle über eingehende E-Mails.

Zum Aktivieren eines Rohskripts ist ein aktiver Agency-Tarif erforderlich. Andere Tarife können einen Entwurf speichern, aber nicht ausführen.

Was ist Sieve?

Sieve ist eine kleine Skriptsprache für E-Mail-Filter. Ihre Anweisungen laufen bei jeder neuen Nachricht. Regeln prüfen Absender, Betreff, Größe oder Kopfzeilen und können Nachrichten verschieben, weiterleiten, markieren, ablehnen oder automatisch beantworten.

Anders als lokale Regeln in Outlook oder Apple Mail läuft Sieve rund um die Uhr auf dem Server, unabhängig von Computer und Mailprogramm. Jedes mit dem Postfach verbundene Gerät sieht dasselbe Ergebnis.

Für TrekMail müssen Sie Sieve nicht lernen. Der visuelle Editor erzeugt Sieve im Hintergrund. Im Roheditor schreiben Sie es nur dann selbst, wenn die visuelle Oberfläche eine Anforderung nicht abbilden kann.

Wann Roheditor oder visuelle Filter sinnvoll sind

Nutzen Sie den visuellen Editor, wenn:

• Einfache Bedingungen wie „Von enthält X“ oder „Betreff enthält Y“ genügen.
• Sie Nachrichten verschieben, weiterleiten, markieren, ablehnen oder verwerfen möchten.
• Sie keinen Code schreiben möchten.
• Sie Regeln schnell und ohne Syntaxfragen ändern wollen.

Nutzen Sie den Sieve-Roheditor, wenn:

• Sie komplexe Logik wie „dies UND das, aber NICHT jenes“ benötigen.
• Reguläre Ausdrücke ein bestimmtes Muster erkennen sollen.
• Abwesenheitsantwort, Filterung und Weiterleitung in ein Skript gehören.
• Bedingungen oder Aktionen des visuellen Editors nicht ausreichen.
• Sie Vorlagen für viele Postfächer verwalten.

Wo befindet sich der Editor?

1. Öffnen Sie im TrekMail-Dashboard Postfächer.
2. Wählen Sie beim gewünschten Postfach Verwalten.
3. Öffnen Sie die Registerkarte Sieve.
4. Der Code-Editor zeigt bei einem berechtigten Agency-Konto zunächst das aus verwalteten Filtern erzeugte Skript, sofern vorhanden. Bearbeiten Sie es oder beginnen Sie neu.
5. Klicken Sie auf Speichern und aktivieren, um das Skript hochzuladen und anzuwenden.

Der Editor öffnet das aktuelle Skript oder eine leere Fläche. Schreiben oder fügen Sie Ihr Skript ein und aktivieren Sie es anschließend.

Unterstützte Erweiterungen

Sieve ist modular. Erweiterungen ergänzen die einfache Basissprache. TrekMail unterstützt:

Deklarieren Sie jede Erweiterung am Skriptanfang mit require. Der Server prüft das Skript vor der Aktivierung und lehnt nicht unterstützte oder sicherheitskritische Erweiterungen ab.

Beispielskripte

Vier vollständige, kommentierte Vorlagen:

Beispiel 1: Komplexe bedingte Weiterleitung

E-Mails eines Kunden mit „proposal“ im Betreff und weniger als 5 MB werden weitergeleitet, in einen Projektordner gelegt und markiert.

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;
}

Wirkung: Die erste Regel erfasst nur Vorschlagsmails dieses Kunden unter 5 MB und leitet, markiert und sortiert sie. Die zweite legt alle übrigen Mails des Kunden im allgemeinen Ordner ab.

Beispiel 2: Regex für Bestellnummern

Nachrichten mit Nummern wie ORD-12345 oder ORD-98765 werden automatisch einsortiert.

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;
}

Wirkung: Reguläre Ausdrücke erkennen Muster statt exakter Texte. [0-9]{4,6} bedeutet „4 bis 6 Ziffern“ und erfasst ORD-1234, ORD-12345 und ORD-123456 ohne Aufzählung jeder Nummer.

Beispiel 3: Abwesenheit, Sortierung und Weiterleitung

Ein Skript beantwortet Abwesenheiten, leitet Dringendes an eine Kollegin weiter und sortiert den Rest.

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;
}

Wirkung: vacation antwortet höchstens einmal alle 3 Tage je Absender. Danach sortieren die anderen Regeln. Da vacation kein stop verwendet, wird das Skript fortgesetzt. So lassen sich automatische Antworten und weitere Filter verbinden.

Beispiel 4: Markierung nach eigener Kopfzeile

Manche Systeme kennzeichnen die Bedeutung mit X-Priority. Dieses Skript markiert hohe Prioritäten.

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;
}

Wirkung: Bei X-Priority steht 1 für höchste, 5 für niedrigste Priorität. :value "le" bedeutet „kleiner oder gleich“ und markiert 1 und 2. Die Stufen 4 und 5 werden aus dem Posteingang verschoben.

Wichtige Hinweise

Rohskripte ersetzen visuelle Filter. Ein gespeichertes Rohskript ersetzt die visuellen Filter dieses Postfachs. Beide Modi lassen sich nicht mischen. Die visuellen Filter bleiben gespeichert, aber inaktiv. Mit Auf Standard zurücksetzen oben auf der Sieve-Seite wechseln Sie zurück.

Der Server prüft vor der Aktivierung. Bei Speichern und aktivieren wird die Syntax validiert. Bei einem Fehler bleibt das bisherige Skript oder der visuelle Filter aktiv, bis Sie den Fehler beheben.

require ist Pflicht. Jede verwendete Erweiterung muss oben in require stehen. Werden fileinto oder vacation nicht deklariert, lehnt der Server das Skript ab. Im Zweifel führen Sie alles Benötigte auf.

Spam wird vorher gefiltert. Der serverseitige Spamfilter von TrekMail läuft vor Sieve. Das Skript sieht nur geprüfte Nachrichten, daher sind keine Sieve-Spamregeln nötig.

Zurück zu visuellen Filtern

1. Öffnen Sie die Registerkarte Sieve des Postfachs.
2. Klicken Sie rechts oben auf Auf Standard zurücksetzen.
3. Bestätigen Sie die Aktion.

Das eigene Skript wird verworfen und das aus den visuellen Filtern erzeugte Skript wiederhergestellt. Die Filter auf der Registerkarte Filter bleiben währenddessen erhalten und werden lediglich reaktiviert.

Auch das Speichern einer Änderung unter Filter stellt das verwaltete Skript wieder her. Automatische Antwort überschreibt kein Rohskript. Wechseln Sie zuerst in den verwalteten Modus und richten Sie dann die Antwort ein.

Häufige Fehler und Lösungen

require vergessen. Jede Erweiterung muss deklariert sein. Bei „unknown command fileinto“ fügen Sie oben require ["fileinto"]; hinzu.

Fehlende Semikolons. Jeder Sieve-Befehl endet mit einem Semikolon. Prüfen Sie bei unerwarteten Token besonders stop, discard und fileinto.

Zeichenfolgen brauchen Anführungszeichen. Ordner, Adressen und Vergleichswerte gehören in doppelte Anführungszeichen. fileinto Newsletters; schlägt fehl, fileinto "Newsletters"; ist korrekt.

Backslash in Kennzeichnungen. IMAP-Kennzeichnungen wie \Flagged und \Seen benötigen in Sieve einen doppelten Backslash: "\\Flagged" und "\\Seen". Ein einzelner ist ein Escapezeichen und verursacht Fehler.

Ordner fehlt. Legen Sie ihn im Mailprogramm an, bevor Sie Nachrichten dorthin leiten. Ein Rohskript erstellt ihn nur, wenn Skript und Server dies unterstützen.

Skript zu groß. Ab einigen hundert Zeilen sollten Sie prüfen, ob Regeln besser im visuellen Editor aufgehoben sind. Nicht alles muss in einem Skript stehen.