Social unter einem Cockpit-Dach

Redaktion und Center-Betrieb sollen eine Oberfläche nutzen — Posting, Freigabe, Community und Werbe-KPIs — ohne zwischen Fanpage Karma, Outstand und Zernio wechseln zu müssen.

Was

Bereich	Cockpit-Menü	Technik dahinter (unsichtbar für Redaktion)
Post erstellen, planen, freigeben	Social → Neuer Post / Freigaben	Outstand
Kommentare lesen & antworten	Social → Community & Antworten	Outstand + Zernio Inbox; alle Kanal-Posts (nicht nur Cockpit)
Kommentar liken / verbergen	Dieselbe Engage-Ansicht (wenn aktiv)	Zernio Inbox
Werbe-KPIs im Kunden-Reporting	Analytics → Datenquellen	Zernio Ads

Fanpage Karma ist auf dem Hauptpfad ersetzt (Post → Freigabe → Live). Offene Lücke: einheitliche Engage-Tiefe und vollständiges Zernio-Mapping aller Kanäle.

Warum

• Eine Sprache nach außen: Keine Vendor-Namen in der UI.
• Best-of-breed: Outstand für Publishing/Freigabe (stabil im Cockpit), Zernio wo es stärker ist (Ads, Inbox-Moderation).
• Skalierung: Viele Center, teils gemeinsame Werbekonten (Portfolio-Filter), organische Kanäle pro Center.

Wer ist betroffen

Rolle	Auswirkung
Redaktion	Social Cockpit wie gewohnt; Liken/Verbergen erscheint nur wenn Kanal verknüpft
Center-Betrieb	Kunden-Reporting mit Zernio-Ads nach Auto-Link
Dev / Betrieb	Env OUTSTAND_API_KEY, ZERNIO_API_KEY; Migration + Auto-Link nach Deploy

Wo

• Posting & Freigabe: Dashboard → Social → Neuer Post / Freigaben — siehe Social-Media-Freigabe
• Community: Dashboard → Social → Community & Antworten (/dashboard/social/engage)
• Werbung: Analytics → Kunden-Reporting → Datenquellen — siehe Client-Reporting
• Auto-Link (Super Admin): POST /api/integrations/zernio/auto-link — Ads und organische Kanäle. Im Dashboard: Community & Antworten (gelber Hinweis → „Zernio verknüpfen“) oder Kunden-Reporting → Datenquellen (Abschnitt „Zernio-Verknüpfung“).

Provider-Matrix (Zielbild)

Capability	Provider	Voraussetzung
publish	Outstand	OUTSTAND_API_KEY, Center-Kanäle gemappt
readComments	Outstand + Zernio Inbox	wie oben; Inbox ergänzt bei zernioAccountId (Dedupe)
reply	Outstand oder Zernio Inbox	je nach commentSource des Kommentars
likeComment / hideComment	Zernio Inbox	ZERNIO_API_KEY + zernioAccountId auf center_social_accounts
Meta/Google Ads KPIs	Zernio	center_ads_accounts + optional campaignFilter

Die API liefert engageCapabilities an die Engage-Ansicht — Buttons nur wenn die Capability true ist.

Fanpage Karma — Ablösungs-Checkliste

Schritt	Status
Posts aus Cockpit (nicht Karma)	Erledigt
Freigabe-Workflow im Cockpit	Erledigt
Kommentare lesen / antworten	Erledigt (Outstand + Zernio Inbox)
Kanal-Inbox (Posts ohne Cockpit, Badge „Kanal“)	Erledigt
Kommentar liken / verbergen	Pilot (Zernio, nach Kanal-Mapping)
Werbe-Reporting	Erledigt (Zernio + Auto-Link)
Karma-Zugang nur noch Lesen / Übergang	Center-spezifisch

So testen

1. Migration (Production einmalig):

   psql "$DATABASE_URL" -f packages/database/migrations/20260708160000_add_center_social_zernio_account_SAFE.sql

2. Auto-Link (Ads + Social) — Super-Admin im Dashboard:
   • Community & Antworten: gelber Hinweis → Zernio verknüpfen (nur aktuelles Center)
   • Kunden-Reporting → Datenquellen: Abschnitt Zernio-Verknüpfung (Center oder alle Center; optional Test = Dry-Run)
   • Alternativ API/Script:

   cd apps/dashboard && pnpm exec tsx scripts/auto-link-zernio-ads.ts --dry-run
   cd apps/dashboard && pnpm exec tsx scripts/auto-link-zernio-ads.ts

3. Center wählen → Community & Antworten → Post mit Kommentar öffnen.
4. Nur Outstand-Posts sichtbar? Gelbes Banner in Community & Antworten → Zernio verknüpfen (Super-Admin). Oder Kunden-Reporting → Datenquellen → Zernio-Verknüpfung. Native Posts (Karma/Facebook direkt) kommen über Zernio Inbox (zernioAccountId auf center_social_accounts).
5. Wenn zernioEngageChannels > 0: Liken/Verbergen testen (Facebook/Instagram).
6. Kunden-Reporting: Zeitraum wählen, Meta/Google-KPIs prüfen.

Facebook (#10) pages_read_user_content

Wenn im Kurz-Hinweis eine Meta-Fehlermeldung zu pages_read_user_content erscheint:

1. In Zernio prüfen, ob die richtige Fanpage verknüpft ist (nicht ein Test-Kanal wie „SMG Kanäle Test“).
2. In der Meta-App (Zernio-Integration) die Berechtigung pages_read_user_content bzw. Page Public Content Access beantragen/freischalten.
3. Nach Freigabe in Zernio erneut verbinden und Zernio verknüpfen im Cockpit ausführen.

Outstand-Posts und bereits synchronisierte Zernio-Posts können trotzdem sichtbar bleiben — nur Live-Sync/Lesen externer Inhalte scheitert bis die Berechtigung da ist.

Betrieb

Env	Zweck
OUTSTAND_API_KEY	Posting, Freigabe, Kommentar-Antworten
ZERNIO_API_KEY	Ads-Tree, Inbox (Like/Hide), Auto-Link

Nach Schema-Änderung: Migration ausführen, Dashboard neu deployen, Auto-Link erneut laufen lassen.

Siehe auch

• Social-Media-Freigabe
• Client-Reporting / Zernio
• Developer: apps/dashboard/src/lib/integration/social-provider.ts