Dispatch: Postfach-Anbindung
Kurzanleitung für den normalen Fall: Von der Mail bis zur Veröffentlichung. Gesamtmodell (Splitter, Lanes, Gates): Dispatch-Graph Betriebsmodell.
Was ist neu?
Pro Center oder pro Organisation können Sie im Cockpit festlegen, welche E-Mail-Adresse eingehende Anfragen für Dispatch empfängt. Neu: Google Workspace per Domain-Wide Delegation (ohne OAuth-Consent) und Microsoft 365 per delegiertem OAuth direkt im Cockpit.
Bei Gmail und Microsoft speichert der Sync die Konversations-ID mit. Vor der KI-Analyse werden die letzten Nachrichten derselben Unterhaltung mit einbezogen — im Dispatch-Fall sehen Sie darunter einen kompakten Verlauf (Datum, Absender, Kurztext).
Warum?
Bisher kamen E-Mails oft über Weiterleitung oder AgencyOS. Mit direkter Anbindung liest cockpitOS ungelesene INBOX-Mails per Cron — mit Dedup und automatischer KI-Triage.
Wer ist betroffen?
- Redaktion / Center-Betrieb: Einrichtung unter Redaktionsfluss → Dispatch → „Postfach-Anbindung“
- IT / Betrieb: Env-Variablen auf Render (
GOOGLE_GMAIL_SERVICE_ACCOUNT_JSON,AZURE_AD_*,CRON_SECRET) - Google-Admin: Domain-Wide Delegation für Service-Account (bereits eingerichtet für sawatzkimuehlenbruch.de)
Wo im Dashboard?
- Redaktionsfluss → Dispatch (
/dashboard/dispatch) - Karte Postfach-Anbindung
- Einrichtungsebene: Center oder Organisation
- Anbieter wählen, Adresse eintragen, Verbinden (Google) bzw. Mit Microsoft verbinden
Verbunden-Status erkennen
Sobald ein Postfach verbunden ist, klappt die Karte auf eine kompakte Zeile ein — statt des vollen Setup-Formulars:
- Organisation MEC · Verbunden als dispatch@mec.de · Google Workspace · Letzter Sync: …
- Badge Verbunden und Button Einstellungen bearbeiten (öffnet das vollständige Formular)
- Button Mails importieren mit Dropdown (Google Workspace / Microsoft 365)
Das gilt für Organisations- und Center-Postfächer gleichermaßen. Provider-Felder, Webhook-URL und Eingangsfilter-Accordion sind dann ausgeblendet.
Manueller Mail-Import
Bei verbundenem Google Workspace- oder Microsoft-365-Postfach steht Mails importieren zur Verfügung:
| Option | Bedeutung |
|---|---|
| Neue seit letztem Sync | Mails im Posteingang seit dem letzten erfolgreichen Abruf (Fallback: 7 Tage) |
| Ungelesene | Nur ungelesene INBOX-Mails |
| Letzte 24 Stunden | Alle INBOX-Mails der letzten 24 Stunden |
| Letzte 7 Tage | Alle INBOX-Mails der letzten 7 Tage |
Nach dem Import erscheint eine Kurzmeldung (importiert / bereits vorhanden / verworfen). Der automatische Cron bleibt unverändert aktiv — Duplikate werden über external_message_id verhindert.
Anhänge: E-Mails ohne Fließtext, aber mit mindestens einem Anhang (oder klarem Betreff), landen trotzdem in Dispatch — die KI sieht einen kurzen Platzhaltertext und die Dateimetadaten. In der Detailansicht steht, dass Bilder auf dem Server liegen und für Social nutzbar sind; bei PDF muss der Inhalt manuell aus der Datei übernommen werden. Wenn die Mail einen Anhang erwähnt, aber keine Datei ankommt (typisch bei sehr großen Microsoft-Anhängen), erscheint ein Hinweis zum Nachsehen im Original-Postfach.
Manuell nachreichen: Im Dispatch-Fall (Nachrichten-Karte) können berechtigte Nutzer fehlende Dateien mit Anhang hochladen nachziehen — Bilder (JPG, PNG, WebP, GIF) oder PDF, je max. 15 MB, bis zu 10 Anhänge pro Fall. Enthält die Mail nur einen Transfer-Link (z. B. WeTransfer, Dropbox, Google Drive), zeigt cockpitOS einen Warnhinweis mit Link — die Datei muss dort geöffnet, heruntergeladen und im Fall hochgeladen werden (cockpitOS lädt externe Transfer-URLs nicht automatisch).
Organisations-Postfach vs. Center-Postfach
Es gibt keine automatische Vererbung in der Datenbank — Organisations- und Center-Postfächer sind getrennte Konfigurationen:
| Ebene | Verhalten |
|---|---|
| Organisation | E-Mails landen in Dispatch ohne festes Center — Zuordnung per KI-Triage oder manuell |
| Center | E-Mails werden beim Eingang diesem Center zugeordnet |
| Gleiche Empfänger-Adresse | Center-Postfach hat Vorrang vor Organisations-Postfach |
Wenn die Organisation bereits ein verbundenes Postfach hat, aber das gewählte Center kein eigenes, zeigt Dispatch oben eine kompakte Vererbungs-Zeile:
- Postfach über Organisation MEC · Verbunden als …
- Buttons: Organisations-Einstellungen oder Center-Postfach einrichten
So wird kein zweites Setup-Formular angezeigt, solange das Organisations-Postfach ausreicht.
Vollständiges Setup (nicht verbunden oder bearbeiten)
| Anbieter | Anzeige |
|---|---|
| Weiterleitung / Webhook | Empfangsadresse + Webhook-URL (nur bei diesem Anbieter sichtbar) |
| Google Workspace | Bereich „Google Workspace“ mit Verbinden-Button |
| Microsoft 365 | Bereich „Microsoft 365“ mit OAuth |
Webhook-Felder und Sicherheitshinweise erscheinen nur, wenn als Anbieter „Weiterleitung / Webhook“ gewählt ist — bei Google oder Microsoft bleiben sie ausgeblendet (gespeicherte Webhook-Konfiguration in der DB bleibt erhalten).
Eingangsfilter ist standardmäßig eingeklappt: erklärt den automatischen Ausschluss von System-/Marketing-Mails.
Organisation oben (bei Mehr-Org-Zugang) steuert Postfach-Anbindung, Center-Liste und Queue. Center-Filter auf der Seite und Center-Auswahl in der Karte sind verknüpft und folgen dem Center-Switcher im Header, wenn dort ein Center gewählt ist.
Google Workspace (Domain-Wide Delegation)
Voraussetzungen (IT)
| Schritt | Details |
|---|---|
| Service-Account | z. B. smg-mec-mails@console-wayfinder.iam.gserviceaccount.com |
| DWD in Google Admin | Scope https://www.googleapis.com/auth/gmail.readonly für Domain sawatzkimuehlenbruch.de |
| Render Env | GOOGLE_GMAIL_SERVICE_ACCOUNT_JSON = vollständiges JSON als eine Zeile (Secret, nie ins Repo) |
| Domain-Filter | Optional DISPATCH_GMAIL_ALLOWED_DOMAINS=sawatzkimuehlenbruch.de (Komma-getrennt) |
Sicherheit: Wurde der Private Key jemals öffentlich geteilt, muss er in Google Cloud rotiert und die neue JSON in Render hinterlegt werden.
Redaktion: Postfach verbinden
- Anbieter Google Workspace wählen
- Postfach-Adresse eintragen, z. B.
dispatch@sawatzkimuehlenbruch.de - Verbinden — Testabruf auf INBOX
- Status Verbunden
Cron (/api/cron/dispatch-gmail-sync, alle 10 Min.) importiert ungelesene Mails als Dispatch-Einträge.
Hinweis: System- und Marketing-Mails (z. B. LinkedIn-Benachrichtigungen, Newsletter, noreply@-Absender großer Plattformen) werden beim Import automatisch als Verworfen gespeichert — sichtbar im Tab Verworfen inkl. Grund. Mit Doch bearbeiten können sie wieder in die Prüfung.
Dispatch-Inbox (UX)
| Tab | Bedeutung |
|---|---|
| Prüfung | Neu (noch nicht analysiert) + Klärung nötig (KI unsicher oder Entwurf offen) |
| Alle | Gesamtliste nach Filtern |
| Übernommen | Social-Entwurf liegt in der Freigabe, oder der Website-Entwurf liegt im Workflow und Social hängt nicht |
| Verworfen | Nicht relevant (manuell oder Auto-Filter) |
Sidebar-Badge bei Dispatch = nur Einträge in Prüfung, nicht die Gesamtzahl.
Filter: Organisation, Center, Postfach, Zeitraum, Suche.
Detailansicht (Phase 2):
- Summary — Was passiert? / Was macht cockpitOS? / Deine Entscheidung
- Bei Klärung nötig: Korrektur-Panel mit erkannten Center/Shop/Aktionen und Checkboxen (Shop entfernen, Angebot, News, Social, Sonstiges) → Bestätigen & weiter legt
suggestedActionsan und übergibt an die Steuerzentrale - Sticky-Aktionen unten: Ablehnen, Bearbeiten, Freigeben/Ausführen
- Analyse & Einstellungen anzeigen — KI-Triage, Zuordnung, Entwurf (eingeklappt)
Verworfene Mails: Doch bearbeiten stellt den Eingang wieder her (PATCH restoreFromDiscarded: true).
Fall an einem Ort (Dispatch bis Freigabe)
Was
Ein Dispatch-Fall bleibt in der Prüfung, bis der Social-Entwurf wirklich in der Freigabe liegt (oder nur ein Website-Entwurf im Workflow liegt und Social nicht hängen bleibt). Fehlt der Freigabe-Pool, ein Bild oder eine eindeutige Center-Zuordnung, steht der Grund und die nächste Aktion im offenen Fall.
Warum
Vorher galt ein angelegter Entwurf als übernommen, auch wenn er nie in die Freigabe kam. Redaktion und Center-Leitung sind zwischen Dispatch, Steuerzentrale, Social-Freigaben und Workflow gesprungen.
Wer ist betroffen
Redaktion, Content Editor, Center Manager, Marketing-Leitung. Die Steuerzentrale sehen nur Super Admin, Plattform-Admin und Org Marketing Manager.
Wo
Menü: Redaktionsfluss → Dispatch → Fall öffnen. Block Nächster Schritt.
Freigabe-Pool: Center → Team & Ansprechpartner (ein Sprung, Link zurück zum Fall). Social-Kanal: Center → Social Media, ebenfalls mit Rückweg.
Auto-Entwurf: Organisation oder Center, Tab Social-Freigabe-Pool, Schalter Auto-Entwurf nach KI — auch ohne Social-Agent-Pilot.
So testen
- Center ohne Freigabe-Pool, Auto-Entwurf an: Mail analysieren. Fall bleibt unter Prüfung, Satz „Freigabe-Pool fehlt“, Button öffnet das Center-Team und führt zurück.
- Mail mit Bild-Anhang: Auto-Entwurf übernimmt das Bild. Ohne brauchbares Bild: „Bild fehlt — hier hochladen“.
- Mehrdeutiges Center: Fall bleibt in der Prüfung, Center zuordnen im selben Fall.
- Pool vorhanden, Auto-Publish aus: Entwurf liegt in der Freigabe. Berechtigte geben ihn im Dispatch-Detail frei, ohne Social-Freigaben zu öffnen.
- Als Content Editor erscheint kein Link in die Steuerzentrale.
Microsoft 365 (delegiertes OAuth)
Voraussetzungen (IT)
| Variable | Zweck |
|---|---|
AZURE_AD_TENANT_ID | SMG-Tenant (gleiche App wie AgencyOS möglich) |
AZURE_AD_CLIENT_ID / AZURE_AD_CLIENT_SECRET | App-Registrierung |
| Redirect-URI | https://dashboard.cockpit-os.de/api/dispatch-intake/microsoft/callback |
Scopes: Mail.Read, offline_access, User.Read.
Redaktion
- Anbieter Microsoft 365 wählen
- Mit Microsoft verbinden — Anmeldung mit Dispatch-Postfach
- Status Verbunden nach erfolgreichem OAuth
Gleicher Cron importiert auch Microsoft-Postfächer.
AgencyOS Mail Interceptor (Phase 2 / Legacy)
Optional kann IT weiterhin das gemeinsame Postfach in AgencyOS dokumentieren (Feld „AgencyOS-Postfach“). Graph-Webhooks in AgencyOS ersetzen den Cron nicht automatisch — bevorzugt ist OAuth im Cockpit.
Weiterleitung / Webhook (weiterhin möglich)
| Anbieter | Bedeutung |
|---|---|
| Weiterleitung / Webhook | Postmark/SendGrid Inbound auf Cockpit-Webhook-URL |
| Google Workspace | DWD + Cron |
| Microsoft 365 | OAuth + Cron |
So testen
Google
- Postfach verbinden (siehe oben)
- Test-Mail an
dispatch@…senden, ungelesen lassen - Nach Cron-Lauf: Eintrag in Dispatch-Eingang
- Erneuter Cron: kein Duplikat (
external_message_id)
Microsoft
- OAuth abschließen
- Ungelesene Test-Mail im Postfach
- Cron-Lauf prüfen
Cron manuell (Ops)
curl -X POST "https://dashboard.cockpit-os.de/api/cron/dispatch-gmail-sync" \
-H "Authorization: Bearer $CRON_SECRET"
Betrieb (Env, ohne Secrets)
| Variable | Zweck |
|---|---|
GOOGLE_GMAIL_SERVICE_ACCOUNT_JSON | Gmail DWD Service-Account (Render Secret) |
DISPATCH_GMAIL_ALLOWED_DOMAINS | Erlaubte Mailbox-Domains |
AZURE_AD_* | Microsoft OAuth |
CRON_SECRET | Auth für /api/cron/dispatch-gmail-sync |
DISPATCH_WEBHOOK_SECRET | Optional für Webhook-Inbound |
DISPATCH_INTAKE_STRICT_MATCH | Optional true: unbekannte Empfänger ablehnen |
Weitere technische Details: Dispatch-Eingang und Workflow.
Mieterwechsel (Shop-Ersatz)
E-Mails mit A–Z-Mieterlisten oder Formulierungen wie „Gallery Kebabhaus wird durch Papa's Döner ersetzt“ sind kein Social-Post, sondern Shop-Stammdaten:
- Nach der KI-Analyse steht unter Nächster Schritt der alte und neue Name plus Shop bearbeiten — es wird kein Social-Entwurf angelegt.
- Im Shop-Editor Name, Öffnungszeiten und Texte prüfen und selbst speichern — cockpitOS benennt nicht still im Hintergrund um.
- Nur bei Schließung/Auszug „Shop entfernen“ (
shop_unpublish) wählen.
Agenten (MCP / AgencyOS)
Postfach-Konfiguration kann von Coding-Agenten gelesen und gesetzt werden — ohne Dashboard-Login:
| Tool | Zweck |
|---|---|
cockpit_center_dispatch_intake | Center-Postfach lesen |
cockpit_set_center_dispatch_intake | Center-Postfach setzen / Gmail verbinden |
cockpit_organization_dispatch_intake | Organisations-Postfach lesen |
cockpit_set_organization_dispatch_intake | Organisations-Postfach setzen |
cockpit_dispatch_intake_sync | Postfach manuell synchronisieren (scope optional) |
API-Details: AgencyOS-Integration — Dispatch-Postfach.
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /dashboard/dispatch-postfach-anbindung