IMAP-E-Mail als Trigger: das Universal-Interface für Alt-Software

Viele Unternehmen betreiben irgendwo im Hintergrund noch Software, die kein Webhook kennt, keine REST-API anbietet und auch nie eine bekommen wird. Die Warenwirtschaft aus den frühen 2010ern, das Faxgateway, das E-Mails aus einem Formular verschickt, oder der Lieferant, der Bestellbestätigungen ausschließlich als E-Mail-Anhang verschickt. Genau für diese Fälle ist IMAP die stille Brücke, die fast jedes System irgendwie beherrscht, weil E-Mail seit Jahrzehnten der kleinste gemeinsame Nenner der IT ist.

n8n bringt dafür einen eigenen Trigger-Knoten mit, den Email Trigger (IMAP). Er verbindet sich mit einem IMAP-Postfach, prüft es auf neue Nachrichten und startet bei jeder neuen E-Mail automatisch einen Workflow. Damit wird ein Postfach zur universellen Schnittstelle: Alles, was irgendwie eine E-Mail verschicken kann, egal wie alt oder proprietär das System dahinter ist, kann darüber Daten an n8n übergeben. Dieser Artikel zeigt, wie der Trigger funktioniert, welche Einstellungen wirklich wichtig sind und worauf Sie bei Betrieb und Fehlersuche achten sollten.

Warum IMAP oft die einzige realistische Anbindung ist

Moderne Automatisierung denkt meist in Webhooks und REST-Endpunkten. Doch ein großer Teil der in Betrieben tatsächlich laufenden Software wurde gebaut, bevor solche Schnittstellen zum Standard wurden. Kassensysteme, Maschinensteuerungen, Behördenportale, alte ERP-Installationen: Viele davon können zwar E-Mails verschicken, aber keine API bedienen. Für diese Alt-Software bleibt IMAP oft der einzige praktikable Weg, Ereignisse automatisiert weiterzuverarbeiten.

Der Charme dieser Lösung liegt in ihrer Einfachheit. Sie brauchen keinen Entwicklerzugang, keine Firewall-Freigabe für eingehende Webhooks und keine Abstimmung mit einem Softwarehersteller, der das Produkt vielleicht längst nicht mehr pflegt. Ein Postfach einzurichten und dessen Adresse als Empfänger in der Alt-Software einzutragen, reicht in den meisten Fällen aus. n8n übernimmt den Rest: Es beobachtet das Postfach und reagiert auf jede neue Nachricht, so wie es auch auf einen Webhook reagieren würde.

Wie der Email Trigger (IMAP) grundsätzlich funktioniert

Der Knoten Email Trigger (IMAP) ist laut offizieller Dokumentation ein Trigger-Node, der E-Mails über einen IMAP-Server empfängt und dafür sorgt, dass jede neu eintreffende Nachricht einen Workflow-Lauf auslöst. Zur Grundkonfiguration gehören folgende Punkte:

• Credential: eine hinterlegte IMAP-Zugangsdatenverbindung, über die sich n8n am Postfach anmeldet.
• Mailbox Name: der Ordner, aus dem Nachrichten abgeholt werden sollen, in der Regel der Posteingang.
• Action: legt fest, was mit einer verarbeiteten E-Mail passiert. "None" lässt sie ungelesen, "Mark as Read" markiert sie nach dem Abholen als gelesen.
• Download Attachments: steuert, ob Anhänge mit heruntergeladen werden. Da dies die Verarbeitung spürbar verlangsamen kann, sollten Sie diese Option nur aktivieren, wenn der Workflow die Anhänge tatsächlich braucht.

Beim Ausgabeformat unterscheidet die Dokumentation drei Varianten. Simple liefert die vollständige E-Mail, ist aber für eingebettete Anhänge nicht empfohlen. Resolved liefert die E-Mail mit allen aufgelösten Daten und legt Anhänge als Binärdaten ab, das ist die praktikabelste Wahl für die meisten Automatisierungen. RAW gibt die komplette Roh-Nachricht inklusive Body als base64url-codierten String im Feld raw zurück, nützlich, wenn ein nachgelagertes System die Original-E-Mail unverändert weiterverarbeiten soll.

