Social Media Freigabe (Outstand)
Lies zuerst Social Media — Einstieg (Checkliste für Redaktion). Kommt der Post aus einer Mail, reicht die Kurzanleitung Von der Mail bis zur Veröffentlichung. Diese Seite ist die vollständige Referenz.
Erstellen, planen und veröffentlichen bleibt im Dashboard (Editor, Kanäle, KI-Bild). Claude kann offene Freigaben listen und entscheiden, Community lesen und einen Performance-Kurzüberblick holen. Antworten, Liken und Verbergen bleiben im Dashboard. Grenzen: Claude & MCP → wer macht was?.
Fanpage Karma wird durch cockpitOS Freigabe + Outstand Publish** ersetzt. Strategie und Provider-Matrix: Social unter einem Cockpit-Dach.
| Was | Social Cockpit (eigenes Modul): Kanäle, Post-Editor, Freigaben (/dashboard/social/approvals), Engage, Reporting; Publish über Outstand. |
| Warum | Social getrennt vom Website-Workflow — übersichtliche Freigabe, Metriken und Kanäle an einem Ort. |
| Wer | Redaktion, Center Manager, Org-Marketing, Center-Admin (Freigabe); Betrieb/IT (Outstand-Keys, Webhook, Cron). |
| Wo | Sidebar Social Cockpit; Kanäle auch Center-Detail Social Media (?tab=social). |
| So testen | 1) Center → Social Media: Kanal verbinden (Instagram, Facebook, Threads, LinkedIn, TikTok, Bluesky, X) oder vorhandenes Profil zuordnen. 2) Post erstellen → Freigabe anfordern (beliebige aktive Cockpit-Nutzer wählen). 3) Gewählte Prüfer: Glocke + Desktop-Push (opt-in unter Einstellungen → Benachrichtigungen) + Meine Freigaben auf dem Board (für alle eingeloggten Nutzer). 4) Glocke anklicken: Freigabe-Anfrage öffnet das Board am markierten Post; „Post ist freigegeben“ / Ablehnung öffnet den Post. 5) Optional Selbst freigeben (jeder mit Center-Zugang) oder Freigabe-Link für Gast. 6) Mit AgencyOS-Anbindung: zusätzlich Teams-DM vom Bot (Freigeber muss Bot einmal geöffnet haben). |
| Betrieb | OUTSTAND_API_KEY, optional OUTSTAND_ORG_ID (für Erst-Connect ohne bestehende Profile), OUTSTAND_WEBHOOK_SECRET, CRON_SECRET — siehe Abschnitt Env unten. Teams über AgencyOS: AGENCYOS_TEAMS_NOTIFY_URL + AGENCYOS_TEAMS_NOTIFY_SECRET (beide Server). |
Rollen und Zuständigkeiten
Freigabe pro Post: Beim Einreichen wählt die Redaktion konkrete Personen aus allen aktiven Cockpit-Nutzern — nicht nur feste Freigabe-Rollen. Wer in der Liste steht, darf freigeben oder ablehnen.
Meine Freigaben (Standard): Das Freigabe-Board zeigt standardmäßig Posts, bei denen du als Prüfer ausgewählt wurdest, plus eigene Posts in Zur Freigabe, Überarbeitung oder Fehlgeschlagen (Veröffentlichungsfehler). Button Alle Freigaben blendet die komplette Center-Liste ein. Ein Klick aus dem Social-Cockpit auf Fehlgeschlagen (?tab=failed) öffnet Alle Freigaben, damit du alle Fehler im gewählten Center siehst.
Sortierung im Dialog: Zuerst Nutzer mit Center-Zuweisung, dann Organisation des Centers, danach das restliche Cockpit-Team. Suche nach Name, E-Mail oder Rolle.
Social-Freigabe-Pool (Organisation/Center): Unter Center → Team & Ansprechpartner (und Organisation → Tab KAM) legst du einen Pool mit Primär und Vertretung fest — wie beim Key Account Manager. Center ohne eigene Liste erben von der Organisation. Beim Freigabe-Dialog und bei Dispatch → Social-Entwurf werden Pool-Mitglieder automatisch vorausgewählt (Freigabe-Modus: Eine reicht). Vertretung für Urlaub: Rolle im Pool auf Vertretung setzen oder Primär tauschen.
Favoriten & letzte Auswahl: Stern neben einer Person speichert sie als Favorit (lokal im Browser, bis zu 8). Hat das Center einen Freigabe-Pool, gilt der Pool vor letzter Auswahl und Favoriten. Ohne Pool: zuerst letzte Freigeber für dieses Center, sonst Favoriten. Im Dialog oben: Anzahl ausgewählter Prüfer, darunter Favoriten als Schnellauswahl; in der Liste stehen Favoriten zuerst. Vor dem Senden: Box Empfänger dieser Freigabe mit allen Namen und der Senden-Button mit An … senden — damit klar ist, wer die Anfrage erhält.
Social-Lernvorschläge (Agent-Modus): Bei Ablehnung entsteht ein Lernvorschlag (pending) — er landet nicht automatisch in der KI. Als Lern-Lead markierte Personen im Freigabe-Pool (Organisation oder Center-Pool) erhalten eine Glocke; unter Social-Freigaben erscheint die Inbox Social-Lernvorschläge. Erst nach Freigabe fließt die Regel in Caption-/Brand-DNA-Prompts ein.
Social-Agent Pilot: Im Center unter Team & Ansprechpartner → Social-Freigabe-Pool kann Social-Agent Pilot aktiviert werden — Dispatch legt Social-Entwürfe dann automatisch zur Freigabe vor (Freigabe-Pool muss gepflegt sein).
Legacy ohne Zuweisung: Ältere Posts ohne assignedApproverIds bleiben bei den klassischen Freigabe-Rollen (Center Manager, Org-Marketing, Center-Admin, Super-Admin).
Externe Freigeber ohne Cockpit-Login: Im Center-Tab Team & Ansprechpartner kann ein Kontakt als Social-Freigabe und/oder Website-Freigabe markiert werden (E-Mail Pflicht). Beim Zur Freigabe wählst du sie optional aus (zuletzt gewählte externe Freigeber werden pro Center vorausgewählt — nicht automatisch alle). Nach Auswahl erhalten sie den Freigabe-Link per E-Mail — kein Benutzerkonto nötig. So kannst du zuerst intern gegenlesen lassen, ohne den Center Manager einzubeziehen. Im Freigabe-Board: „Wartet auf: Max Mustermann (extern)“.
Direkt veröffentlichen: Button Veröffentlichen im Editor weiterhin nur für Freigabe-Rollen (publish_direct). Selbst freigeben im Freigabe-Dialog ist für jeden Nutzer mit Center-Zugang möglich (ohne Warteschlange).
Hinweis für Freigabe (Editor, Schritt 2): Optionaler Text nur für Prüfer — z. B. Kontext oder Bitte, was geprüft werden soll. Er erscheint im Freigabe-Board (Karte und Details), in Freigabe-E-Mails an interne und externe Prüfer, auf dem externen Freigabe-Link und in der API (approverNote), nicht in Caption, Outstand oder auf den Kanälen.
Veröffentlichungszeitpunkt (Editor, Schritt 1): Drei Optionen — Sofort nach Freigabe (Standard, ohne Termin), Sofort veröffentlichen (nur Approver; nutzt den Button Veröffentlichen), Zum Termin (Datum und Uhrzeit wie bisher). Die Planungs-Zusammenfassung oben im Editor zeigt die gewählte Option; Termin springt direkt zum Feld auf Schritt 1.
Audit-Log (Nachvollziehbarkeit)
Social-Entwürfe erscheinen im Center-Audit-Log wie News, Shops oder Events — mit Entität Social-Entwurf (social_post_draft).
| Aktion | Wann geloggt |
|---|---|
| Anlegen | Neuer Post, Duplikat, Entwurf aus News/Event/Angebot/Bewertung |
| Bearbeiten | Text, Medien, Termin, Kanäle im Editor |
| Zur Freigabe | Einreichen oder erneut einreichen nach Ablehnung |
| Freigabe / Ablehnung | Intern im Board oder über externen Freigabe-Link |
| Planung | Termin verschieben oder geplante Veröffentlichung stornieren |
| Löschen | Entwurf entfernen (nicht bei bereits live veröffentlichten Posts) |
Wo sichtbar: Center-Dashboard → Audit / Änderungsprotokoll; für Agenten und AgencyOS über cockpit_audit_logs. Bei MCP/AgencyOS-Anlage zählt der Ersteller (createdByEmail), nicht nur der API-Key-Inhaber.
Center Manager
- Landing:
/dashboard/center-manager— KPIs, Freigabe-Kurzliste, Schnellfreigabe (Feed mit ≤1 Medium) - Social Hub: Sidebar Social Cockpit — alles gebündelt (siehe unten)
- Freigabeverlauf: Im CM-Social-Hub und Kalender sieht der Center Manager nur Freigabe-Runden, in denen er selbst Prüfer ist — inklusive Kommentare und Entscheidungen in dieser Runde. Interne Freigaben (nur Redaktion/Team ohne CM in der Prüferliste) sowie deren Kommentare und Verlauf sind für CMs nicht sichtbar. Veröffentlichung und Planung bleiben sichtbar.
- Löschen während Freigabe: Wird ein Post in der Freigabe gelöscht, erhalten Ersteller und Einreicher Glocke und E-Mail.
Social Cockpit (Modul social-cockpit)
Alles an einem Ort unter Social Cockpit in der Sidebar (eigenes Modul, wie Mall Cockpit):
| Menü | Pfad | Funktion |
|---|---|---|
| Übersicht | /dashboard/social | Mission Control: Heute (Freigaben, geplant, live, Kanäle, offene Kommentare), große CTAs, Hub-Kacheln zu Reporting & Kanälen |
Übersicht „Heute für dich“ (StatTile)
Die Startseite Social Cockpit (/dashboard/social) lädt Kennzahlen über GET /api/social/hub?centerId=…:
| Kachel | Bedeutung | Link |
|---|---|---|
| Warten auf Freigabe | Posts in der Freigabe-Warteschlange | Freigaben |
| Kommentare offen | Unbeantwortete Kommentare (Engage) | Community & Antworten |
| Geplant | Terminierte Posts | Freigaben |
| Live (7 Tage) | Kürzlich veröffentlicht | Engage |
| Kanäle verbunden | Verknüpfte Profile | Center → Social Media |
Darunter optional Follower/Reichweite (Monat), Abschnitt Performance · 30 Tage (Reach, Impressions, Engagement, Kanal-Posts, Plattform-Kacheln wie in Reporting — Link Deine Performance), große CTAs (Neuen Post, Freigaben, Antworten) und HubNavTile-Kacheln zu Reporting, Kanälen und Kunden-Reporting — gleiches Muster wie andere Modul-Hubs (HubNavGrid / StatTile in @mall-os/ui).
| Kanäle verknüpfen | Center → Reiter Social Media (?tab=social) | Instagram, Facebook, Threads, LinkedIn, TikTok, Bluesky, X — selbst anmelden oder vorhandenes Profil zuordnen |
| Post erstellen | /dashboard/social/new | Post anlegen |
| Kalender | /dashboard/social/calendar | Social-only: Monat, Woche, Tag, Liste — Thumbnail, Uhrzeit, Kanal, Status. Griff-Symbol ziehen verschiebt den Termin auf einen anderen Tag; Klick auf die Datum-Kachel plant einen neuen Beitrag. Klick auf eine Idee öffnet die Bearbeitung (Thema, Notiz, Tag) ohne Umwandlung in einen Post-Entwurf. Idee anlegen und Kalender teilen (Kunden-Link) wenn ein Center gewählt ist. Mit gewähltem Center: Überfällige auf heute verschiebt geplante/freigegebene Entwürfe (Status geplant, freigegeben, fehlgeschlagen) mit Plantermin vor heute auf heute und eine gemeinsame Uhrzeit (Standard 12:00 Europe/Berlin, im Dialog änderbar) — nicht Beiträge unter Freigaben; Dialog mit Dry-Run-Anzahl |
| Freigaben | /dashboard/social/approvals | Social-Freigaben (5 Bereiche inkl. Fehlgeschlagen) — Aus Fehlerliste entfernen (ohne Kanal-Löschung), Löschen mit Rückfrage. Button Kalender-Hinweis für Termine ohne Posting (nicht über Freigaben) |
| Community & Antworten | /dashboard/social/engage | Post-Liste + Kommentare beantworten (Master-Detail, Suche, Filter) |
| Deine Performance | /dashboard/social/reporting | Follower, Reichweite, Top-Post, Post-Liste mit Suche & Seiten |
Community & Antworten: Zweispaltig — links Posts auf den Kanälen (Cockpit und extern, z. B. direkt auf Facebook), rechts Kommentare zum gewählten Post. Badge Cockpit vs. Kanal zeigt, ob der Post aus dem Cockpit-Editor kam. Oben Zeitraum wählen (7/30/90 Tage, Kalendermonat oder eigenes Von–Bis), Filter nach Quelle (Cockpit / Kanal / Mit Kommentaren) und Kanal (Instagram, Facebook, Threads). KPI-Zeile: Cockpit-/Kanal-Posts, Kommentare (aus Metriken), Likes, Geteilt — Post-Liste zeigt Likes/Kommentare/Shares aus DB-Snapshots; Link Performance führt zu Deine Performance.
Community: Unter Kommentare die Kanal-Posts; unter Instagram-Nachrichten Direktnachrichten des verbundenen Instagram-Kontos (lesen und antworten, 7-Tage-Fenster als Support-Antwort).
Outstand in Community & Antworten:
| Funktion | Über Outstand-API |
|---|---|
| Kommentare lesen | Ja |
| Antwort als Thread unter Kommentar | Ja (parent_comment_id = Kommentar-ID; Facebook, Instagram, LinkedIn) |
| Emoji in Antwort | Ja (Editor im Cockpit) |
| Post-Metriken (Likes, Kommentarzahl) | Ja; Stories zusätzlich Antworten, Profilbesuche, Navigation (24 h) |
| Einzelnen Kommentar liken | Nein — Inbox (Zernio) oder native App |
| Kommentar verbergen | Ja — Instagram und Threads (Cockpit-Posts). Facebook: Inbox oder native App |
| Kommentar löschen | Ja — Instagram und Threads (Cockpit-Posts) |
| Posts die nicht über Outstand veröffentlicht wurden | Nein |
| Post vom Kanal löschen | Ja — Facebook, X, LinkedIn, Bluesky. Instagram, TikTok und Threads können das nicht. |
| Erneut teilen | Ja — X, LinkedIn, Threads, Bluesky (optional mit Text) |
| Instagram-Direktnachrichten | Ja — eigener Reiter Instagram-Nachrichten |
Antworten erscheinen unter dem jeweiligen Kommentar, nicht als neuer Top-Level-Kommentar — dafür wird die native Kommentar-ID an Outstand übergeben.
Deine Performance: Drei KPI-Karten (Follower, Reichweite, Top-Post), Plattform-Kacheln (Instagram, Facebook, …), Impressions- und Engagement-KPIs, Mini-Follower-Trend, Monats-Interaktionen, darunter alle Posts (Cockpit + Kanal-Inbox) mit Suche und 8 pro Seite. Oben Zeitraum wählen (wie Community). Button Als PDF öffnet einen druckoptimierten Report (im Browser „Als PDF speichern“). Follower-Verlauf eingeklappt, optional alle Zeilen. Button Zahlen aktualisieren (technisch Metrik-Sync).
Outstand-Datenfluss: Publish → Outstand (/v1/posts/ + Media-Confirm) → Outstand sync schreibt Account- & Post-Metriken in die DB → Reporting, Engage und Dashboard-Home lesen daraus (Follower-Zuwachs, Monats-Reichweite, Interaktionen, Top-Post).
Performance & Plattform-Hinweise
- Deine Performance:
/dashboard/social/reporting— Kern-KPIs oben:- Follower & Zuwachs (Summe aller verknüpften Kanäle, Delta zwischen erstem und letztem Snapshot im Sync-Zeitraum)
- Reichweite und Impressions (Summe über Posts im gewählten Zeitraum)
- Engagement-Rate (Durchschnitt über Posts mit Outstand-Analytics)
- Top-Post (stärkster Post nach Reach → Impressions → Interaktionen)
- Performance pro Kanal — eigene Kachel je Netzwerk (Follower, Zuwachs, Reach, Posts)
- Follower-Trend — Mini-Chart aus Snapshot-Verlauf
- Interaktionen (eigene Karte): Likes, Kommentare und Geteilt als Monatssumme; in der Post-Liste pro Eintrag inkl. Impressions und Engagement
- Dashboard-Home: Zeigt neben Reichweite auch die Monats-Interaktionen (Likes · Kommentare · Geteilt) mit Link zum Reporting
- Outstand sync lädt frische Metriken von Outstand in die DB — ohne Sync bleiben KPIs leer oder veraltet (manuell in Reporting oder täglich per Cron
/api/cron/outstand-sync) - Bluesky: Outstand liefert derzeit eingeschränkte Metriken und Kommentare
- Detail-Freigabe: Story, Bildreihe und Reel ohne Schnellfreigabe — Medien werden beim Einreichen und vor Freigabe zu Outstand gespiegelt; bei Fehlern Editor öffnen und erneut freigeben
Workflow
Social-Posts haben eine eigene Freigabe-Ansicht unter /dashboard/social/approvals (nicht mehr in der Website-Workflow-Liste vermischt).
Fünf Bereiche:
- Zur Freigabe —
in_review, wartet auf Center/Marketing - Fehlgeschlagen — Veröffentlichung nicht gelungen oder teilweise (z. B. Instagram live, Facebook fehlgeschlagen); roter/gelber Hinweis, Button Erneut veröffentlichen; Aus Fehlerliste entfernen, wenn der Post manuell geklärt ist (Kanäle bleiben unverändert)
- Überarbeitung — abgelehnt, mit Grund; Button Erneut zur Freigabe
- Entwürfe — noch nicht eingereicht
- Live & geplant — veröffentlicht oder terminiert
Veröffentlichungsfehler
| Was | Wo | So testen |
|---|---|---|
| Medien vor Publish | Editor → Qualitätsprüfung (läuft automatisch) | Bild mit Umlaut/Leerzeichen im Dateinamen hochladen — Dateiname wird beim Outstand-Upload ASCII-sicher; nicht erreichbare URL blockiert Planung mit Hinweis Bild nicht erreichbar — bitte neu hochladen |
| Nach fehlgeschlagenem Publish | Freigaben → Tab Fehlgeschlagen; Badge an Freigaben in der Social-Navigation; Warnung auf Social-Übersicht | Test-Post mit kaputtem Medium freigeben — Ersteller und Freigabe-Pool erhalten Glocke und E-Mail (optional Teams über AgencyOS) |
| Erneut versuchen | Freigaben-Karte → Erneut veröffentlichen (Freigabe-Rollen) oder Editor → Medien tauschen | Nach Medien-Fix erneut freigeben — kein automatisches Republish ohne Freigabe |
Pro Karte: Vorschaubild (bei Reels als Video-Vorschau), Status und Format auf Deutsch (z. B. Zur Freigabe durch Sie / In Prüfung bei fremder Zuständigkeit, „Bildreihe“), Meta-Zeile (Eingereicht von, Center, Termin), Zuständigkeit (Avatare + „Freigabe ausstehend bei …“ oder „Zur Freigabe durch Sie“), aufklappbares Detail-Panel (Text, Kanal-Vorschau bei Story/Reel inkl. Reel-Safe-Zone, abspielbare Medien, Chat am Posting mit Verlauf), darunter Editor, Freigabe-Link, Freigeben / Ablehnen (für zugewiesene Prüfer; Super-Admin kann bei Alle Freigaben auch fremde Posts freigeben).
Anmerkungen zur Freigabe: Im Detail-Panel kann jede Person mit Center-Zugang Kommentare hinterlassen (z. B. „Bitte anderes Bild“). Der Ersteller bzw. zuletzt Einreichende erhält eine Glocke und sieht die Anmerkung im Verlauf — ohne den Post ablehnen zu müssen.
Freigabe anfordern (Dialog)
Beim Klick Zur Freigabe im Editor (oder Erneut zur Freigabe nach Ablehnung):
- Prüfer auswählen — alle aktiven Cockpit-Nutzer (Checkbox-Liste mit Avatar, Rolle; Suche; Center/Org zuerst sortiert)
- Freigabe-Regel: Eine Person reicht oder Alle müssen freigeben (bei mehreren Prüfern)
- Optional Freigabe-Link für Gast — ohne Cockpit-Login, wird in Benachrichtigung/E-Mail mitgeschickt
- Selbst freigeben — direkt veröffentlichen ohne Warteschlange (für jeden Nutzer mit Center-Zugang, z. B. Kopie eines bereits geprüften Posts)
- Vor dem Absenden: Empfänger dieser Freigabe (Namen aller ausgewählten Prüfer) und Senden-Button An … senden
Gewählte Prüfer erhalten Glocke, sofort E-Mail und optional Desktop-Push (Opt-in). Auf dem Freigabe-Board: Filter Meine Freigaben zeigt Posts, bei denen du als Prüfer eingetragen bist — für alle eingeloggten Nutzer inkl. Super-Admin. Alle Freigaben zeigt die Gesamtübersicht (z. B. für Admins).
Korrektur ohne Ablehnung: Freigeber öffnet Editor, korrigiert Text/Medien, speichert — Status bleibt zur Freigabe (kein Zurückweisen nötig).
Geplant & freigegeben — bearbeiten:
| Status | Editor | Termin ändern | Planung stornieren | Löschen |
|---|---|---|---|---|
| Zur Freigabe / Entwurf / Abgelehnt | Ja | Ja | — | Ja — in der Freigaben-Übersicht und im Editor |
| Geplant oder freigegeben mit Termin | Ja — Text, Bild, Kanäle, Termin | Ja | Ja, wenn schon bei Outstand → zurück zu Entwurf | Ja — Übersicht und Editor (bricht die Planung bei Outstand ab) |
Live (published) | Ja — Text/Medien speichern, Sync zu Outstand | Nein | Nein | Nein (nur auf dem Kanal entfernen) |
Im Editor erscheint der Hinweis: Geplant — Änderungen gelten für den Veröffentlichungstermin.
Planung über 30 Tage (Outstand-Limit): Outstand akzeptiert Termine höchstens 30 Tage im Voraus. Liegt der gewünschte Termin weiter in der Zukunft, speichert das Cockpit die Freigabe lokal (Status Geplant, noch ohne Outstand-Post). Im Termin-Picker und in der Qualitätsprüfung erscheint der Hinweis zur automatischen Übergabe. Täglich (Cron mit CRON_SECRET, Endpoint /api/cron/social-deferred-outstand-push, zusätzlich im Outstand-Metrik-Sync) werden fällige Posts an Outstand übergeben — spätestens 30 Tage vor Live-Gang. Nach Freigabe siehst du z. B.: Geplant — Outstand-Übergabe am … Planung stornieren oder löschen funktioniert auch vor der Outstand-Übergabe (nur Cockpit, kein Kanal-Eingriff).
Wer darf ändern: alle mit Zugang zum Center im Social-Modul (gleiche Schwelle wie bei Entwürfen). Direkt veröffentlichen bleibt den Freigabe-Rollen vorbehalten.
Löschen in der Übersicht (/dashboard/social/approvals, FB-H5TZ6IXO): Auf jeder Karte außer Live-Posts gibt es Löschen. Es erscheint eine Rückfrage. Wer das Center sehen darf (Super-Admin und Center-Rollen mit Zugang), darf löschen — dieselbe Regel wie im Editor. Live-Posts zeigen den Knopf nicht. Nach dem Löschen aktualisiert sich die Liste.
Geplante Posts werden beim Speichern im Cockpit aktualisiert und — wenn schon ein Outstand-Post existiert — dort mitgezogen. Fehlt die Outstand-ID, bleibt die Änderung lokal. Live-Posts: Text, Medien und Kanal-Texte können korrigiert werden; der Footer zeigt nur Speichern (kein erneutes Veröffentlichen). Planung stornieren bricht den Termin ab und setzt den Post auf Entwurf zurück (erneute Freigabe nötig). Löschen entfernt den Post ganz — bei geplanten Posts inklusive der Planung bei Outstand.
Medien (Story/Reel/Video): Bilder und Videos aus dem Cockpit-Upload (Bunny CDN) werden beim Speichern oder Zur Freigabe zu Outstand gespiegelt — Instagram/Meta erreicht Bunny-URLs oft nicht direkt. Das Cockpit liert Medien dafür bevorzugt aus der Mediathek/Bunny Storage (nicht nur über die öffentliche CDN-URL), damit Veröffentlichen auch bei CDN-Abruf-Problemen zuverlässig klappt. Der Schritt kann bei großen Videos einige Sekunden dauern; danach ist Freigeben deutlich schneller. Schlägt das Spiegeln fehl, erscheint eine konkrete Fehlermeldung (kein generischer Gateway-Fehler).
Website-Freigaben bleiben unter /dashboard/workflow.
Im Redaktions-Kalender (/dashboard/content/planner) erscheinen Social-Posts am geplanten Termin — Filter-Chip Social; im Monatsraster steht eine Caption-Vorschau (nicht nur der Platzhalter „Social-Post“). Dazu zählen auch Entwürfe und Ideen mit Datum (Schalter Entwürfe anzeigen, Standard: an). Posts ohne Termin liegen nicht auf „heute“, sondern in der Seitenliste Offene Entwürfe. Klick auf einen Eintrag öffnet den Editor (/dashboard/social/[id]). Klick auf eine Datum-Kachel öffnet Post erstellen mit diesem Tag (Standard 09:00) und dem im Kalender gewählten Center. Status erscheint in Alltagssprache (Entwurf, Idee, Zur Freigabe). Oben: KPI-Zeile und Content-Mix (News, Events, Angebote, Social …). Das gewählte Center bleibt nach einem Seitenwechsel erhalten (gleiche Auswahl wie in der Kopfzeile). Für die Social-Redaktion gibt es zusätzlich einen eigenen Social-Kalender (/dashboard/social/calendar): Monat, zwei Wochen, Woche, Tag und Liste mit Thumbnail, Uhrzeit, Kanal und Status — Filter nach Phase (Entwurf ist standardmäßig an) — betrifft nur terminierte Posts im Kalender-Raster; Offene Entwürfe (ohne Termin) bleiben in der Seitenleiste sichtbar. Zusätzlich „Meine Posts“ und „Meine Freigaben“. Undatierte Entwürfe stehen unter Offene Entwürfe (Seitenleiste; in der Liste-Ansicht als eigener Block; auf schmalen Displays oberhalb des Rasters) — per Griff-Symbol auf einen Tag ziehen, um einen Termin zu setzen. Geplante Posts (nicht live) lassen sich am Griff-Symbol auf einen anderen Tag ziehen; die Uhrzeit bleibt erhalten (ohne Termin: 10:00). Dieselbe Datum-Kachel plant dort ebenfalls einen neuen Beitrag. Dort KPI-Zeile (Gesamt, Zur Freigabe, Geplant, Live) und Post-Mix (Beitrag, Bildreihe, Story, Reel). Beide Kalender nutzen dieselben Dashboard-Tooltips beim Überfahren von Einträgen und dasselbe Center aus der Kopfzeile.
Redaktionsplanung mit dem Kunden (Kalender teilen)
| Schritt | Wo | Was passiert |
|---|---|---|
| Kalender-Hinweis anlegen | Social-Kalender → Kalender-Hinweis oder Freigaben → Kalender-Hinweis | Titel, Beschreibung, Datum, optionale Art (Kampagnenstart, Facebook-Veranstaltung …) — kein Post, keine Outstand-Veröffentlichung |
| Kalender-Hinweis per Agent | MCP cockpit_create_social_calendar_hint | Gleiche Felder wie im Dialog; AgencyOS POST /api/agencyos/v1/social/calendar-hints — Status Idee, kein Outstand |
| Idee anlegen (gleich wie Kalender-Hinweis) | wie oben | Technisch Status Idee; optional Kundenfreigabe anfordern über geteilten Kalender |
| Idee bearbeiten | Social-Kalender → Klick auf Idee oder Link /dashboard/social/[id] bei Status Idee | Thema, Notiz und geplanter Tag anpassen — Status bleibt Idee (Ideen-Dialog, kein Post-Editor) |
| Keine Freigabe für Ideen | Freigaben-Board, Editor, API | Zur Freigabe / Freigeben / Veröffentlichen ist für Status Idee gesperrt (HTTP 409) — zuerst Post aus Idee im Kalender |
| Link teilen | Social-Kalender → Kalender teilen / Per E-Mail | Öffentlicher Link /planung/social/{token} (90 Tage) |
| Kunde öffnet Link | Browser, ohne Login | Monatskalender mit Entwürfen, Ideen, geplanten und veröffentlichten Posts — farblich gekennzeichnet (Entwurf/Idee, Geplant, Veröffentlicht); Klick öffnet Details |
| Kundenfreigabe | Im geteilten Kalender | Ideen mit Status Kundenfreigabe offen → Freigeben oder Ablehnen (auch im Detail-Panel) |
| Kommentare & Budget | Detail-Panel im geteilten Kalender | Rückmeldungen und Budget-Hinweise als Kommentare — sichtbar für Redaktion und CM (Freigabe-Board / CM-Cockpit) |
| Redaktion | Social-Kalender / Freigaben | Kundenvorschläge und freigegebene Ideen wie gewohnt weiterbearbeiten (Post aus Idee) |
So testen (Planung): Center in der Kopfleiste wählen → Idee anlegen mit Thema und Tag → Kalender teilen → Link im Inkognito-Fenster öffnen → Kalender-Eintrag anklicken (Detail, Kommentar, Budget-Hinweis) → Entwurf ohne Termin unter Entwürfe ohne Termin → Thema vorschlagen und optional Datei hochladen → bei Idee mit Kundenfreigabe Freigeben/Ablehnen prüfen.
So testen: Social-Post als Entwurf speichern und einen Veröffentlichungstermin setzen → Kalender zeigt den Eintrag an diesem Tag. Ohne Termin → Eintrag unter Offene Entwürfe. Griff-Symbol auf anderen Tag ziehen → Toast „Termin verschoben“, Eintrag erscheint am Zieltag (Uhrzeit unverändert). Offenen Entwurf aus Offene Entwürfe auf einen Tag ziehen → Termin gesetzt, Entwurf verschwindet aus der Seitenliste. Klick auf den Eintrag öffnet /dashboard/social/[id]. Schalter Entwürfe anzeigen aus → Entwürfe verschwinden. Leere oder belegte Datum-Kachel (nicht den Eintrag) anklicken → Editor mit diesem Tag, 09:00, und dem Center aus der Kopfzeile. Kalender mit gewähltem Center öffnen: die Monatstafel muss erscheinen (kein weißer Fehler).
- Neu anlegen: Sidebar Social Cockpit → Post erstellen oder
/dashboard/social/new - Aus Website-Inhalt: Auf der Detailseite von News, Event oder Angebot Button Als Social-Post — übernimmt Titel, Kurztext und Bild(er) in einen neuen Entwurf (
POST /api/social/from-content), Editor unter/dashboard/social/[draftId]. Event und Angebot erscheinen im Social-Kalender automatisch am Startdatum (09:00); News am Veröffentlichungsdatum. Termin im Editor anpassbar. Ideen bearbeitest du im Kalender per Klick (Dialog) — sie bleiben Ideen, bis du daraus einen Post erstellst. Der Kalender aktualisiert sich beim Zurückwechseln in den Tab. - Aus Google-Bewertungen: Unter Analytics → Bewertungen (
/dashboard/analytics/reviews) pro Review Social-Post — KI-Caption zu Lob/Kritik (Fallback: Textbaustein ohne AI-Key). Bei KI-Empfehlungen zusätzlich Social Sammel-Post zum Thema (z. B. mehrfach „Parken“ bemängelt). Optional Center-Hero als Bild. - Auf Google antworten: Nach OAuth-Verbindung (Integration → Google Places → Tab Business Profile, dann auf der Reviews-Seite Mit Google verbinden) Button Bei Google senden im Dialog. Ohne Verbindung: KI-Vorschlag, kopieren, Link zu Google.
- Reviews-Anzahl: Ohne GBP-Verbindung zeigt Google Places höchstens 5 aktuelle Bewertungen; die Gesamtzahl auf Google kann höher sein. Mit verbundenem Business Profile werden mehr Reviews geladen (API mit Paginierung).
- KI-Analyse erneuern: Button Erneut analysieren oder Aktualisieren (lädt Reviews neu und startet bei Bedarf eine neue KI-Auswertung). Fehlermeldung erscheint, wenn kein KI-API-Key konfiguriert ist.
- Social aus Reviews: Buttons Themen-Post / Social: Thema aufgreifen erzeugen einen allgemeinen Beitrag zum Thema (z. B. Parken, Service) — keine direkte Social-Antwort auf eine einzelne Beschwerde. Für die persönliche Antwort: Antworten (Google / Kopieren).
- Kommentare & Glocke: Hub zeigt Kommentare offen; neue Kommentare erzeugen eine Benachrichtigung in der Glocke (Deep-Link zu Community mit Filter „Mit Kommentaren“). Empfänger sind der Social-Freigabe-Pool (Center oder Organisation, Tab Team) — ohne Pool: Center-Redaktion mit Content-Zuweisung, nicht reine Key-Account-Manager-Zuständigkeit. Alle 30 Minuten prüft der Cron Social Comment Alerts alle Center mit Social-Kanälen (Outstand + Zernio Inbox). Manuell: Community oder
POST /api/social/comments/sync. - Bearbeiten: In Social Freigaben Button Editor oder
/dashboard/social/[draftId] - Kopieren: Button Kopie / Als Kopie für anderes Center — übernimmt Text und Medien in einen neuen Entwurf (
pending). Im Dialog: Center wählen, optional eigener Termin (oder Termin vom Original). Für mehrere Standorte an unterschiedlichen Tagen: pro Center eine Kopie erstellen. API:POST /api/social/drafts/{draftId}/duplicate - Löschen: In Social Freigaben Button Löschen (Rückfrage) — außer bei Live-Posts. Agenten:
cockpit_delete_social_draftbzw.DELETE /api/agencyos/v1/social/drafts/{draftId} - Vom Kanal löschen (Live-Post): Im Editor bei veröffentlichten Posts mit Outstand-ID — Button Vom Kanal löschen (Rückfrage). Entfernt den Beitrag auf Facebook, X, LinkedIn, Bluesky und Threads (nicht Instagram/TikTok). Bei Mehrkanal-Posts kann das Cockpit andere Kanäle löschen, Instagram aber nicht per API — dann erscheint ein Hinweis, den Instagram-Beitrag manuell in der Instagram-App zu entfernen. Der Entwurf bleibt im Cockpit mit Status Vom Kanal entfernt (
archived); danach kann er wie ein normaler Entwurf gelöscht werden. Aktion erscheint im Audit (remote_deleted). API:POST /api/social/drafts/{draftId}/delete-remote· AgencyOS/MCP:POST /api/agencyos/v1/social/drafts/{draftId}/delete-remote·cockpit_social_delete_remote - Editor (
/dashboard/social/new): zweispaltiges Layout — zwei Schritte, Vorschau und Aktionen rechts- Immer oben: Center-Leiste (gleiche Auswahl wie Planer und Freigaben). Upload braucht das Center.
- 1. Inhalt: zuerst Kanäle, dann Format (nur was zu den Kanälen passt), dann Text und Foto/Video. Fachbegriffe (Story, Reel, Hashtag …) erklären sich per gepunktetem Tooltip. Gewählte Kanäle sind grün mit Haken, jedes Netzwerk hat seine Farbe am Icon.
- Text: Schalter Selbst / Vorschlag — der Vorschlag erscheint an derselben Stelle, nicht in einem Extra-Reiter.
- Foto: Schalter Hochladen / Zaubern (bei Reel nur Upload, weil ein Reel ein Video braucht).
- Reel-Cover (Instagram): Direkt unter dem Video in 1. Inhalt — Schieberegler wählt das Standbild für das Feed-Raster; alternativ Foto aus der Mediathek oder Bild-URL. Die Vorschau rechts zeigt das Cover im Instagram-Feed.
- 1. Inhalt (Fortsetzung): Veröffentlichungszeitpunkt und Instagram-Markierungen/Collabpartner direkt nach Medien — ohne Wechsel zu Schritt 2.
- 2. Veröffentlichen: nur kanal-spezifische Extras (erster Kommentar, TikTok-Schalter, Threads-Antworten, Standort, Link).
- Gilt für: zeigt das Center aus der Leiste; Center ändern öffnet denselben Switcher (⌘K). Die Auswahl bleibt beim Seitenwechsel, bis du sie manuell änderst.
- Weitere Center nur für diesen Post: optional zusätzlich ankreuzen, ohne die Leiste zu überschreiben (z. B. derselbe Text für zwei Standorte)
- Super-Admin ohne konkretes Center: Hinweis, oben in der Leiste ein Center zu wählen
- @-Button neben dem Textfeld — Marken aus der Shop-Liste (Instagram-Profil im Shop hinterlegt) oder Personen per Instagram-Namen direkt im Beitragstext als
@nameeinfügen - Emoji-Button neben dem Textfeld (Smiley) — vollständiger Picker mit Suche, Kategorien und Hauttönen; Emojis direkt in die Caption einfügen
- Medienvorschau: Thumbnail anklicken → Vergrößern (Lightbox)
- Dateigröße: Beitragsbilder max. 10 MB (JPG/PNG), Videos max. 100 MB. Größere Dateien werden beim Upload bzw. vor Zur Freigabe abgewiesen — mit Hinweis, das Bild zu verkleinern oder als JPG zu exportieren (verhindert fehlende Vorschau und leere Freigabe-Einträge).
- Karussell / Story-Serie: Bei mehreren Fotos Reihenfolge per Ziehen ändern (Griff-Symbol unten rechts, Nummern auf den Vorschaubildern) oder mit Start ein Bild als erstes Slide setzen — die Reihenfolge wird beim Speichern übernommen
- Kanäle (Schritt 1) beziehen sich nur auf die Center dieses Posts; fehlende Outstand-Profile werden pro Center mit Link zum Reiter Social Media genannt
- Rechts immer sichtbar: Veröffentlichen (für Freigabe-Rollen direkt an Outstand), Zur Freigabe, Entwurf
- Vorschau (rechts): Facebook-/Instagram-Feed und Story (9:16) mit Absätzen wie live — Tabs wechseln, Text pro Kanal wird berücksichtigt
- Instagram-Karussell: Slides in der Vorschau wischen (Touch) oder per Pfeile/Klickzonen durchblättern — wie in der App
- Facebook-Karussell: Alle Fotos als Kollage in einem Beitrag (keine Slideshow) — entspricht der Facebook-Darstellung
- Facebook-Feed: Querformat etwa 1,91:1 oder Quadrat 1:1. Passt das Bild nicht, bleiben helle Ränder sichtbar (kein Vollflächen-Zuschnitt).
- Instagram-Feed: typisch 1:1, bei Hochformat 4:5. Das Bild füllt die Fläche; überstehende Ränder werden abgeschnitten.
- Story: Hochformat 9:16, ebenfalls vollflächig mit möglichem Zuschnitt.
- Unter der Vorschau steht ein kurzer Hinweis, damit Redaktion Ränder und Zuschnitt vor dem Live-Gang einschätzen kann.
- Pro Tab ein Format-Hinweis. Bei Reel wechselt die Vorschau automatisch zum Reel-Tab. Videos laufen in der Vorschau ab. Eine halbtransparente Safe-Zone (Profil oben, Buttons rechts, Text unten) zeigt Überlagerungen — auch ohne Video als Schablone; der grüne Rahmen markiert die sichere Fläche. Schalter Safe-Zone anzeigen ist standardmäßig an.
- Text pro Kanal: Bei mehreren Kanälen Schalter direkt unter Dein Text — z. B. Facebook ohne Hashtags, Instagram mit Hashtags. Das gemeinsame Textfeld darf leer bleiben, wenn jeder gewählte Kanal einen eigenen Text hat. Fehlt der Text bei einem Kanal, erscheint ein Hinweis mit dem Kanalnamen (FB-EBKWR0KM).
- Bild pro Kanal (Facebook / Instagram): Schalter im Medien-Bereich, wenn Facebook und Instagram gewählt sind (Beitrag oder Karussell). Pro Kanal eigenes Foto hochladen; andere Kanäle nutzen das Standard-Foto. Die Vorschau rechts zeigt je Tab das passende Bild. Beim Veröffentlichen werden unterschiedliche Medien als getrennte Outstand-Übergaben je Kanalgruppe gesendet (ein Cockpit-Entwurf, gemeinsamer Termin).
- @-Button / Profil-Verlinkung: Instagram — Marken und Personen per @ im Caption-Text (Shop-Liste oder Handle). Facebook: Seiten-Tags im Text sind über Outstand nicht wie in der App klickbar — Partner im Text nennen oder optional Link ergänzen.
- Standort & Link: Unter Veröffentlichen — Standort per Suche wie in der Instagram-App wählen (Ortsangabe am Post, nicht im Caption-Text). Die Suche nutzt verknüpfte Facebook-Seiten der gewählten Center als Fallback, wenn die Outstand-Ortssuche nicht antwortet; Link optional (Facebook-Vorschau mit Link-Karte; Link wird beim Veröffentlichen ergänzt)
- Story: Bild oder Video; mehrere Dateien = Story-Serie (jede Datei eine Slide, erscheint hintereinander im Story-Ring — ein Entwurf, eine Freigabe). Text optional, kein erster Kommentar
- Reel: nur Video (MP4, MOV, WEBM). Ein Bild allein lässt sich nicht mehr planen oder veröffentlichen — die Meldung erscheint vor dem Senden an Outstand. Text optional
- Text vorschlagen: Bei Dein Text auf Vorschlag wechseln — Stichworte und/oder Foto anhängen → optional Regel-Vorlage → Text vorschlagen. Danach steht der Text wieder im normalen Feld. Der Text orientiert sich an den gewählten Centern und Kanälen (Facebook ohne Hashtags). Basis-Prompt: Einstellungen → KI-Verwaltung → Prompt-Einstellungen → Reiter Social.
- Bild-Assistent: Beim Foto auf Zaubern wechseln — Bildidee, Qualität, optionale Vorlagen. Bei Reel gibt es den Schalter nicht, weil ein Video nötig ist. KI-Bilder werden auf Instagram mit dem Hinweis „AI info“ gekennzeichnet.
- Threads: Unter Veröffentlichen Wer darf antworten, wenn ein Threads-Kanal gewählt ist.
- Instagram Markierungen & Collabs (Schritt 1. Inhalt, nur wenn Instagram-Kanal gewählt):
- Markierungen setzen: Instagram-Namen ohne @, durch Komma getrennt — markiert Konten am Bild/Video (Beitrag, Karussell, Reel). Nur öffentliche Business- oder Creator-Profile; private oder nicht taggbare Konten führen zum Veröffentlichungsfehler (das Medium ist dann in Ordnung). Button Aus Liste übernimmt Shop-Marken aus dem Center.
@nameim Caption-Text ist eine Texterwähnung und wird nicht automatisch als Markierung am Medium gesendet — für Partner reicht oft der Text ohne Eintrag in der Markierungsliste. Die Position am Bild wählt Instagram automatisch; im Cockpit gibt es keinen Tag-Editor. - Collabpartner einladen: bis zu drei Partner — sie erhalten eine Einladung in Instagram und müssen zustimmen. Nur bei Beitrag, Karussell und Reel; nicht bei Stories.
- Qualitätsprüfung prüft ungültige Namen und Collabs bei Stories vor dem Veröffentlichen.
- Grenzen: Nur Business-/Creator-Konten über die Meta-Graph-API; private Konten können nicht markiert werden. Collab erscheint erst nach Annahme durch den Partner.
- Markierungen setzen: Instagram-Namen ohne @, durch Komma getrennt — markiert Konten am Bild/Video (Beitrag, Karussell, Reel). Nur öffentliche Business- oder Creator-Profile; private oder nicht taggbare Konten führen zum Veröffentlichungsfehler (das Medium ist dann in Ordnung). Button Aus Liste übernimmt Shop-Marken aus dem Center.
- Freigabe-Link (öffentlich):
/freigabe/social/{token}— Medien aus dem Entwurf (containers); relative Pfade werden serverseitig aufgelöst. Beitragstext erscheint rechts neben dem Bild (auf schmalen Displays darunter); bei Text pro Kanal werden Facebook-, Instagram- und weitere Varianten getrennt angezeigt. Ohne gespeichertes Medium erscheint ein Hinweis (Entwurf im Editor speichern, bevor der Link verschickt wird). - Format (Schritt 1, nach den Kanälen): offizielle Namen je Kanal — Instagram/Facebook Beitrag, Karussell, Story, Reel; TikTok Video. Instagram-Beitrag: 1:1, 4:5 oder 1,91:1. Story und Reel: 9:16. Karten, die zum Kanal nicht passen (z. B. Story auf Threads), sind gesperrt.
- Termin (Schritt 1): Veröffentlichungszeitpunkt per Kalender — ohne Termin Veröffentlichung direkt nach Freigabe
- So testen: 1) Neuer Post — Kanäle klicken (gewählt = grün mit Haken, Icon in der Netzfarbe), dann Format. 2) Bei Text Vorschlag einschalten, Text erzeugen, wieder Selbst. 3) Bei Foto Zaubern oder hochladen. 4) Termin und ggf. Instagram-Markierungen auf 1. Inhalt setzen. Rechts bleiben Vorschau und die Buttons.
- Aus Dispatch: E-Mail → Entwurf → Tab Social Media
Text vorschlagen: eigene Regel-Vorlagen
| Was | Beim Textvorschlag kann die Redaktion benannte Vorlagen anlegen (Name + Regeln, wie eigene Anweisungen). Eine gewählte Vorlage gilt für den nächsten Vorschlag — z. B. immer genau fünf Hashtags: Centername, Stadt, drei zum Thema. |
| Warum | Hashtag- und Tonalitäts-Regeln sollen nicht jedes Mal neu getippt werden. Der Super-Admin-Prompt bleibt die Basis; Vorlagen sind zusätzliche, wiederholbare Anweisungen. |
| Wer | Redaktion mit Center-Zugang (Planetencenter sieht die Vorlagen dieses Centers). Bearbeiten und Löschen nur bei eigenen Vorlagen (Super-Admin darf alle im Center). |
| Wo | Social Cockpit → Neuer Post → Dein Text → Schalter Vorschlag. |
| So testen | 1) Center wählen (z. B. Planetencenter). 2) Neue Vorlage: Name „5 Hashtags“, Regeln „Nur 5 Hashtags: Centername, Stadt, drei zum Thema.“ 3) Vorlage wählen, Stichworte eingeben, Text vorschlagen. 4) Vorlage eines Kollegen: sichtbar, aber ohne Bearbeiten/Löschen. 5) Ohne Center: Hinweis statt Auswahl. |
Nach Freigabe: Outstand POST /v1/posts/ — Medien als containers[].media mit { url, filename }. Story und explizites Format Reel setzen für Instagram und Facebook publishAsStory bzw. publishAsReel. Ein Feed-Video wird auf Instagram als Reel veröffentlicht, auf Facebook bleibt es ein normaler Video-Beitrag (ohne Reel-Flag). Outstand erhält nur Netzwerk-Blöcke der ausgewählten Kanäle. Optional Erster Kommentar im Editor: fährt als zweiter Container mit (auch bei geplanten Posts). Stories ohne ersten Kommentar — die Kanäle lehnen das ab. Kanal-Status (Facebook/Instagram …) erscheint als Badges nach Publish — gelb = noch ausstehend, grün = live, rot = Fehler. Bei mehreren Kanälen kann Facebook etwas länger brauchen; das Cockpit wartet bis zu ~30 Sekunden und zieht den Status beim erneuten Öffnen des Entwurfs nach. Schlägt Publish fehl, steht die konkrete Kanal-Meldung im Toast und am Entwurf (publishError).
Historische / native Posts: Outstand listet nur Beiträge, die über Outstand rausgegangen sind (GET /v1/posts). Kommentare auf fremde Kanal-Posts ebenfalls nicht. Deshalb bleibt Zernio Inbox die Quelle für Posts, die direkt auf Facebook/Instagram o. Ä. entstanden sind (Community-Filter Kanal). Das hat sich in der aktuellen Outstand-Doku nicht geändert.
Planung: Der Termin geht an Outstand (scheduledAt). cockpitOS sendet den Post nicht selbst zum Termin nach. Webhook (post.published / post.error) setzt den Entwurf auf live oder Fehler. Fallback: alle 30 Minuten prüft /api/cron/social-comment-sync überfällige geplante Posts bei Outstand (zusätzlich der tägliche /api/cron/outstand-sync). Öffnet jemand den Entwurf nach dem Termin, wird der Status ebenfalls nachgezogen. Kein Force-Publish.
Outstand-Webhook (in Outstand unter Settings → Webhooks): POST /api/webhooks/outstand — Env OUTSTAND_WEBHOOK_SECRET für die Signaturprüfung (HMAC x-outstand-signature). In Production Pflicht: ohne Secret lehnt das Cockpit Webhooks mit 401 ab. Einrichtung und Zernio-Gegenstück: Social-Vendor-Webhooks.
| Event (Outstand) | Cockpit-Reaktion |
|---|---|
post.published, post.error | Entwurf live/Fehler, Kanal-Badges, Erster Kommentar |
account.token_expired | Dashboard-Glocke „Social-Kanal erneut verbinden“ |
comment.received (Instagram, Facebook, Threads), reply.* | Glocke aus Webhook-Payload; Engage-Sync debounced (Cron bleibt Fallback). Auch Instagram Live (Titel „Neuer Kommentar im Instagram Live“) und Kommentare auf Posts außerhalb von Outstand |
message.received, message.failed, conversation.started | Glocke „Neue Instagram-/Facebook-Nachricht“ bzw. „Nachricht nicht zugestellt“ → Social → Community → Instagram-Nachrichten (60 Sekunden entprellt pro Gespräch) |
message.received, conversation.started | Noch nicht — DMs laufen über Polling (/api/social/instagram-dms) |
import.completed, import.failed | Noch nicht — optional für Migrations-Monitoring |
Empfohlen in Outstand aktivieren: mindestens post.published, post.error, account.token_expired; für schnellere Kommentar-Glocken zusätzlich comment.received.
Metrik-Sync: manuell in Reporting oder Cron POST /api/cron/outstand-sync (CRON_SECRET, empfohlen täglich).
Hinweis: Caption-Änderungen im Workflow speichern die vorhandenen Medien im Entwurf (kein versehentliches Entfernen beim PATCH ohne containers).
Pre-Flight-Qualitätsprüfung (vor Planung / Veröffentlichung)
Vor dem Planen oder Veröffentlichen kann der Entwurf gegen Cockpit-Regeln geprüft werden (Hub C14 — analog AgencyOS, aber serverseitig beim Publish):
- Im Social-Editor (gespeicherter Entwurf): Button Qualitätsprüfung in der Vorschau-Spalte
- Fehler (rot) blockieren Veröffentlichung; Hinweise (gelb) sind Empfehlungen
- Typische Regeln: Kanäle verknüpft, Text vorhanden/Länge, Reel mit Video, Termin nicht in der Vergangenheit (Ausnahme: Termin war heute und liegt bereits zurück — bei Freigabe wird sofort veröffentlicht, kein Blocker), Instagram ohne Hashtags (Hinweis), Medien-URLs erreichbar (404 → „Bild neu hochladen“), Kanäle passen zum gewählten Center (z. B. „Instagram @handle ist nicht mit dem gewählten Center verknüpft.“ — blockiert Freigabe und Publish)
Kanäle in der Freigabe: Im Freigabe-Board und in den Post-Details siehst du die Zielprofile mit @Handle (nicht nur „Instagram · Facebook“), damit vor der Freigabe erkennbar ist, welches Profil veröffentlicht.
Center-Wechsel im Editor: Wird die Center-Auswahl geändert, entfernt das Cockpit automatisch Kanäle, die nicht mehr zu den gewählten Centern gehören.
Veröffentlichungsfehler (auch ältere Posts)
| Gilt retroaktiv? | Erklärung | |
|---|---|---|
| Preflight / Medien-Check | Ja, beim Retry | Beim erneuten Veröffentlichen (Freigabe-Board oder Editor) läuft die Qualitätsprüfung immer — auch für Posts, die früher still fehlgeschlagen sind. Defekte Outstand-/CDN-Links werden mit 404-Hinweis geblockt; automatisches Re-Upload gibt es nicht. |
| Glocke / E-Mail bei Publish-Fehler | Nein | Benachrichtigungen gehen nur zum Zeitpunkt des Fehlers raus. Bereits fehlgeschlagene Entwürfe erhalten keine erneute Glocke — sie erscheinen im Freigabe-Board unter Veröffentlichungsfehler (Badge-Zähler inklusive). |
| Sichtbarkeit im Board | Ja | Entwürfe mit status: failed oder publishError (auch bei Status Veröffentlicht / Geplant) landen im Tab Fehlgeschlagen mit Erneut veröffentlichen; Badge Teilweise live bei Kanal-Teilfehlern. |
So testen (Retry): 1) Freigaben → Tab Veröffentlichungsfehler öffnen. 2) Post im Editor → Qualitätsprüfung (Medien-URL). 3) Bei 404 Bild neu hochladen. 4) Erneut veröffentlichen (Freigeber) oder erneut freigeben.
API (Dashboard-Session): GET /api/social/drafts/{draftId}/quality-check?forSchedule=1
Antwort: { passed, issues: [{ level, code, message }] }
AgencyOS: GET /api/agencyos/v1/social/drafts/{draftId}/quality-check (Bearer API-Key)
MCP: cockpit_social_draft_quality_check (optional forSchedule=true) — vor cockpit_social_review oder Publish aufrufen.
Freigabe-Link (ohne Login)
Für Center Manager / Marketing, die kein Cockpit-Konto haben:
Empfohlen: Kontakt unter Center → Team & Ansprechpartner mit Haken Social-Freigabe anlegen — beim Einreichen wird der Link automatisch per E-Mail verschickt.
Manuell:
- Social Cockpit → Freigaben (
/dashboard/social/approvals) → Post in Prüfung → Button Freigabe-Link (neben Editor) - Link wird erzeugt (oder ein noch gültiger Link erneut kopiert) — Format:
/freigabe/social/[token]. Erneutes Kopieren ersetzt keinen bereits verschickten Link. - Empfänger öffnet die gebrandete Vorschauseite (Center-Logo, Farben, Bild links und Text rechts — bei unterschiedlichen Kanal-Texten getrennt nach Facebook/Instagram). Bilder und Videos lassen sich per Klick vergrößern (wie im Freigabe-Board). Anschließend freigeben oder ablehnen
- Link ist 90 Tage gültig; bei erneutem Einreichen zur Freigabe bleibt ein noch gültiger Link in alten E-Mails aktiv
- Nach Freigabe oder Ablehnung bleibt der Link zur Ansicht gültig (kein erneutes Freigeben) — die Seite zeigt den Status klar an; bei Ablauf in Freigaben einen neuen Link erzeugen
Website-Inhalte (News, Shops, Events): Gleiches Muster — Kontakt mit Website-Freigabe im Team-Tab; Button Freigabe-Link im Workflow (/dashboard/workflow) verschickt E-Mail an hinterlegte externe Freigeber. Öffentliche Seite: /freigabe/content/[token].
5. Rückmeldung an die Redaktion: Einreicher, Ersteller und zugewiesene interne Prüfer erhalten eine Benachrichtigung in der Glocke (Header). E-Mail: Bei Gast-Freigabe (externer Link) immer sofort — auch bei aktivem Digest. Bei interner Freigabe: Ablehnung und Publish-Fehler sofort; erfolgreiche Freigabe nur in der Zusammenfassung, wenn der tägliche Redaktions-Digest aktiv ist. Technik: Developer: Dashboard-E-Mails. Nach externer Ablehnung: In der Ablehnungs-E-Mail und im Post-Editor erscheint Gast-Freigabe-Ansicht öffnen — dieselbe Seite wie für den externen Freigeber (/freigabe/social/…), solange der Link gültig ist.
Hinweis: Kundenkontakt ist kein Freigabe-Link — dort generiert die KI nur einen E-Mail-Textvorschlag für Mieter/Kunden.
Technisch:
POST /api/social/drafts/[draftId]/review-link— Link erzeugen (Session)GET/POST /api/social/review/[token]— Vorschau / Freigabe / Ablehnung (öffentlich, tokenbasiert)GET/PUT /api/notifications— Cockpit-Glocke (persistente Benachrichtigungen pro Nutzer)
Benachrichtigungen (Glocke)
Die Glocke in der oberen Leiste zeigt ungelesene Workflow-Hinweise (z. B. Social-Freigabe über externen Link). Vollständige Liste: Benachrichtigungen (/dashboard/notifications). Technisch: Tabelle dashboard_notifications — Migration 20260521180000_add_dashboard_notifications_SAFE.sql.
CM → Redaktion: Wenn der Center Manager im CM-Cockpit reagiert (z. B. Kommentar oder Rückmeldung zu einem Social-Post), erhalten Social-Freigabe-Pool, KAM und Redaktion mit Center-Zuweisung am betroffenen Center eine Glocke — nicht alle Plattform-Admins ohne Bezug zum Center.
Klick auf eine Meldung öffnet den passenden Ort (FB-28QG00TG):
| Meldung | Ziel |
|---|---|
| Social-Post zur Freigabe | Freigabe-Board, Post markiert und aufgeklappt (/dashboard/social/approvals?highlight=…) |
| Social-Post freigegeben / abgelehnt / Veröffentlichung fehlgeschlagen | Der Post selbst (/dashboard/social/{id}) |
| Neue Kommentare | Community mit Filter „Mit Kommentaren“ |
| Social-Kanal erneut verbinden | Kanäle-Einstellungen |
Fehlt bei älteren Einträgen der gespeicherte Link, leitet das Cockpit ihn aus Typ und Post-ID ab (relatedId oder metadata.draftId / entityId). Ohne Zugang zum Post erscheint eine normale 404- bzw. Leerseite — keine fremden Inhalte.
Bei Freigabe anfordern erhalten gewählte Prüfer zusätzlich:
| Kanal | Wann |
|---|---|
| Cockpit-Glocke + optional Desktop-Push | Immer (Glocke); Browser-Popup nach Opt-in unter Meine Benachrichtigungen — Freigabe-Anfragen mit hoher Priorität (bleiben sichtbar, bis geschlossen) |
| Sofort bei Freigabe-Anfrage (auch wenn Digest aktiv); Ablehnung/Publish-Fehler ebenfalls sofort | |
| Microsoft Teams (AgencyOS-Bot) | Nur wenn AGENCYOS_TEAMS_NOTIFY_URL und AGENCYOS_TEAMS_NOTIFY_SECRET gesetzt sind; Freigeber muss den Bot in Teams mindestens einmal geöffnet haben |
Details und API-Vertrag: AgencyOS-Integration → Teams-Benachrichtigungen.
Verlauf (Timeline)
Unter Social-Freigaben (Karte aufklappen) und im Social-Editor (Seitenleiste) erscheint der Verlauf pro Post: Erstellung, Freigabe-Link, Einreichung, Bearbeitung (wer Text/Medien geändert hat), Freigabe/Ablehnung, Veröffentlichung, Kommentare (review_comment). Bei geplanten oder live Posts erscheint stattdessen „Planung aktualisiert“ bzw. „Live-Post aktualisiert“. Technisch: Tabelle social_post_draft_events — Migration 20260521190000_add_social_draft_events_SAFE.sql, APIs GET /api/social/drafts/[draftId]/events und POST /api/social/drafts/[draftId]/comments.
Im Dashboard (für Redaktion):
- Empfohlen: Shopping Center öffnen → Center wählen → Reiter Social Media
(/dashboard/content/centers/[centerId]?tab=social) — Kanal verbinden (Instagram, Facebook, Threads, LinkedIn, TikTok, Bluesky, X) oder vorhandenes Profil zuordnen. Kein Ticket an die Technik. - Alternativ: Sidebar Social Cockpit → Kanäle verknüpfen führt mit gewähltem Center auf denselben Reiter. Die Einstellungsseite bleibt für Super-Admin-Migration.
Pro Center Profile (Facebook, Instagram, …) zuordnen. Beim Anlegen von Social-Entwürfen werden verknüpfte Profile vorausgewählt.
Bildvorlagen (Canva-Rahmen)
| Was | Pro Center 0–n Bildvorlagen (PNG/WebP, oft Rahmen mit Freifläche) plus optionaler Canva-Link. Im Editor wählt die Redaktion die Vorlage; das fertige Beitragsbild lädt sie wie bisher hoch. |
| Warum | Viele Center arbeiten mit festen Vorlagen. Manche brauchen gar keine — deshalb ist nichts Pflicht, bis das Center den Schalter setzt. |
| Wer | Center-Betrieb (Vorlagen pflegen), Redaktion (auswählen). |
| Wo | Social-Kanäle (/dashboard/settings/social-accounts oder Center → Reiter Social Media) unten Bildvorlagen. Editor: Block unter den Medien. |
| So testen | 1) Center ohne Vorlagen: Editor zeigt keinen Block. 2) Eine Vorlage anlegen, Post öffnen, Vorlage wählen, fertiges Bild hochladen. 3) Schalter Vorlage beim Posten Pflicht an: Freigabe ohne Auswahl blockiert. 4) Zweites Center: dessen Vorlagen erscheinen nicht im ersten. |
Bewusst nicht: Canva-Login, Live-Bearbeitung in Canva oder automatisches Einfügen des Fotos in die Lücke. Der Canva-Link öffnet nur die Vorlage in einem neuen Tab.
Gewählte Vorlage liegt im Entwurf unter containers[0].options.socialTemplateId (kein neues Pflichtfeld in der Draft-Tabelle).
Technisch: Tabelle social_media_templates, Schalter ShoppingCenter.socialTemplateRequired (Default aus). APIs: GET/POST/PATCH /api/centers/{centerId}/social-templates, AgencyOS analog, MCP cockpit_social_templates. Migration 20260907180000_add_social_media_templates_SAFE.sql.
Technisch: Tabelle center_social_accounts, APIs:
GET/PUT/DELETE /api/social/center-accountsGET /api/social/outstand-accounts— verbundene KontenGET /api/social/outstand-accounts/connect— Anmeldung starten (centerId,network)GET /api/social/outstand-accounts/callback— Rückkehr nach Meta-Login, ordnet das Profil dem Center zu
Die OAuth-Callback-URL wird aus dem öffentlichen Dashboard-Host des laufenden Requests gebaut. Nach Meta/Outstand-Login leitet /api/social/outstand-accounts/callback zurück auf dieselbe öffentliche Domain (nicht localhost).
In Production darf NEXTAUTH_URL nicht http://localhost:3000 sein — sonst schlagen Connect-Start und Rückleitung fehl. Render: https://dashboard.cockpit-os.de (bzw. Org-Host).
Ohne Mapping werden beim Anlegen keine Accounts vorausgewählt.
Env
OUTSTAND_API_KEY— org-weit (Render Dashboard-Service)NEXTAUTH_URL— öffentliche Dashboard-URL (z. B.https://dashboard.cockpit-os.de); nichtlocalhostin Production — sonst schlägt „Kanal verbinden“ nach Meta-Login fehlOUTSTAND_ORG_ID— optional; braucht es nur, wenn noch kein Social-Profil in der Organisation hängt und der Quick „Kanal verbinden“ die öffentliche Anmelde-URL bauen mussOUTSTAND_WEBHOOK_SECRET— HMAC für/api/webhooks/outstand; in Production Pflicht (fail-closed)ZERNIO_WEBHOOK_SECRET— HMAC für/api/webhooks/zernio(Boost-Review, Ads-Sync-Hinweise); in Production Pflicht, sobald der Zernio-Webhook angelegt istCRON_SECRET— für/api/cron/outstand-sync(täglicher Metrik-Sync; GitHub Action Outstand Metrics Sync, 5:00 UTC)FAL_API_KEY— Bild-Assistent im Post-Editor (Qualitätsstufen Schnell/Schön/Wow)- OpenAI (oder konfigurierter Provider) — Caption-KI über bestehende AI-Einstellungen
AGENCYOS_TEAMS_NOTIFY_URL— optional; vollständige AgencyOS-URL für Social-Review → Teams (z. B.https://team.cockpit-os.de/api/integrations/notifications/social-review)AGENCYOS_TEAMS_NOTIFY_SECRET— optional; gemeinsames Bearer-Secret mit AgencyOS (nur Server)
Migration
Additive Tabellen: 20260521160000_add_social_outstand_SAFE.sql
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /dashboard/social-media-freigabe