Zum Hauptinhalt springen

Canva-Import im Social Cockpit

WasCanva Connect: fertige Designs per API exportieren, auf BunnyCDN kopieren und an Social-Drafts hängen — ohne manuellen Download.
WarumRedaktion arbeitet in Canva weiter; Planung, Caption und Publishing bleiben im Cockpit (Source of Truth).
WerSMG-Redaktionsrollen (CONTENT_EDITOR, ORG_MARKETING_MANAGER, …); OAuth verbinden nur Admin
WoSocial → Post bearbeiten → Aus Canva importieren; Admin: API-Einstellungen → Canva verbinden
So testen1) Admin: Canva OAuth verbinden. 2) Draft speichern. 3) Import-Dialog → Design wählen. 4) Medien am Draft prüfen.

Abgrenzung Bildvorlagen​

Canva-Rahmen / Bildvorlagen = PNG-Vorlage + Link zum manuellen Gestalten. Canva-Import = automatischer Export fertiger Designs.

MVP-Scope​

Enthalten: Plattform-OAuth, Picker mit Titelsuche, Link-Auflösung, PNG/JPG/Carousel/MP4, Seitenauswahl, BunnyCDN, Job-Polling, Banner „In Canva geändert“ + Neu laden, OAuth-Fehler-Status für Admins, MCP + Robi-Hints.

Später: Verbindung pro Redakteurin (Canva-Review).

Canva-Setup (Phase 0, vor Go-Live)​

  1. Canva Teams mit Integrations-Account (z. B. social@…), 2FA aktiv
  2. Team-Ordner Social anlegen und mit Redaktion teilen (Bearbeiten)
  3. Canva Developer Portal: App cockpitOS, Redirect https://dashboard.cockpit-os.de/api/integrations/canva/callback
  4. Scopes: design:meta:read, design:content:read, folder:read, profile:read
  5. Render Env: CANVA_CLIENT_ID, CANVA_CLIENT_SECRET, CANVA_TOKEN_KEY (32-Byte-Hex für AES-GCM)
  6. Dashboard → API-Einstellungen → Canva verbinden (Super-Admin)
  7. Optional: Ordner wählen → Team-Ordner „Social“ als Standard-Picker
  8. Pilot: Draft speichern → Aus Canva importieren → Medien und Post-Typ prüfen

Betrieb (Render)​

EnvZweck
CANVA_CLIENT_IDCanva Developer Portal
CANVA_CLIENT_SECRETCanva Developer Portal
CANVA_TOKEN_KEYAES-256-GCM für Refresh/Access-Tokens
Redirecthttps://dashboard.cockpit-os.de/api/integrations/canva/callback

Migrationen (idempotent):

POST /api/admin/migrate-org-brand-dna-template # falls noch offen
POST /api/admin/migrate-canva-connect
Authorization: Bearer $CRON_SECRET

Details: Canva Connect (Developer)

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /dashboard/social-canva-import