Dein mailcow behält die Mail; diese Erweiterung gibt deinen eigenen Programmen einen kontrollierten Zugang. Erstelle im mailcow-Admin einen API-Schlüssel, wähle die Postfächer und die Rechte, und rufe die API aus einem Skript, einem CRM oder einer Automatisierung auf. Getrennt davon wählst du Postfächer zum Beobachten: jede neue Nachricht kann als JSON an deinen Webhook und an einen Telegram-Chat gehen.
Was es tut
- API-Schlüssel unter System → Mailbox API: Rechte lesen, senden, organisieren, beschränkt auf gewählte Postfächer; gespeichert wird nur der SHA-256, der Schlüssel wird einmal angezeigt.
- Lesen: Ordner und Nachrichten auflisten, suchen, eine vollständige Nachricht lesen (Text, HTML, Kopfzeilen, Anhänge), mit Seitenweise. Anhänge kommen als signierte Links, 1 Stunde gültig und an den API-Schlüssel gebunden, der das Postfach lesen darf.
- Senden: als das Postfach senden (An, Cc, Bcc, Betreff, Text oder HTML, Antwort an); eine Kopie geht nach Gesendet.
- Organisieren: gelesen/ungelesen, in einen anderen Ordner verschieben, löschen.
- Webhooks: pro beobachtetem Postfach eine https-Adresse und ein Geheimnis. Jede neue Nachricht geht als JSON mit Signatur
X-MLW-Signature(HMAC-SHA256, wie bei Stripe) hinaus; Fehlversuche werden mit wachsender Pause wiederholt und im Admin aufgelistet. - Telegram: ein Bot-Token und ein Chat pro beobachtetem Postfach, mit Testknopf.
- Alles bleibt auf deinem Server: gelesen wird über den Dovecot-Master-Login im mailcow-Netz (derselbe Mechanismus wie bei imapsync). Nichts geht an medialab.works; nur deine eigenen Webhooks und Telegram-Chats erhalten Daten.
Voraussetzungen
- mailcow-dockerized mit mailcow Toolkit 0.5.0 oder neuer von MediaLab Works (eigenes Produkt im Paket, eigene Lizenz).
- Root auf dem Host für die Installation; der Server muss
medialab.worksüber HTTPS erreichen (Lizenzprüfung). - Für Webhooks: ein eigener https-Endpunkt; für Telegram: ein Bot-Token von @BotFather und die Chat-ID je Postfach.
- Open Source (GPL-3.0): vollständiger Quellcode.
Grenzen und Datenschutz
- Jeder Schlüssel erreicht nur die gewählten Postfächer und Rechte; jeder Aufruf wird protokolliert.
- Die API ist aus, bis du sie einschaltest; ohne gültige Lizenz stoppen API und Benachrichtigungen, nichts wird gelöscht.
- Nachrichteninhalte gehen nie an uns: sie gehen an deinen Webhook und deinen Telegram-Chat. Signierte Anhangslinks laufen nach 1 Stunde ab.
- Die API legt keine Postfächer an, löscht und ändert sie nicht.
Lizenzierung
Eine Lizenz pro mailcow-Server, Monats- oder Jahresabo oder Lifetime, mit 30 Tagen kostenloser Testphase. Ohne gültige Lizenz stoppt das Modul; Postfächer und Nachrichten bleiben unberührt. Siehe Preise und die Installations- und API-Anleitung.