Canva-Import im Social Cockpit
| Was | Canva Connect: fertige Designs per API exportieren, auf BunnyCDN kopieren und an Social-Drafts hängen — ohne manuellen Download. |
| Warum | Redaktion arbeitet in Canva weiter; Planung, Caption und Publishing bleiben im Cockpit (Source of Truth). |
| Wer | SMG-Redaktionsrollen (CONTENT_EDITOR, ORG_MARKETING_MANAGER, …); OAuth verbinden nur Admin |
| Wo | Social → Post bearbeiten → Aus Canva importieren; Admin: API-Einstellungen → Canva verbinden |
| So testen | 1) 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)
- Canva Teams mit Integrations-Account (z. B.
social@…), 2FA aktiv - Team-Ordner Social anlegen und mit Redaktion teilen (Bearbeiten)
- Canva Developer Portal: App cockpitOS, Redirect
https://dashboard.cockpit-os.de/api/integrations/canva/callback - Scopes:
design:meta:read,design:content:read,folder:read,profile:read - Render Env:
CANVA_CLIENT_ID,CANVA_CLIENT_SECRET,CANVA_TOKEN_KEY(32-Byte-Hex für AES-GCM) - Dashboard → API-Einstellungen → Canva verbinden (Super-Admin)
- Optional: Ordner wählen → Team-Ordner „Social“ als Standard-Picker
- Pilot: Draft speichern → Aus Canva importieren → Medien und Post-Typ prüfen
Betrieb (Render)
| Env | Zweck |
|---|---|
CANVA_CLIENT_ID | Canva Developer Portal |
CANVA_CLIENT_SECRET | Canva Developer Portal |
CANVA_TOKEN_KEY | AES-256-GCM für Refresh/Access-Tokens |
| Redirect | https://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: /en/dashboard/social-canva-import