Erweiterte Optionen: Filterregeln und stabile Verbindungen

Neben den Grundeinstellungen bietet der Knoten zusätzliche Optionen, die im rauen Alltagsbetrieb den Unterschied machen. Mit Custom Email Rules lassen sich eigene Suchkriterien definieren, die auf der Suchfunktion der zugrunde liegenden node-imap-Bibliothek basieren. Damit können Sie zum Beispiel nur E-Mails von einem bestimmten Absender oder mit einem bestimmten Betreff triggern lassen, statt jede eingehende Nachricht im Postfach zu verarbeiten.

Die Option Force Reconnect Every Minutes sorgt dafür, dass die Verbindung zum IMAP-Server in einem festen Intervall neu aufgebaut wird. Gerade bei Postfächern, die über längere Zeit inaktiv bleiben oder deren Server-seitige IMAP-Sitzungen von sich aus getrennt werden, verhindert das, dass der Trigger unbemerkt "einschläft" und neue E-Mails nicht mehr registriert. Wenn Sie in der Praxis feststellen, dass Nachrichten sporadisch nicht erkannt werden, ist ein regelmäßiger Reconnect meist die erste sinnvolle Stellschraube.

Die IMAP-Zugangsdaten richtig einrichten

Bevor der Trigger überhaupt läuft, braucht er eine funktionierende Credential-Verbindung. Laut IMAP-Credential-Dokumentation sind dafür folgende Angaben nötig:

• User: die E-Mail-Adresse des Postfachs, das abgefragt werden soll.
• Password: entweder das reguläre Passwort oder ein App-Passwort, je nachdem, was der jeweilige Anbieter verlangt.
• Host: die IMAP-Serveradresse, üblicherweise in der Form imap.anbieter.de.
• Port: standardmäßig 993, sofern der Anbieter nichts anderes vorgibt.
• SSL/TLS: sollte für eine verschlüsselte Verbindung aktiviert bleiben.
• Allow Self-Signed Certificates: nur relevant, wenn Sie einen eigenen Mailserver mit selbstsigniertem Zertifikat betreiben.

Die Dokumentation weist ausdrücklich darauf hin, dass der jeweilige Anbieter vorgibt, ob das normale Kontopasswort oder ein separates App-Passwort verwendet werden muss. Für Gmail, Yahoo Mail und Outlook.com stellt n8n eigene Schnellstart-Anleitungen bereit, die genau diese Unterscheidung erklären. Wichtig für Alt-Software-Szenarien: Richten Sie dafür idealerweise ein eigenes, ausschließlich für die Automatisierung genutztes Postfach ein, statt ein persönliches Konto einzubinden. So behalten Sie die Kontrolle darüber, welche Nachrichten überhaupt den Workflow auslösen, und können das Postfach unabhängig von einzelnen Mitarbeitenden verwalten.

Typischer Aufbau eines IMAP-basierten Workflows

In der Praxis sieht ein solcher Workflow meist so aus:

• Die Alt-Software verschickt eine automatisierte E-Mail, etwa eine Bestellbestätigung, einen Fehlerbericht oder einen exportierten Datensatz als Anhang.
• Der Email Trigger (IMAP) erkennt die neue Nachricht im überwachten Postfach und startet den Workflow.
• Ein nachgelagerter Node, häufig ein Code-Node oder ein spezialisierter Parser, liest Betreff, Absender, Text oder Anhang aus und wandelt die Daten in ein strukturiertes Format um.
• Die aufbereiteten Daten fließen anschließend in ein modernes System weiter, etwa ins CRM, in eine Tabelle oder in ein Ticketsystem.

