Zum Hauptinhalt springen

Dispatch: Postfach-Anbindung

Alltag

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?​

  1. Redaktionsfluss → Dispatch (/dashboard/dispatch)
  2. Karte Postfach-Anbindung
  3. Einrichtungsebene: Center oder Organisation
  4. 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:

OptionBedeutung
Neue seit letztem SyncMails im Posteingang seit dem letzten erfolgreichen Abruf (Fallback: 7 Tage)
UngeleseneNur ungelesene INBOX-Mails
Letzte 24 StundenAlle INBOX-Mails der letzten 24 Stunden
Letzte 7 TageAlle 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:

EbeneVerhalten
OrganisationE-Mails landen in Dispatch ohne festes Center — Zuordnung per KI-Triage oder manuell
CenterE-Mails werden beim Eingang diesem Center zugeordnet
Gleiche Empfänger-AdresseCenter-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)​

AnbieterAnzeige
Weiterleitung / WebhookEmpfangsadresse + Webhook-URL (nur bei diesem Anbieter sichtbar)
Google WorkspaceBereich „Google Workspace“ mit Verbinden-Button
Microsoft 365Bereich „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)​

SchrittDetails
Service-Accountz. B. smg-mec-mails@console-wayfinder.iam.gserviceaccount.com
DWD in Google AdminScope https://www.googleapis.com/auth/gmail.readonly für Domain sawatzkimuehlenbruch.de
Render EnvGOOGLE_GMAIL_SERVICE_ACCOUNT_JSON = vollständiges JSON als eine Zeile (Secret, nie ins Repo)
Domain-FilterOptional 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​

  1. Anbieter Google Workspace wählen
  2. Postfach-Adresse eintragen, z. B. dispatch@sawatzkimuehlenbruch.de
  3. Verbinden — Testabruf auf INBOX
  4. 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)​

TabBedeutung
PrüfungNeu (noch nicht analysiert) + Klärung nötig (KI unsicher oder Entwurf offen)
AlleGesamtliste nach Filtern
ÜbernommenSocial-Entwurf liegt in der Freigabe, oder der Website-Entwurf liegt im Workflow und Social hängt nicht
VerworfenNicht 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):

  1. Summary — Was passiert? / Was macht cockpitOS? / Deine Entscheidung
  2. Bei Klärung nötig: Korrektur-Panel mit erkannten Center/Shop/Aktionen und Checkboxen (Shop entfernen, Angebot, News, Social, Sonstiges) → Bestätigen & weiter legt suggestedActions an und übergibt an die Steuerzentrale
  3. Sticky-Aktionen unten: Ablehnen, Bearbeiten, Freigeben/Ausführen
  4. 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​

  1. 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.
  2. Mail mit Bild-Anhang: Auto-Entwurf übernimmt das Bild. Ohne brauchbares Bild: „Bild fehlt — hier hochladen“.
  3. Mehrdeutiges Center: Fall bleibt in der Prüfung, Center zuordnen im selben Fall.
  4. Pool vorhanden, Auto-Publish aus: Entwurf liegt in der Freigabe. Berechtigte geben ihn im Dispatch-Detail frei, ohne Social-Freigaben zu öffnen.
  5. Als Content Editor erscheint kein Link in die Steuerzentrale.

Microsoft 365 (delegiertes OAuth)​

Voraussetzungen (IT)​

VariableZweck
AZURE_AD_TENANT_IDSMG-Tenant (gleiche App wie AgencyOS möglich)
AZURE_AD_CLIENT_ID / AZURE_AD_CLIENT_SECRETApp-Registrierung
Redirect-URIhttps://dashboard.cockpit-os.de/api/dispatch-intake/microsoft/callback

Scopes: Mail.Read, offline_access, User.Read.

Redaktion​

  1. Anbieter Microsoft 365 wählen
  2. Mit Microsoft verbinden — Anmeldung mit Dispatch-Postfach
  3. 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)​

AnbieterBedeutung
Weiterleitung / WebhookPostmark/SendGrid Inbound auf Cockpit-Webhook-URL
Google WorkspaceDWD + Cron
Microsoft 365OAuth + Cron

So testen​

Google​

  1. Postfach verbinden (siehe oben)
  2. Test-Mail an dispatch@… senden, ungelesen lassen
  3. Nach Cron-Lauf: Eintrag in Dispatch-Eingang
  4. Erneuter Cron: kein Duplikat (external_message_id)

Microsoft​

  1. OAuth abschließen
  2. Ungelesene Test-Mail im Postfach
  3. 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)​

VariableZweck
GOOGLE_GMAIL_SERVICE_ACCOUNT_JSONGmail DWD Service-Account (Render Secret)
DISPATCH_GMAIL_ALLOWED_DOMAINSErlaubte Mailbox-Domains
AZURE_AD_*Microsoft OAuth
CRON_SECRETAuth für /api/cron/dispatch-gmail-sync
DISPATCH_WEBHOOK_SECRETOptional für Webhook-Inbound
DISPATCH_INTAKE_STRICT_MATCHOptional 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:

  1. Nach der KI-Analyse steht unter Nächster Schritt der alte und neue Name plus Shop bearbeiten — es wird kein Social-Entwurf angelegt.
  2. Im Shop-Editor Name, Öffnungszeiten und Texte prüfen und selbst speichern — cockpitOS benennt nicht still im Hintergrund um.
  3. 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:

ToolZweck
cockpit_center_dispatch_intakeCenter-Postfach lesen
cockpit_set_center_dispatch_intakeCenter-Postfach setzen / Gmail verbinden
cockpit_organization_dispatch_intakeOrganisations-Postfach lesen
cockpit_set_organization_dispatch_intakeOrganisations-Postfach setzen
cockpit_dispatch_intake_syncPostfach 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