Guide

E-Mail-Synchronisierung ohne IMAP hinzufügen

E-Mail-Synchronisierung bedeutet oft eine dauerhafte IMAP-IDLE-Verbindung pro Postfach, OAuth-Refresh und Reconnect-Handling im großen Maßstab. Dieser Guide zeigt das Ersatzmuster: Webhooks für neue E-Mails, On-Demand-Lesezugriffe fürs Backfill und ein Terminal-Prototyp des gesamten Ablaufs.

Written by Caleb Geene Director, Site Reliability Engineering

Reviewed by Qasim Muhammad

Verified — CLI 3.1.17 · Gmail, Outlook, IMAP · last tested June 9, 2026

Warum ist IMAP-Sync-Infrastruktur schwer zu bauen?

IMAP-Synchronisierung ist schwer, weil Echtzeit-Zustellung eine dauerhaft offene IDLE-Verbindung für jedes einzelne Postfach braucht. Laut RFC 2177 muss ein Client IDLE mindestens alle 29 Minuten neu ausgeben, sonst kann der Server die Verbindung trennen. 10.000 Nutzer bedeuten also 10.000 langlebige Sockets, die Sie am Leben halten, erneut verbinden und über Prozesse verteilen müssen.

Auf diesen Sockets liegen OAuth-Token-Refresh pro Konto, XOAUTH2- Authentifizierung, Provider-Eigenheiten und Reconnect-Stürme, wenn ein Node neu startet und Tausende Postfächer gleichzeitig neu verhandeln. Das sind Wochen Infrastruktur, bevor Sie eine einzige Nachricht parsen — und es ist der Teil, der Sie um 3 Uhr morgens weckt, nicht das Feature, das Sie bauen wollten.

Was ersetzt IMAP-Synchronisierung?

Ersetzt wird sie durch ein Push-plus-Pull-Modell: Ein Webhook liefert eine kleine Benachrichtigung, wenn neue E-Mail eintrifft, und Ihre App liest die Nachricht nur dann on demand, wenn sie den Inhalt braucht. Sie halten null persistente Verbindungen. Der Provider sagt Ihnen, wann sich etwas geändert hat; Sie holen nur genau das ab. So funktionieren Gmail- und Microsoft- Graph-Push-Modelle im Kern.

Das kehrt die Kosten um. Statt Tausende Leerlauf-Sockets warm zu halten, zahlen Sie einen günstigen Webhook pro neuer Nachricht plus die Lesezugriffe, die Sie wirklich nutzen. Ein Postfach mit 50 Nachrichten pro Tag kostet 50 Benachrichtigungen, nicht 24 Stunden gehaltene Verbindung.

Wie prototypisiere ich E-Mail-Synchronisierung ohne IMAP?

Sie prototypisieren das gesamte Muster in zwei Terminalbefehlen. Registrieren Sie einen message.created Webhook, damit Ihr Endpoint bei jeder neuen Nachricht benachrichtigt wird, und starten Sie dann den eingebauten Receiver, um eingehende Payloads zu beobachten. Kein Server-Framework, kein Socket-Pool — Sie sehen exakt die Push-Form, die Ihre App verarbeiten wird.

# 1. Push new mail to your endpoint
nylas webhook create \
  --url https://your-app.example.com/inbound \
  --triggers message.created \
  --description "email sync"

# 2. Watch payloads locally while you build the handler
nylas webhook server --port 9000

Wenn eine Benachrichtigung eintrifft, laden Sie den Nachrichtentext bei Bedarf. Der Befehl nylas email read nimmt die Message-ID aus dem Webhook und gibt den vollständigen Inhalt als JSON zurück — genau den einen Abruf, den Sie nur bei Bedarf ausführen.

# In your handler: fetch just the message the webhook pointed at
nylas email read "$MESSAGE_ID" --json | jq '{from: .from, subject: .subject}'

Wie fülle ich vorhandene E-Mails nach?

Verlauf füllen Sie mit On-Demand-Suche nach, nicht mit einer vollständigen Synchronisierung. Der Befehl nylas email search fragt das Postfach direkt ab, und der Datumsfilter --after begrenzt den Import auf ein aktuelles Fenster, damit Sie nicht Jahre von E-Mails ziehen, die Sie nicht brauchen. Die meisten Apps benötigen beim Onboarding nur die letzten 30–90 Tage.

# One-time backfill of the last 30 days at user onboarding
nylas email search "*" --after 2026-05-10 --json > backfill.json
jq 'length' backfill.json

Wann brauche ich weiterhin IMAP?

Sie brauchen IMAP weiterhin, wenn ein Postfach keine moderne API hat — etwa ein selbst gehosteter Dovecot-Server, ein Legacy-Host oder ein Nischenanbieter, der nur IMAP bereitstellt. In diesen Fällen gibt es keinen Webhook zum Abonnieren, daher ist ein Polling- oder IDLE-Client unvermeidbar. Der ehrliche Trade-off: Das Push-Modell braucht einen Provider, der Benachrichtigungen unterstützt.

Selbst dann verbindet sich das CLI über dieselbe Befehlsoberfläche mit generischen IMAP-Konten, sodass Sie das einheitliche Lesemodell erhalten, ohne selbst einen IMAP-Client zu schreiben. Die meisten Teams stellen fest, dass der No-IMAP-Pfad Gmail, Outlook und die großen Provider abdeckt — also den Großteil echter Nutzer — und reservieren einen Polling-Fallback für den Long Tail.

Nächste Schritte