Diese Kette funktioniert unabhängig davon, wie alt oder geschlossen die ursprüngliche Software ist, solange sie überhaupt E-Mails verschicken kann. Genau das macht IMAP zu einem Grundlagenbaustein, den Sie in vielen Automatisierungsprojekten immer wieder finden, auch wenn moderne API-Anbindungen im Regelfall vorzuziehen sind, wann immer sie verfügbar sind.

Grenzen und Stolperfallen im Betrieb

So zuverlässig IMAP als Brücke ist, es bleibt eine Abfrage per Polling und kein echtes Push-Ereignis. n8n prüft das Postfach in Intervallen, nicht in Echtzeit, weshalb zwischen Eintreffen einer E-Mail und Start des Workflows immer eine kleine Verzögerung liegt. Für die meisten Alt-Software-Szenarien ist das unkritisch, für zeitkritische Prozesse sollten Sie das jedoch von vornherein einplanen.

Ein weiterer Punkt ist die Postfach-Hygiene. Bleiben E-Mails dauerhaft im überwachten Ordner liegen, wächst das Postfach unkontrolliert, und je nach Anbieter kann das die Abfrage verlangsamen. Es empfiehlt sich, verarbeitete Nachrichten über einen nachgelagerten Schritt in einen Archivordner zu verschieben oder gezielt mit Custom Email Rules nur die tatsächlich relevanten Nachrichten abzuholen. Und schließlich: Anhänge, Betreffzeilen und Absenderadressen aus Alt-Software sind selten so sauber formatiert wie eine moderne API-Antwort. Plane für die Verarbeitung genügend Fehlerbehandlung ein, damit ein unerwartetes Format nicht den gesamten Workflow blockiert.

Häufige Fragen

Kann ich mit dem Email Trigger (IMAP) auch Anhänge automatisch verarbeiten?

Ja, dafür aktivieren Sie die Option Download Attachments und wählen als Format am besten Resolved, damit Anhänge als Binärdaten im Workflow zur Verfügung stehen. Da das Herunterladen von Anhängen die Verarbeitung verlangsamen kann, sollten Sie diese Option nur bei Bedarf einschalten, insbesondere wenn viele oder große Dateien zu erwarten sind.

Reagiert der Trigger sofort auf neue E-Mails?

Der Trigger fragt das Postfach in wiederkehrenden Intervallen ab, statt eine echte Push-Benachrichtigung des Mailservers zu nutzen. In der Praxis ist die Verzögerung meist gering, für wirklich zeitkritische Anwendungsfälle sollten Sie das aber berücksichtigen und gegebenenfalls testen, wie schnell Ihr konkretes Setup tatsächlich reagiert.

Was mache ich, wenn der Trigger nach einiger Zeit keine neuen E-Mails mehr erkennt?

In diesem Fall lohnt sich zuerst ein Blick auf die Option Force Reconnect Every Minutes. Eine dauerhaft offene IMAP-Verbindung kann serverseitig getrennt werden, ohne dass n8n das sofort bemerkt, ein regelmäßiger erzwungener Verbindungsaufbau behebt dieses Problem in vielen Fällen zuverlässig.

Brauche ich für jede Alt-Software ein eigenes Postfach?

Zwingend notwendig ist das nicht, in der Praxis hat sich ein eigenes, klar abgegrenztes Postfach pro Anwendungsfall aber bewährt. Mit Custom Email Rules können Sie zwar auch innerhalb eines gemeinsamen Postfachs nach Absender oder Betreff filtern, ein getrenntes Postfach macht die spätere Fehlersuche und die Rechteverwaltung aber deutlich einfacher.

Ist ein App-Passwort für die IMAP-Zugangsdaten immer nötig?

Das hängt vom jeweiligen E-Mail-Anbieter ab. Für Gmail, Yahoo Mail und Outlook.com verlangen die Anbieter in der Regel ein separates App-Passwort statt des normalen Kontopassworts, während ein selbst gehosteter Mailserver häufig mit dem regulären Passwort auskommt. Im Zweifel gibt der jeweilige Anbieter selbst vor, welche Variante zu verwenden ist.